Source code
Revision control
Copy as Markdown
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
invert_colors:
bug_numbers:
- 1794626
description: >
Boolean tracking if the user has an invert colors OS
setting enabled.
expires: never
kind: boolean
notification_emails:
- accessibility@mozilla.com
- mreschenberg@mozilla.com
products:
- 'firefox'
record_in_processes:
- 'main'
release_channel_collection: opt-out
keyed: false
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:
- fx-search-telemetry@mozilla.com
- rev-data@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-telemetry@mozilla.com
- rev-data@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
urlbar_persisted:
bug_numbers:
- 1779471
description: >
The count of URI loads triggered in a subsession from the urlbar after the
search term was shown in the urlbar, broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- fx-search-telemetry@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:
- fx-search-telemetry@mozilla.com
- rev-data@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:
- fx-search-telemetry@mozilla.com
- rev-data@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:
- fx-search-telemetry@mozilla.com
- rev-data@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:
- fx-search-telemetry@mozilla.com
- rev-data@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:
- fx-search-telemetry@mozilla.com
- rev-data@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:
- fx-search-telemetry@mozilla.com
- rev-data@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
- 1754641
- 1781978
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: "112"
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
- 1754641
- 1781978
description: >
True if the about:home startup cache was written via the AsyncShutdown
blocker.
expires: "112"
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'
unified_extensions_area:
bug_numbers:
- 1800114
description: >
Records a count of interactions with items in the Unified Extensions area.
expires: never
kind: uint
keyed: true
notification_emails:
- dtownsend@mozilla.com
- mconley@mozilla.com
- wdurand@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_paneMoreFromMozilla:
bug_numbers:
- 1738187
description: >
Records the items interacted with in the More From Mozilla section of
preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- pdahiya@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'
textrecognition_error:
bug_numbers:
- 1783261
description: >
Recorded when text recognition in images fails for some unknown reason.
notification_emails:
- gtatum@mozilla.com
- nordzilla@mozilla.com
expires: never
kind: uint
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
cookie.banners:
normal_window_service_mode:
bug_numbers:
- 1790781
- 1804259
description: >
The pref value of the cookie banner service mode for normal windows.
expires: never
kind: boolean
keyed: true
notification_emails:
- tihuang@mozilla.com
- pbz@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
private_window_service_mode:
bug_numbers:
- 1790781
- 1804259
description: >
The pref value of the cookie banner service mode for private windows.
expires: never
kind: boolean
keyed: true
notification_emails:
- tihuang@mozilla.com
- pbz@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
service_detect_only:
bug_numbers:
- 1809700
description: >
Tracks the value of the cookiebanners.service.detectOnly pref.
expires: never
kind: boolean
notification_emails:
- tihuang@mozilla.com
- pbz@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
rule_lookup_by_load:
bug_numbers:
- 1797073
- 1804259
description: >
Counts the number of hit/miss of cookie banner rule lookups for every
load. We collect three types of counters, including counters for overall
rule lookup, counters for cookie rule lookup and counters for click rule
lookup. We also divide the counter by top-level loads and iframe loads.
expires: '115'
kind: uint
keyed: true
notification_emails:
- tihuang@mozilla.com
- pbz@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
rule_lookup_by_domain:
bug_numbers:
- 1797073
- 1804259
description: >
Counts the number of hit/miss of cookie banner rule lookups for domain.
We collect three types of counters, including counters for overall
rule lookup, counters for cookie rule lookup and counters for click rule
lookup. We also divide the counter by top-level loads and iframe loads.
For each domain, we will only collect once.
expires: '115'
kind: uint
keyed: true
notification_emails:
- tihuang@mozilla.com
- pbz@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
cookie.banners.click:
result:
bug_numbers:
- 1797078
- 1804259
description: >
Given a matching cookie banner click rule, how often do we handle or fail
to handle cookie banners, labelled by reason. The 'success' and 'fail'
counters count the total numbers independently of the reason counters.
Counters are incremented after the content window has been destroyed.
expires: '115'
keyed: true
kind: uint
notification_emails:
- pbz@mozilla.com
- tihuang@mozilla.com
products:
- 'firefox'
record_in_processes:
- 'content'
release_channel_collection: opt-out
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
extensions.startupCache:
write_byteLength:
bug_numbers:
- 1767336
description: >
The amount of bytes writted into the Extensions StartupCache file.
expires: never
kind: uint
notification_emails:
- addons-dev-internal@mozilla.com
- lgreco@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
read_errors:
bug_numbers:
- 1767336
description: >
The amount of times an unexpected error has been raised while
reading the Extensions StartupCache file
expires: never
kind: uint
keyed: true
notification_emails:
- addons-dev-internal@mozilla.com
- lgreco@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
load_time:
bug_numbers:
- 1767336
description: >
Time to load and deserialize the extensions startupCache data.
This scalar is mirroring the never expiring Glean metric named
extensions.startup_cache_load_time, which is defined in
toolkit/components/extensions/metrics.yaml.
Unlike the related glean metric, this scalar has an expiring date,
set as a deadline to consider removing the mirrored scalar in
favor to just use the Glean metric).
expires: "118"
kind: uint
notification_emails:
- addons-dev-internal@mozilla.com
- lgreco@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
security:
webauthn_used:
bug_numbers:
- 1265472
- 1558870
- 1630155
- 1689269
- 1754650
- 1811156
description: >
Counts of how often Web Authentication was used in this session, keyed
by authenticator protocol, method and result. Currently: CTAPRegisterFinish,
CTAPRegisterAbort, CTAPSignFinish, CTAPSignAbort, U2FRegisterFinish,
U2FRegisterAbort, U2FSignFinish, U2FSignAbort.
expires: "118"
kind: uint
keyed: true
notification_emails:
- seceng-telemetry@mozilla.com
- jschanck@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'
client_auth_cert_usage:
bug_numbers:
- 1749884
description: >
Measures how many servers have requested a client authentication
certificate (key: "requested") and how many times the user has opted to
send one in response (key: "sent").
expires: never
kind: uint
keyed: true
notification_emails:
- dkeeler@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
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:
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
- 1744559
description: >
A count of how many "session" cookie exceptions a user has set.
expires: never
kind: uint
notification_emails:
- pbz@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
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
- 1754656
description: >
Records how Firefox was started on Windows.
Currently will be one of "Desktop", "DesktopPrivate",
"StartMenu" (including pins), "StartMenuPrivate",
"Taskbar", "TaskbarPrivate", "OtherShortcut", or "Other"
expires: never
kind: string
notification_emails:
- application-update-telemetry-alerts@mozilla.com
- rtestard@mozilla.com
- shong@mozilla.com
release_channel_collection: opt-out
products:
- firefox
record_in_processes:
- main
operating_systems:
- windows
launched_to_handle:
bug_numbers:
- 1243603
- 1781984
description: >
Records counts for when Firefox was launched afresh (i.e., was not already
running) to handle a file type or protocol with `-osint -url ...`. The
result is split into keys which represent the file extension: currently,
the set of file types Firefox registers to handle, namely ".avif", ".htm",
".html", ".pdf", ".shtml", ".xht", ".xhtml", ".svg", ".webp", and the set
of protocol schemes that Firefox registers to handle, namely "about",
"http", "https", "mailto". If Firefox was launched to handle a file type
or protocol it does not register to handle by default, the count is
recorded as ".<other extension>" or "<other protocol>", respectively
(neither of which are valid extension or protocol identifiers).
keyed: true
expires: never
kind: uint
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- firefox
record_in_processes:
- main
operating_systems:
- windows
invoked_to_handle:
bug_numbers:
- 1243603
- 1781984
description: >
Records counts for when Firefox was invoked (i.e., was already running and
was not launched) to handle a file type or protocol with `-osint -url
...`. The result is split into keys which represent the file extension:
currently, the set of file types Firefox registers to handle, namely
".avif", ".htm", ".html", ".pdf", ".shtml", ".xht", ".xhtml", ".svg",
".webp", and the set of protocol schemes that Firefox registers to handle,
namely "about", "http", "https", "mailto". If Firefox was invoked to
handle a file type or protocol it does not register to handle by default,
the count is recorded as ".<other extension>" or "<other protocol>",
respectively (neither of which are valid extension or protocol
identifiers).
keyed: true
expires: never
kind: uint
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- firefox
record_in_processes:
- main
operating_systems:
- windows
is_default_handler:
bug_numbers:
- 1743914
- 1781984
description: >
Records whether Firefox was the default handler for particular file types
or protocols. The result is split into keys which represent the file
extension: currently, a subset of the file types Firefox registers to
handle, namely ".pdf". In the future, more file types may be recorded,
and/or a subset of the protocol schemes that Firefox registers to may be
recorded.
keyed: true
expires: never
kind: boolean
notification_emails:
- application-update-telemetry-alerts@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: never
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 the non-Private Browsing version of this app was pinned to taskbar on startup
expires: never
kind: boolean
notification_emails:
- application-update-telemetry-alerts@mozilla.com
- shong@mozilla.com
release_channel_collection: opt-out
products:
- firefox
record_in_processes:
- main
operating_systems:
- windows
is_taskbar_pinned_private:
bug_numbers:
- 1751038
description: Whether the Private Browsing version of this app was pinned to taskbar on startup
expires: never
kind: boolean
notification_emails:
- application-update-telemetry-alerts@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
saw_toggle: