iceraven-browser/docs/telemetry.md

# Telemetry

Fenix uses Mozilla's telemetry service (Glean) to measure feature performance and engagement.

## Glean pings and metrics

By using the Glean SDK, Fenix can send the pings the SDK owns and defines, as documented [in the Glean SDK docs](https://mozilla.github.io/glean/book/user/pings/index.html).

Additional metrics or pings defined by Fenix are documented in the [Glean Dictionary](https://dictionary.telemetry.mozilla.org/apps/fenix).

## Crash reporting

See [here](https://github.com/mozilla-mobile/fenix/blob/master/docs/crash-reporting.md) for details on crash reporting in Firefox for Android.
[fenix] Closes https://github.com/mozilla-mobile/fenix/issues/263: Integrate service-glean component. 2019-01-31 16:27:36 +00:00			`# Telemetry`

[fenix] Issue https://github.com/mozilla-mobile/fenix/issues/19040: Remove Leanplum (Nightly) 2021-04-22 09:38:03 +00:00			`Fenix uses Mozilla's telemetry service (Glean) to measure feature performance and engagement.`
[fenix] Closes https://github.com/mozilla-mobile/fenix/issues/263: Integrate service-glean component. 2019-01-31 16:27:36 +00:00
[fenix] Remove the duplicated/outdated 'activation' ping docs (https://github.com/mozilla-mobile/fenix/pull/12421) This additionally overhauls the Fenix telemetry docs to point at the Glean autogenerated docs, to prevent documentation getting outdated again. 2020-07-21 01:55:41 +00:00			`## Glean pings and metrics`
[fenix] No issue - Stop generating `metrics.md` and direct to Glean Dictionary instead (https://github.com/mozilla-mobile/fenix/pull/19411) Now that the Glean Dictionary (https://dictionary.telemetry.mozilla.org) has hit production, our guidance is to move away from generating metrics.md files. The Glean Dictionary is a better solution for this task for a couple of reasons: 1. The Glean Dictionary contains a complete reference of all metrics and pings sent by an application (not just those defined in the application itself, as is the case with the markdown documentation) 2. The Glean Dictionary provides additional context and links beyond what is provided by the documentation (for example, information on how to access metric information via BigQuery or GLAM) as well as annotations provided by data scientists in the course of analyzing data (see, for example, the commentary section for: https://dictionary.telemetry.mozilla.org/apps/fenix/metrics/metrics_search_count). This should also reduce some of the churn/burden on people when they submit PRs, as there is no longer any need to update metrics.md as a part of them. 2021-05-08 00:52:01 +00:00
[fenix] Remove the duplicated/outdated 'activation' ping docs (https://github.com/mozilla-mobile/fenix/pull/12421) This additionally overhauls the Fenix telemetry docs to point at the Glean autogenerated docs, to prevent documentation getting outdated again. 2020-07-21 01:55:41 +00:00			`By using the Glean SDK, Fenix can send the pings the SDK owns and defines, as documented [in the Glean SDK docs](https://mozilla.github.io/glean/book/user/pings/index.html).`
[fenix] Closes https://github.com/mozilla-mobile/fenix/issues/263: Integrate service-glean component. 2019-01-31 16:27:36 +00:00
[fenix] No issue - Stop generating `metrics.md` and direct to Glean Dictionary instead (https://github.com/mozilla-mobile/fenix/pull/19411) Now that the Glean Dictionary (https://dictionary.telemetry.mozilla.org) has hit production, our guidance is to move away from generating metrics.md files. The Glean Dictionary is a better solution for this task for a couple of reasons: 1. The Glean Dictionary contains a complete reference of all metrics and pings sent by an application (not just those defined in the application itself, as is the case with the markdown documentation) 2. The Glean Dictionary provides additional context and links beyond what is provided by the documentation (for example, information on how to access metric information via BigQuery or GLAM) as well as annotations provided by data scientists in the course of analyzing data (see, for example, the commentary section for: https://dictionary.telemetry.mozilla.org/apps/fenix/metrics/metrics_search_count). This should also reduce some of the churn/burden on people when they submit PRs, as there is no longer any need to update metrics.md as a part of them. 2021-05-08 00:52:01 +00:00			`Additional metrics or pings defined by Fenix are documented in the [Glean Dictionary](https://dictionary.telemetry.mozilla.org/apps/fenix).`
[fenix] Generate the `activation` ping and send it with Glean (https://github.com/mozilla-mobile/fenix/pull/1707) This fetches the Google Advertising ID, salts it and then applies hashing before sending a ping with it, at startup. Hashing and salting are used in order to prevent ourselves to correlate advertising IDs from the same user running different products we own off a single device. We will never send the client_id and the Google Advertising ID in the same ping. 2019-05-03 14:40:22 +00:00
[fenix] For https://github.com/mozilla-mobile/fenix/issues/235 - Add crash-reporting.md, and port over Sentry docs. 2019-09-24 01:31:02 +00:00			`## Crash reporting`
[fenix] No issue - Stop generating `metrics.md` and direct to Glean Dictionary instead (https://github.com/mozilla-mobile/fenix/pull/19411) Now that the Glean Dictionary (https://dictionary.telemetry.mozilla.org) has hit production, our guidance is to move away from generating metrics.md files. The Glean Dictionary is a better solution for this task for a couple of reasons: 1. The Glean Dictionary contains a complete reference of all metrics and pings sent by an application (not just those defined in the application itself, as is the case with the markdown documentation) 2. The Glean Dictionary provides additional context and links beyond what is provided by the documentation (for example, information on how to access metric information via BigQuery or GLAM) as well as annotations provided by data scientists in the course of analyzing data (see, for example, the commentary section for: https://dictionary.telemetry.mozilla.org/apps/fenix/metrics/metrics_search_count). This should also reduce some of the churn/burden on people when they submit PRs, as there is no longer any need to update metrics.md as a part of them. 2021-05-08 00:52:01 +00:00
[fenix] Update telemetry doc to refer to depecate "preview" 2020-08-21 20:02:19 +00:00			`See [here](https://github.com/mozilla-mobile/fenix/blob/master/docs/crash-reporting.md) for details on crash reporting in Firefox for Android.`