Source code
Revision control
Other Tools
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# This file contains a definition of the scalar probes that are recorded in Telemetry.
# They are submitted with the "main" pings and can be inspected in about:telemetry.
# The following section contains the accessibility scalars.
a11y:
HCM_background:
bug_numbers:
- 1694717
description: >
Unsigned int tracking the user's prefered background color \
(logged when HCM is enabled).
expires: never
kind: uint
notification_emails:
- accessibility@mozilla.com
- mreschenberg@mozilla.com
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
release_channel_collection: opt-out
keyed: false
HCM_foreground:
bug_numbers:
- 1694717
description: >
Unsigned int tracking the user's prefered foreground color \
(logged when HCM is enabled).
expires: never
kind: uint
notification_emails:
- accessibility@mozilla.com
- mreschenberg@mozilla.com
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
release_channel_collection: opt-out
keyed: false
backplate:
bug_numbers:
- 1539212
description: >
Boolean tracking if the user has the backplate preference enabled or disabled.
expires: never
kind: boolean
notification_emails:
- accessibility@mozilla.com
- mreschenberg@mozilla.com
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
release_channel_collection: opt-out
keyed: false
instantiators:
bug_numbers:
- 1323069
- 1462238
description: >
The leaf name and version number of the binary for the process responsible
for remotely instantiating a11y.
expires: never
kind: string
notification_emails:
- accessibility@mozilla.com
- jteh@mozilla.com
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
release_channel_collection: opt-out
keyed: false
indicator_acted_on:
bug_numbers:
- 1412358
description: >
Recorded on click or SPACE/ENTER keypress event. Boolean stating if the
accessibility indicactor button was acted on.
expires: "62"
kind: boolean
notification_emails:
- accessibility@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
theme:
bug_numbers:
- 1022528
description: >
OS high contrast or other accessibility theme is enabled.
The result is split into keys which represent the values of
browser.display.document_color_use: "default", "always", or "never".
keyed: true
expires: never
kind: boolean
notification_emails:
- accessibility@mozilla.com
- eisaacson@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
# The following section contains the browser engagement scalars.
browser.engagement:
max_concurrent_tab_count:
bug_numbers:
- 1271304
description: >
The count of maximum number of tabs open during a subsession,
across all windows, including tabs in private windows and restored
at startup.
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
tab_open_event_count:
bug_numbers:
- 1271304
description: >
The count of tab open events per subsession, across all windows, after the
session has been restored. This includes tab open events from private windows
and from manual session restorations (i.e. after crashes and from about:home).
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
max_concurrent_window_count:
bug_numbers:
- 1271304
description: >
The count of maximum number of browser windows open during a subsession. This
includes private windows and the ones opened when starting the browser.
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
window_open_event_count:
bug_numbers:
- 1271304
description: >
The count of browser window open events per subsession, after the session
has been restored. The count includes private windows and the ones from manual
session restorations (i.e. after crashes and from about:home).
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
max_concurrent_tab_pinned_count:
bug_numbers:
- 1505535
description: >
The count of maximum number of pinned tabs open during a subsession. This
includes private windows and the ones opened when starting the browser.
Starting Firefox 85 this includes number of restored pinned tabs at
startup.
expires: never
kind: uint
notification_emails:
- bmiroglio@mozilla.com
- aoprea@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
tab_pinned_event_count:
bug_numbers:
- 1505535
description: >
The count of tab pinned events per subsession, across all windows, after the
session has been restored. This includes tab pinned events from private windows.
expires: never
kind: uint
notification_emails:
- bmiroglio@mozilla.com
- aoprea@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
tab_unload_count:
bug_numbers:
- 1715858
description: >
The count of tab unload events by TabUnloader due to a low-memory situation.
expires: never
kind: uint
notification_emails:
- tkikuchi@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
tab_reload_count:
bug_numbers:
- 1715858
description: >
The count of tab reload events by the user after unloaded.
expires: never
kind: uint
notification_emails:
- tkikuchi@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
total_uri_count:
bug_numbers:
- 1271313
- 1529232
description: >
The count of the total non-unique http(s) URIs visited in a subsession, including
page reloads, after the session has been restored. URIs on minimized or background
tabs may also be counted towards this. Private browsing is not included in this
count.
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
- loines@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
record_into_store:
- 'main'
- 'account-ecosystem'
total_uri_count_normal_and_private_mode:
bug_numbers:
- 1535169
description: >
The count of the total non-unique http(s) URIs visited in a subsession, including
page reloads, after the session has been restored. URIs on minimized or background
tabs may also be counted towards this. Private browsing is included in this count.
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
- loines@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
record_into_store:
- 'main'
- 'account-ecosystem'
unfiltered_uri_count:
bug_numbers:
- 1304647
description: >
The count of the total non-unique URIs visited in a subsession, not restricted to
a specific protocol, including page reloads and about:* pages (other than initial
pages such as about:blank, ...), after the session has been restored. This does
not include background page requests and URIs from embedded pages or private browsing.
expires: never
kind: uint
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
unique_domains_count:
bug_numbers:
- 1271310
description: >
The count of the unique domains visited in a subsession, after the session
has been restored. Subdomains under eTLD are aggregated after the first level
(i.e. test.example.com and other.example.com are only counted once).
This does not include background page requests and domains from embedded pages
or private browsing. The count is limited to 100 unique domains.
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
active_ticks:
bug_numbers:
- 1376942
- 1545172
description: >
The count of the number of five-second intervals ('ticks') the user
was considered 'active' in a subsession. Session activity involves keyboard or mouse
interaction with the application. It does not take into account whether or not the window
has focus or is in the foreground, only if it is receiving these interaction events.
expires: never
kind: uint
notification_emails:
- bcolloran@mozilla.com
- loines@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
- 'thunderbird'
record_in_processes:
- 'main'
record_into_store:
- 'main'
- 'account-ecosystem'
profile_count:
bug_numbers:
- 1647422
- 1356265
description: >
The count of the browser profiles on the current system. This counts profiles that have been
used across all OS user accounts on machine since this probe was added. The value persists
across installs. A value of 0 is reported if there is an error determining the correct count.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
operating_systems:
- windows
bookmarks_toolbar_bookmark_added:
bug_numbers:
- 1665391
description: >
The count of bookmarks added to the bookmarks toolbar. This counts bookmarks created on the
bookmarks toolbar and bookmarks moved to the bookmarks toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
- jaws@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
bookmarks_toolbar_bookmark_opened:
bug_numbers:
- 1665391
description: >
The count of bookmarks opened from the Bookmarks Toolbar. This counts bookmarks opened on the
toolbar and bookmarks opened from the 'symlinked' Other Bookmarks folder on the
Bookmarks Toolbar. It does not count Bookmarks Toolbar bookmarks opened via the Library,
Bookmarks Menu, or other UI since the goal is to measure interactions that pass through the toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
- jaws@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
sessionrestore_interstitial:
bug_numbers:
- 1671271
description: >
Whether we show about:sessionrestore or not. Split by key, which indicates
why we showed the item or not. Specifically, 'deferred_restore' means we
didn't autorestore and thus didn't show the interstitial; 'autorestore'
indicates we autorestored without showing the interstitial.
'shown_old_session', 'shown_only_about_welcomeback',
'shown_many_crashes', 'shown_many_crashes_old_session' all indicate we did
show the interstitial because of a crash, and the text after 'shown'
indicates what secondary reason there was to show this page (as we don't
show it for 'just' one crash).
expires: never
kind: uint
keyed: true
notification_emails:
- gijs@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
session_time_including_suspend:
bug_numbers:
- 1205985
description: >
The duration of the session in milliseconds, including the time the device
was suspended.
expires: never
kind: uint
notification_emails:
- padenot@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
session_time_excluding_suspend:
bug_numbers:
- 1205985
description: >
The duration of the session in milliseconds, excluding the time the device
was suspended.
expires: never
kind: uint
notification_emails:
- padenot@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
# The following section contains the browser engagement scalars.
browser.engagement.navigation:
urlbar:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from the urlbar (awesomebar),
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
urlbar_handoff:
bug_numbers:
- 1732429
description: >
The count URI loads triggered in a subsession from the urlbar via handoff,
broken down by the originating action.
expires: never
kind: uint
keyed: True
notification_emails:
- fx-search@mozilla.com
- rev-data@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
urlbar_searchmode:
bug_numbers:
- 1654680
description: >
The count URI loads triggered in a subsession from the urlbar's search
mode, broken down by the originating action.
expires: never
kind: uint
keyed: True
notification_emails:
- htwyford@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
searchbar:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from the searchbar,
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
about_home:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from about:home,
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
about_newtab:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from about:newtab,
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
contextmenu:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from the contextmenu,
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
webextension:
bug_numbers:
- 1492233
description: >
The count URI loads triggered in a subsession from a webextension.
expires: never
kind: uint
keyed: true
notification_emails:
- mkaply@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
browser.startup:
abouthome_cache_result:
bug_numbers:
- 1622263
- 1614351
- 1683101
- 1714258
- 1730042
description: >
How the about:home startup cache functioned on startup.
0: Result value was never set (error case)
1: Cache did not exist
2: Cache page stream was corrupt / inaccessible
3: Cache script stream was corrupt / inaccessible
4: Cache was invalidated by a version bump
5: Cache was valid, but read too late to be useful.
6: Cache was valid and used.
7: Cache is disabled.
8: User did not load about:home on its own by default.
9: Cache is disabled because about:newtab preloading is disabled.
expires: "100"
kind: uint
notification_emails:
- mconley@mozilla.com
- perf-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
abouthome_cache_shutdownwrite:
bug_numbers:
- 1622263
- 1614351
- 1683101
- 1714258
- 1730042
description: >
True if the about:home startup cache was written via the AsyncShutdown
blocker.
expires: "100"
kind: boolean
notification_emails:
- mconley@mozilla.com
- perf-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
# The following section contains the browser usage scalars.
browser.usage:
graphite:
bug_numbers:
- 1331915
description: >
The number of times a graphite2 font has been loaded.
expires: "65"
kind: uint
notification_emails:
- tom@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'all'
plugin_instantiated:
bug_numbers:
- 1381591
description: >-
The number of plugin instances that were created.
expires: never # Jan-2021 but we don't have a version number for that
kind: uint
notification_emails:
- bsmedberg@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
- 'content'
browser.ui:
toolbar_widgets:
bug_numbers:
- 1620358
description: >
The widgets in the toolbars.
expires: never
kind: boolean
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
customized_widgets:
bug_numbers:
- 1620358
description: >
Records when widgets are added, removed or moved in the UI.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
browser.ui.interaction:
keyboard:
bug_numbers:
- 1620358
description: >
Records a count of interactions with keyboard shortcuts.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
menu_bar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the menu bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
tabs_bar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the tab bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
nav_bar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the nav bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
bookmarks_bar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the bookmarks bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
app_menu:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the app menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
tabs_context:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the tab context menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
content_context:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the content context menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
overflow_menu:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the overflow menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
pinned_overflow_menu:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the pinned area of the
overflow menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
pageaction_urlbar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with page action items in the url bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
pageaction_panel:
bug_numbers:
- 1620358
description: >
Records a count of interactions with page action items in the panel.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneHome:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Home section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneGeneral:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the General section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_panePrivacy:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Privacy section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneSearch:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Search section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneSearchResults:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Search results section of
preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneSync:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Sync section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneContainers:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Containers section of
preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneExperimental:
bug_numbers:
- 1620358
- 1651986
description: >
Records the items interacted with in the Experimental section of
preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneUnknown:
bug_numbers:
- 1620358
- 1651986
description: >
Records the items interacted with in any other section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
gecko:
version:
bug_numbers:
- 1611240
description: >
The version of the Gecko engine, example: '74.0a1'.
It consists of the major and minor version, followed by the release life cycle phase.
'a' stands for alpha or nightly, 'b' stands for beta.
The number behind the release life cycle phase indicates minor releases within the phase.
expires: never
kind: string
notification_emails:
- gfx-telemetry-alerts@mozilla.com
- ktaeleman@mozilla.com
products:
- 'geckoview_streaming'
record_in_processes:
- 'main'
release_channel_collection: opt-out
build_id:
bug_numbers:
- 1611240
description: >
The build id of the Gecko engine, example: '20200205124310'.
It contains the time the build was created and is used as a unique id for the build.
expires: never
kind: string
notification_emails:
- gfx-telemetry-alerts@mozilla.com
- ktaeleman@mozilla.com
products:
- 'geckoview_streaming'
record_in_processes:
- 'main'
release_channel_collection: opt-out
extensions.updates:
rdf:
bug_numbers:
- 1460336
description: >
The number of RDF update requsts for a given extension ID.
expires: "66"
kind: uint
keyed: true
notification_emails:
- addons-dev-internal@mozilla.com
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
security:
webauthn_used:
bug_numbers:
- 1265472
- 1558870
- 1630155
- 1689269
description: >
Counts of how often Web Authentication was used in this session, keyed
by authenticator protocol, method and result. Currently: U2FRegisterFinish,
U2FRegisterAbort, U2FSignFinish, U2FSignAbort.
expires: "100"
kind: uint
keyed: true
notification_emails:
- seceng-telemetry@mozilla.com
- jjones@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
https_only_mode_enabled:
bug_numbers:
- 1620244
description: >
Measures user retention of the HTTPS-Only Mode.
0 = never enabled, 1 = enabled, 2 = disabled (but was enabled)
expires: never
kind: uint
notification_emails:
- julianwels@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
https_only_mode_enabled_pbm:
bug_numbers:
- 1647719
description: >
Measures user retention of the HTTPS-Only Mode in Private Browsing.
0 = https-only never enabled in PBM,
1 = https-only enabled in PBM,
2 = https-only disabled in PBM (but was enabled)
expires: never
kind: uint
notification_emails:
- julianwels@mozilla.com
- ckerschb@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
global_privacy_control_enabled:
bug_numbers:
- 1734185
description: >
Measures user retention of the Global Privacy Control.
0 = never enabled, 1 = enabled, 2 = disabled (but was enabled)
expires: never
kind: uint
notification_emails:
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
pwmgr:
potentially_breached_passwords:
bug_numbers:
- 1577808
description: >
The number of potentially breached passwords, as determined by
LoginBreaches.getPotentialBreachesByLoginGUID.
expires: never
kind: uint
notification_emails:
- seceng-telemetry@mozilla.com
- passwords-dev@mozilla.org
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
contentblocking:
cryptomining_blocking_enabled:
bug_numbers:
- 1522919
description: >
True if cryptominer blocking is enabled globally at startup.
expires: never
kind: boolean
notification_emails:
- aedelstein@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
fingerprinting_blocking_enabled:
bug_numbers:
- 1522919
description: >
True if fingerprinter blocking is enabled globally at startup.
expires: never
kind: boolean
notification_emails:
- aedelstein@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
category:
bug_numbers:
- 1529425
description: >
This scalar reports the value of the content blocking category pref (0 = "standard", 1 = "strict", 2 = "custom", 3 = some other value, this is not supported).
expires: never
kind: uint
notification_emails:
- aedelstein@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
trackers_blocked_count:
bug_numbers:
- 1577030
- 1610894
- 1645088
- 1678209
description: >
A count of the number of tracking events blocked.
expires: never
kind: uint
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
datasanitization:
network_cookie_lifetimePolicy:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
This scalar reports the value of the network.cookie.lifetimePolicy pref.
expires: never
kind: uint
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_sanitize_sanitizeOnShutdown:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.sanitize.sanitizeOnShutdown pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_cookies:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.cookies pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_history:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.history pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_formdata:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.formdata pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_downloads:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.downloads pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_cache:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.cache pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_sessions:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.sessions pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_offlineApps:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.offlineApps pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_siteSettings:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.siteSettings pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_openWindows:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.openWindows pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
session_permission_exceptions:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A count of how many "session" cookie exceptions a user has set.
expires: never
kind: uint
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
downloads:
panel_shown:
bug_numbers:
- 1627676
description: >
The count of how many times the downloads panel was shown per session.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
- emalysz@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
file_opened:
bug_numbers:
- 1627676
description: >
The count of how many times files were opened from the download panel.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
- emalysz@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
sandbox:
no_job:
bug_numbers:
- 1392570
description: >
Indicates that we can't use a job object for sandboxed child processes.
Keyed by whether we are in a remote session or not from ::GetSystemMetrics(SM_REMOTESESSION).
expires: "62"
kind: boolean
keyed: true
notification_emails:
- bowen@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
operating_systems:
- "windows"
findbar:
shown:
bug_numbers:
- 1627688
description: >
The count of how many times the "Find toolbar" was shown per session.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
find_prev:
bug_numbers:
- 1627688
description: >
The count of how many times the find previous button was used per session.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
find_next:
bug_numbers:
- 1627688
description: >
The count of how many times the find next button was used per session.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
highlight_all:
bug_numbers:
- 1627688
description: >
The count of how many times the "Highlight All" button was used in find toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
match_case:
bug_numbers:
- 1627688
description: >
The count of how many times the "Match Case" button was used in find toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
match_diacritics:
bug_numbers:
- 1627688
description: >
The count of how many times the "Match Diacritics" button was used in find toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
whole_words:
bug_numbers:
- 1627688
description: >
The count of how many times the "Whole Words" button was used in find toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
sidebar:
opened:
bug_numbers:
- 1648530
description: >
The number of times the sidebar was opened, per view (e.g.: bookmarks, history,
synced tabs).
expires: never
kind: uint
keyed: true
notification_emails:
- emalysz@mozilla.com
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
search:
bug_numbers:
- 1648524
description: >
The number of searches from the sidebar, per view (e.g.: bookmarks, history).
expires: never
kind: uint
keyed: true
notification_emails:
- emalysz@mozilla.com
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
os.environment:
is_admin_without_uac:
bug_numbers:
- 1567219
description: >
Indicates that the process is lauched with Admin privileges but without
UAC.
expires: never
kind: boolean
notification_emails:
- tkikuchi@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
operating_systems:
- "windows"
allowed_app_sources:
bug_numbers:
- 1659157
description: >
Indicates what sources the OS is currently configured to allow apps to be
installed from. Possible values are "Anywhere", "Recommendations",
"PreferStore", "StoreOnly", "NoSuchFeature", or "Error". "Recommendations"
allows installs from anywhere, but recommends a comparable app from the
store, if available. "NoSuchFeature" will be reported on versions of
Windows that do not have an app source setting.
expires: never
kind: string
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'thunderbird'
record_in_processes:
- main
operating_systems:
- "windows"
launch_method:
bug_numbers:
- 1685213
- 1725298
description: >
Records how Firefox was started on Windows.
Currently will be one of "Desktop", "StartMenu" (including pins),
"Taskbar", "OtherShortcut", or "Other"
expires: "100"
kind: string
notification_emails:
- application-update-telemetry-alerts@mozilla.com
- agashlin@mozilla.com
- shong@mozilla.com
release_channel_collection: opt-out
products:
- firefox
record_in_processes:
- main
operating_systems:
- windows
is_kept_in_dock:
bug_numbers:
- 1715348
description: Whether this app was kept in macOS Dock on startup
expires: "97"
kind: boolean
notification_emails:
- elee@mozilla.com
- shong@mozilla.com
release_channel_collection: opt-out
products:
- firefox
record_in_processes:
- main
operating_systems:
- mac
is_taskbar_pinned:
bug_numbers:
- 1685213
- 1725298
description: Whether this app was pinned to taskbar on startup
expires: "100"
kind: boolean
notification_emails:
- application-update-telemetry-alerts@mozilla.com
- agashlin@mozilla.com
- shong@mozilla.com
release_channel_collection: opt-out
products:
- firefox
record_in_processes:
- main
operating_systems:
- windows
pictureinpicture:
opened_method:
bug_numbers:
- 1560590
- 1616045
description: >
The number of times a Picture-in-Picture window was opened, per trigger
mechanism (e.g.: the video toggle, the context menu).
expires: "92"
kind: uint
keyed: true
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- content
closed_method:
bug_numbers:
- 1560590
- 1616045
description: >
The number of times a Picture-in-Picture window was closed, per trigger
mechanism (e.g.: the close button, the unpip button, originating tab going away,
process shutdown, etc).
expires: "92"
kind: uint
keyed: true
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
saw_toggle:
bug_numbers:
- 1657155
description: >
The number of times a Picture-in-Picture toggle was presented to the user when
they hovered the video with the mouse pointer.
expires: "92"
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- content
most_concurrent_players:
bug_numbers:
- 1677107
- 1706843
description:
The most concurrent Picture-in-Picture players the user had open at any one time.
expires: "96"
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
preferences:
created_new_user_prefs_file:
bug_numbers:
- 1367813
description: >-
A boolean indicating that profile/prefs.js was not found and it is being
created for the first time in this session.
expires: "62"
kind: boolean
notification_emails:
- bsmedberg@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
prefs_file_was_invalid:
bug_numbers:
- 1367813
- 1682571
description: >-
Set to true if a failure occurred reading profile/prefs.js.
expires: never
kind: boolean
notification_emails:
- kwright@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
read_user_js:
bug_numbers:
- 1367813
description: >-
Set to true if user.js exists and was read.
expires: "62"
kind: boolean
notification_emails:
- bsmedberg@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
search_query:
bug_numbers:
- 1359306
description: >-
Each key is a search query string when user performs a search action within
about:preferences, and each value is the number of times that key is recorded.
The telemetry data will be recorded if there is a successful search result highlighted.
expires: "62"
kind: uint
keyed: true
notification_emails:
- chsiang@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
browser_home_page_change:
bug_numbers:
- 1392951
description: >-
The number of times the home page has been changed.
Recorded when a user changes his/her home page successfully.
expires: "62"
kind: uint
keyed: true
notification_emails:
- chsiang@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
browser_home_page_count:
bug_numbers:
- 1392951
description: >-
Each key is the number of home page urls when users change their home page,
multiple home pages can be set (delineated with a "|"),
and each value is the number of times that key is recorded.
The telemetry data will be recorded if a user changes his/her home page successfully.
expires: "62"
kind: uint
keyed: true
notification_emails:
- chsiang@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
webrtc.video:
recv_codec_used:
bug_numbers:
- 1556766
description: >
The video codec used for receiving video on a WebRTC call.
expires: "never"
kind: uint
keyed: true
notification_emails:
- dminor@mozilla.com
- nohlmeier@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'content'
send_codec_used:
bug_numbers:
- 1556766
description: >
The video codec used for sending video on a WebRTC call.
expires: "never"
kind: uint
keyed: true
notification_emails:
- dminor@mozilla.com
- nohlmeier@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'content'
webrtc.sdp:
parser_diff:
bug_numbers:
- 1432955
- 1529787
- 1588571
description: >
The number of differences between the C based sipcc SDP parser and
the new rust based rsdparsa SDP parser keyed by predefined
names of attributes and values that do not match between
the sipcc parsing result and the rsdparsa parsing result or
between the rsdparsa parsing result and the original sdp.
This should help to improve the new rsdparsa to replace
the sipcc parser.
expires: "77"
kind: uint
keyed: true
notification_emails:
- nohlmeier@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'content'
mathml:
doc_count:
bug_numbers:
- 1362187
- 1538985
- 1590350
description: >
The number of documents that contained enabled MathML elements.
expires: never
kind: uint
notification_emails:
- emilio@mozilla.com
- fred.wang@free.fr
- dev-tech-layout@lists.mozilla.org
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'content'
mediarecorder:
recording_count:
bug_numbers:
- 1400757
- 1429765
- 1480589
- 1532391
description: >
The number of times a MediaRecorder has been started. Recorded when a MediaRecorder starts
expires: "72"
kind: uint
notification_emails:
- bvandyk@mozilla.com
- nohlmeier@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
- content
media:
element_in_page_count:
bug_numbers:
- 1476456
- 1499803
- 1570634
- 1652108
description: >
The number of times a document hierarchy contained at least one HTMLMediaElement. In addition, the telemetry probe 'MIXED_CONTENT_UNBLOCK_COUNTER' records the total number of loaded top level content documents, which can help us calculate the result of the percentage of documents using media.
expires: never
kind: uint
notification_emails:
- alwu@mozilla.com
- nohlmeier@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
control_platform_usage:
bug_numbers:
- 1680856
description: >
Counts the number of times users enable and use media control on different platforms. 0=EnabledOn, 1=UsedOn.
expires: "91"
kind: uint
keyed: true
notification_emails:
- alwu@mozilla.com
- nohlmeier@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
decode_error_per_mime_type:
bug_numbers:
- 1688775
description: >
Count the number of times the media with a specific mime type (Eg. audio/vorbis, that would be used as the key) encounters a decode error during playback.
expires: never
kind: uint
keyed: true
notification_emails:
- alwu@mozilla.com
- bvandyk@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'content'
wmf_process_usage:
bug_numbers:
- 1690372
- 1720616
description: >
Record whether the WMF decoder module is used in content or chrome process.
expires: "99"
kind: boolean
notification_emails:
- alwu@mozilla.com
- bvandyk@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
- 'content'
video_hardware_decoding_support:
bug_numbers:
- 1733722
description: >
Record whether hardware decoding is supported for the specific video codec. The key is the type of video codec, eg. video/vp9.
expires: "100"
kind: boolean
keyed: true
notification_emails:
- alwu@mozilla.com
- bvandyk@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
- 'content'
# The following section contains content process base counters.
dom.contentprocess:
buildID_mismatch:
bug_numbers:
- 1366808
description: >
The number of times the about:restartrequired page appeared due to a
buildID mismatch between the parent and the content processes.
expires: never
kind: uint
notification_emails:
- spohl@mozilla.com
release_channel_collection: opt-out
products: