usage-reporting

Minimal ping to measure the usage frequency of Firefox. Sent on the baseline schedule.

Metadata

Source	mozilla/gecko-dev/toolkit/components/telemetry/pings.yaml#L8
First Added	2024-11-22 16:20:10
Includes Client Identifier	No
Bugs	bugzil.la/1921440 bugzil.la/1929832
Data reviews	bugzil.la/1921440
Notification Emails	glean-team@mozilla.com jrediger@mozilla.com loines@mozilla.com
Reasons	- `active`: Defined to avoid error logging. Note: this ping will not actually send a ping reason. - `dirty_startup`: Defined to avoid error logging. Note: this ping will not actually send a ping reason. - `inactive`: Defined to avoid error logging. Note: this ping will not actually send a ping reason.

Commentary

No commentary for this ping, add some?

Server Knobs Configuration

Sampling Configuration Snippet

Click the button to copy a snippet for use in a Mozilla Experimenter configuration.

Access

BigQuery	firefox_desktop.usage_reporting
Data Catalog	firefox_desktop.usage-reporting 🔒
Looker	usage_reporting 🔒
STMO	Start a query in STMO 🔒 with the following SQL ➡

Metrics

Only show app metrics Show sampled metrics Show expired and removed metrics Paginate

Name	Type	Expiration	Description
browser.engagement.active_ticks Firefox :: General	`counter`	never	The number of five-second intervals ('ticks') the user was considered 'active'. 'active' means keyboard or mouse interaction with the application. It doesn't take into account whether or not the window has focus or is in the foreground, only if it is receiving these interaction events. Migrated from Telemetry's `browser.engagement.active_ticks`.
browser.engagement.uri_count Firefox :: General	`counter`	never	The number of total non-unique http(s) URIs visited, including page reloads, after the session has been restored. URIs on minimized or background tabs may also be counted. Private browsing uris are included. Migrated from Telemetry's `browser.engagement.total_uri_count_normal_and_private_mode`.
usage.app_build Toolkit :: Telemetry	`string`	never	The build identifier generated by the CI system (e.g. "1234/A"). If the value was not provided through configuration, this metric gets set to `Unknown`.
usage.app_channel Toolkit :: Telemetry	`string`	never	The channel the application is being distributed on.
usage.app_display_version Toolkit :: Telemetry	`string`	never	The user visible version string (e.g. "1.0.3"). If the value was not provided through configuration, this metric gets set to `Unknown`.
usage.distribution_id Toolkit :: Telemetry	`string`	never	The distribution id associated with the install of Firefox.
usage.first_run_date Toolkit :: Telemetry	`datetime`	never	The date of the profile's first use. Set from `ProfileAge.firstUse`
usage.is_default_browser Toolkit :: Telemetry	`boolean`	never	Whether Firefox is set as the default browser.
usage.os Toolkit :: Telemetry	`string`	never	The name of the operating system. Possible values: Android, iOS, Linux, Darwin, Windows, FreeBSD, NetBSD, OpenBSD, Solaris, Unknown
usage.os_version Toolkit :: Telemetry	`string`	never	The user-visible version of the operating system (e.g. "1.2.3"). If the version detection fails, this metric gets set to `Unknown`.
usage.profile_id Toolkit :: Telemetry	`uuid`	never	A UUID uniquely identifying the profile, not shared with other telemetry data.
usage.reason Toolkit :: Telemetry	`string`	never	The reason the usage-reporting ping was sent.
usage.windows_build_number Toolkit :: Telemetry	`quantity`	never	The optional Windows build number, reported by Windows (e.g. 22000) and not set for other platforms.
app_build glean-core 📦	`string`	never	The build identifier generated by the CI system (e.g. "1234/A"). If the value was not provided through configuration, this metric gets set to `Unknown`.
app_channel glean-core 📦	`string`	never	The channel the application is being distributed on.
app_display_version glean-core 📦	`string`	never	The user visible version string (e.g. "1.0.3"). If the value was not provided through configuration, this metric gets set to `Unknown`.
architecture glean-core 📦	`string`	never	The architecture of the device, (e.g. "arm", "x86").
build_date glean-core 📦	`datetime`	never	The date & time the application was built.
client_id glean-core 📦	`uuid`	never	A UUID uniquely identifying the client.
device_manufacturer glean-core 📦	`string`	never	The manufacturer of the device the application is running on. Not set if the device manufacturer can't be determined (e.g. on Desktop).

Page 1 of 2 (1 - 20 on 39 items)