re_analytics

Crates.iore_analytics
lib.rsre_analytics
version0.21.0-alpha.1
sourcesrc
created_at2023-02-12 16:08:35.701014
updated_at2024-12-11 14:48:41.361254
descriptionRerun's analytics SDK
homepagehttps://rerun.io
repositoryhttps://github.com/rerun-io/rerun
max_upload_size
id783283
size101,497
rerun.io (rerunio)

documentation

README

Rerun's analytics SDK

Part of the rerun family of crates.

Latest version Documentation MIT Apache

We use PostHog to collect anonymous usage statistics.

Usage data we do collect will be sent to and stored in servers within the EU.

You can audit the actual data being sent out by inspecting the Rerun data directory directly. Find out its location by running rerun analytics config.

Opting out

Run rerun analytics disable to opt out of all usage data collection.

What data is collected?

The exact set of analytics events and parameters can be found here: https://github.com/rerun-io/rerun/blob/main/crates/utils/re_analytics/src/event.rs

  • We collect high level events about the usage of the Rerun Viewer. For example:
    • The event 'Viewer Opened' helps us estimate how often Rerun is used.
    • The event 'Data Source Connected' helps us understand if users tend to use live data sources or recordings most, which helps us prioritize features.
  • We associate events with:
    • Metadata about the Rerun build (version, target platform, etc).
    • A persistent random id that is used to associate events from multiple sessions together. To regenerate it run rerun analytics clear.
  • We may associate these events with a hashed application_id and recording_id, so that we can understand if users are more likely to look at few applications often, or tend to use Rerun for many temporary scripts. Again, this helps us prioritize.
  • We may for instance add events that help us understand how well the auto-layout works.

What data is NOT collected?

  • No Personally Identifiable Information, such as user name or IP address, is collected.
    • This assumes you don't manually and explicitly associate your email with the analytics events using the analytics helper cli. (Don't do this, it's just meant for internal use for the Rerun team.)
  • No user data logged to Rerun is collected.
    • In some cases we collect secure hashes of user provided names (e.g. application_id), but take great care do this only when we have a clear understanding of why it's needed and it won't risk leaking anything potentially proprietary.

Why do we collect data?

  • To improve the Rerun open source library.
Commit count: 5021

cargo fmt