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:
use_system_colors:
bug_numbers:
- 1835194
description: >
Bool tracking if the user has system colors enabled in firefox.
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
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'
attribution.provenance:
data_exists:
bug_numbers:
- 1815023
- 1570652
description: >
Will be true if the "zoneIdProvenanceData" file is present in the
installation directory and we were able to successfully read it.
keyed: false
expires: "121"
kind: boolean
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- main
- new-profile
file_system:
bug_numbers:
- 1815023
- 1570652
description: >
The file system that the installer resided on at installation time.
Possible values are: "NTFS", "FAT32", "other".
In error cases, it can also be "missing", "error" or "readIniError".
Only sent if attribution.provenance.zone_id.data_exists is true.
keyed: false
expires: "121"
kind: string
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- main
- new-profile
ads_exists:
bug_numbers:
- 1815023
- 1570652
description: >
Will always be false if attribution.provenance.zone_id.data_exists is
false. Will be true if the provenance data indicates that the
:Zone.Identifier Alternate Data Stream existed on the installer.
keyed: false
expires: "121"
kind: boolean
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- main
- new-profile
security_zone:
bug_numbers:
- 1815023
- 1570652
description: >
The zone identifier in the installer's :Zone.Identifier ADS.
Possible values are integers between 0 and 4, inclusive.
In error cases, it can also be "unexpected", "missing", "error", or
"readIniError".
Only sent if attribution.provenance.zone_id.ads_exists is true.
keyed: false
expires: "121"
kind: string
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- main
- new-profile
referrer_url_exists:
bug_numbers:
- 1815023
- 1570652
description: >
Will be true if the zone identifier ADS contained a referrer URL. Will be
false if a referrer URL is specified, but it isn't a valid URL.
Only sent if attribution.provenance.zone_id.ads_exists is true.
keyed: false
expires: "121"
kind: boolean
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- main
- new-profile
referrer_url_is_mozilla:
bug_numbers:
- 1815023
- 1570652
description: >
Will be true if the referrer URL from the zone identifier ADS appeared to
be a Mozilla URL.
Only sent if attribution.provenance.zone_id.referrer_url_exists is true.
keyed: false
expires: "121"
kind: boolean
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- main
- new-profile
host_url_exists:
bug_numbers:
- 1815023
- 1570652
description: >
Will be true if the zone identifier ADS contained a host URL. Will be
false if a host URL is specified, but it isn't a valid URL.
Only sent if attribution.provenance.zone_id.ads_exists is true.
keyed: false
expires: "121"
kind: boolean
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- main
- new-profile
host_url_is_mozilla:
bug_numbers:
- 1815023
- 1570652
description: >
Will be true if the host URL from the zone identifier ADS appeared to be a
Mozilla URL.
Only sent if attribution.provenance.zone_id.host_url_exists is true.
keyed: false
expires: "121"
kind: boolean
notification_emails:
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- main
- new-profile
# 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
- 1811151
- 1841926
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: never
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
- 1811151
- 1841926
description: >
True if the about:home startup cache was written via the AsyncShutdown
blocker.
expires: never
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:
all_tabs_panel_dragstart_tab_event_count:
bug_numbers:
- 1804722
description: >
Records a count of how many times a drag event started for a tab within the All
Tabs panel.
expires: never
kind: uint
notification_emails:
- shong@mozilla.com
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
all_tabs_panel_entrypoint:
bug_numbers:
- 1804722
description: >
Records a count of how many times the All Tabs Panel was opened, keyed on a string
describing the entrypoint.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
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'
tabs_context_entrypoint:
bug_numbers:
- 1804722
description: >
Records a count for each entrypoint (the container of the trigger node) when an
item from the tabs context menu is selected.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- mconley@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
- 1827765
- 1850874
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: '122'
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
- 1827765
- 1850874
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: '122'
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
- 1827765
- 1850874
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: '122'
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.apis.dnr:
startup_cache_entries:
bug_numbers:
- 1803363
- 1850890
description: >
Counters for startup cache data hits or misses on initializating
DNR rules for extensions loaded on application startup.
The expected keys are 'hit' and 'miss'.
This probe is mirrored from a Glean metric with the same name.
keyed: true
expires: '126'
kind: uint
notification_emails:
- addons-dev-internal@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
evaluate_rules_count_max:
bug_numbers:
- 1803363
- 1850890
description: >
Max amount of DNR rules being evaluated.
expires: '126'
kind: uint
notification_emails:
- addons-dev-internal@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
extensions.quarantinedDomains:
listsize:
bug_numbers:
- 1840615
description: >
Number of domains listed in the quarantined domains list pref for the client during
this session.
kind: uint
expires: "123"
notification_emails:
- addons-dev-internal@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
listhash:
bug_numbers:
- 1841683
description: >
SHA1 cryptographic hash of the quarantined domains string pref.
kind: string
expires: "123"
notification_emails:
- addons-dev-internal@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
remotehash:
bug_numbers:
- 1840615
description: >
SHA1 cryptographic hash of the quarantined domains string pref as it was
set based on the value got synced from the RemoteSettings collection.
kind: string
expires: "123"
notification_emails:
- addons-dev-internal@mozilla.com
products:
- 'firefox'
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: "125"
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
- 1841930
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: "124"
kind: uint
keyed: true
notification_emails:
- seceng-telemetry@mozilla.com
- jschanck@mozilla.com
- dkeeler@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
bloburl:
resolve_stopped:
bug_numbers:
- 1843158
description: >
Counts how many times we do not resolve a blob URL
because of different partition keys
expires: "127"
kind: uint
notification_emails:
- amadan@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- content
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'
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