Source code
Revision control
Other Tools
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# This file contains a definition of the scalar probes that are recorded in Telemetry.
# They are submitted with the "main" pings and can be inspected in about:telemetry.
# The following section contains the accessibility scalars.
a11y:
backplate:
bug_numbers:
- 1539212
description: >
Boolean tracking if the user has the backplate preference enabled or disabled.
expires: never
kind: boolean
notification_emails:
- accessibility@mozilla.com
- mreschenberg@mozilla.com
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
release_channel_collection: opt-out
keyed: false
instantiators:
bug_numbers:
- 1323069
- 1462238
description: >
The leaf name and version number of the binary for the process responsible
for remotely instantiating a11y.
expires: never
kind: string
notification_emails:
- accessibility@mozilla.com
- jteh@mozilla.com
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
release_channel_collection: opt-out
keyed: false
indicator_acted_on:
bug_numbers:
- 1412358
description: >
Recorded on click or SPACE/ENTER keypress event. Boolean stating if the
accessibility indicactor button was acted on.
expires: "62"
kind: boolean
notification_emails:
- yzenevich@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
theme:
bug_numbers:
- 1022528
description: >
OS high contrast or other accessibility theme is enabled.
The result is split into keys which represent the values of
browser.display.document_color_use: "default", "always", or "never".
keyed: true
expires: never
kind: boolean
notification_emails:
- accessibility@mozilla.com
- eisaacson@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
# The following section contains the browser engagement scalars.
browser.engagement:
max_concurrent_tab_count:
bug_numbers:
- 1271304
description: >
The count of maximum number of tabs open during a subsession,
across all windows, including tabs in private windows and restored
at startup.
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
tab_open_event_count:
bug_numbers:
- 1271304
description: >
The count of tab open events per subsession, across all windows, after the
session has been restored. This includes tab open events from private windows
and from manual session restorations (i.e. after crashes and from about:home).
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
max_concurrent_window_count:
bug_numbers:
- 1271304
description: >
The count of maximum number of browser windows open during a subsession. This
includes private windows and the ones opened when starting the browser.
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
window_open_event_count:
bug_numbers:
- 1271304
description: >
The count of browser window open events per subsession, after the session
has been restored. The count includes private windows and the ones from manual
session restorations (i.e. after crashes and from about:home).
expires: never
kind: uint
notification_emails:
- rweiss@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
max_concurrent_tab_pinned_count:
bug_numbers:
- 1505535
description: >
The count of maximum number of pinned tabs open during a subsession. This
includes private windows and the ones opened when starting the browser.
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'
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. This does not include background
page requests and URIs from embedded pages or private browsing.
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'
restored_pinned_tabs_count:
bug_numbers:
- 1373728
- 1451475
description: >
The count of the number of pinned tabs that were restored.
expires: '67'
kind: uint
notification_emails:
- chutten@mozilla.com
- jrediger@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
# The following section contains the browser engagement scalars.
browser.engagement.navigation:
urlbar:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from the urlbar (awesomebar),
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
urlbar_searchmode:
bug_numbers:
- 1654680
description: >
The count URI loads triggered in a subsession from the urlbar's search
mode, broken down by the originating action.
expires: never
kind: uint
keyed: True
notification_emails:
- htwyford@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
searchbar:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from the searchbar,
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
about_home:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from about:home,
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
about_newtab:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from about:newtab,
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
contextmenu:
bug_numbers:
- 1271313
description: >
The count URI loads triggered in a subsession from the contextmenu,
broken down by the originating action.
expires: never
kind: uint
keyed: true
notification_emails:
- bcolloran@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
webextension:
bug_numbers:
- 1492233
description: >
The count URI loads triggered in a subsession from a webextension.
expires: never
kind: uint
keyed: true
notification_emails:
- mkaply@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
browser.startup:
slow_startup_notification_disabled:
bug_numbers:
- 1601993
- 1634224
description:
Whether the slow startup notification bar is disabled for the user.
expires: "85"
kind: boolean
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
too_new_for_notification:
bug_numbers:
- 1601993
- 1634224
description:
Whether the slow startup notification bar was suppressed because the profile is too new.
expires: "85"
kind: boolean
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
slow_startup_notified:
bug_numbers:
- 1601993
- 1634224
description:
Whether the slow startup notification bar was shown to the user during this session.
expires: "85"
kind: boolean
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
recorded_time:
bug_numbers:
- 1601993
- 1634224
description: >
The startup time computed by the slow startup notification bar in milliseconds.
expires: "85"
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
average_time:
bug_numbers:
- 1601993
- 1634224
description: >
The average startup time computed by the slow startup notification bar in milliseconds.
expires: "85"
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
action:
bug_numbers:
- 1601993
- 1634224
description: >
The action that the user took with the slow startup notification bar.
0: No action (default)
1: User chose to open SUMO document on slow startup
2: User chose to never show the notification bar again
3: User dismissed the notification bar
expires: "85"
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
abouthome_cache_result:
bug_numbers:
- 1622263
- 1614351
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: "87"
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
abouthome_cache_shutdownwrite:
bug_numbers:
- 1622263
- 1614351
description: >
True if the about:home startup cache was written via the AsyncShutdown
blocker.
expires: "87"
kind: boolean
notification_emails:
- mconley@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.input:
touch_event_count:
bug_numbers:
- 1626099
description: >-
Windows only.
Counts occurrences of touch events,
measured when user starts a touch event.
expires: "90"
kind: uint
notification_emails:
- gfx-telemetry-alerts@mozilla.com
- ktaeleman@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
- 'content'
browser.ui:
toolbar_widgets:
bug_numbers:
- 1620358
description: >
The widgets in the toolbars.
expires: never
kind: boolean
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
customized_widgets:
bug_numbers:
- 1620358
description: >
Records when widgets are added, removed or moved in the UI.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
browser.ui.interaction:
keyboard:
bug_numbers:
- 1620358
description: >
Records a count of interactions with keyboard shortcuts.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
menu_bar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the menu bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
tabs_bar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the tab bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
nav_bar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the nav bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
bookmarks_bar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the bookmarks bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
app_menu:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the app menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
tabs_context:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the tab context menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
content_context:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the content context menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
overflow_menu:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the overflow menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
pinned_overflow_menu:
bug_numbers:
- 1620358
description: >
Records a count of interactions with items in the pinned area of the
overflow menu.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
pageaction_urlbar:
bug_numbers:
- 1620358
description: >
Records a count of interactions with page action items in the url bar.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
pageaction_panel:
bug_numbers:
- 1620358
description: >
Records a count of interactions with page action items in the panel.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneHome:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Home section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneGeneral:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the General section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_panePrivacy:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Privacy section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneSearch:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Search section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneSearchResults:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Search results section of
preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneSync:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Sync section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneContainers:
bug_numbers:
- 1620358
description: >
Records the items interacted with in the Containers section of
preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneExperimental:
bug_numbers:
- 1620358
- 1651986
description: >
Records the items interacted with in the Experimental section of
preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_paneUnknown:
bug_numbers:
- 1620358
- 1651986
description: >
Records the items interacted with in any other section of preferences.
expires: never
kind: uint
keyed: true
notification_emails:
- shong@mozilla.com
- dtownsend@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
gecko:
version:
bug_numbers:
- 1611240
description: >
The version of the Gecko engine, example: '74.0a1'.
It consists of the major and minor version, followed by the release life cycle phase.
'a' stands for alpha or nightly, 'b' stands for beta.
The number behind the release life cycle phase indicates minor releases within the phase.
expires: never
kind: string
notification_emails:
- gfx-telemetry-alerts@mozilla.com
- ktaeleman@mozilla.com
products:
- 'geckoview_streaming'
record_in_processes:
- 'main'
release_channel_collection: opt-out
build_id:
bug_numbers:
- 1611240
description: >
The build id of the Gecko engine, example: '20200205124310'.
It contains the time the build was created and is used as a unique id for the build.
expires: never
kind: string
notification_emails:
- gfx-telemetry-alerts@mozilla.com
- ktaeleman@mozilla.com
products:
- 'geckoview_streaming'
record_in_processes:
- 'main'
release_channel_collection: opt-out
extensions.updates:
rdf:
bug_numbers:
- 1460336
description: >
The number of RDF update requsts for a given extension ID.
expires: "66"
kind: uint
keyed: true
notification_emails:
- addons-dev-internal@mozilla.com
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
identity.fxaccounts:
missed_commands_fetched:
bug_numbers:
- 1644598
description: >
The number of missed FxA commands we have recovered.
expires: "85"
kind: uint
keyed: false
notification_emails:
- sync-team@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
push_state_command_target:
bug_numbers:
- 1644598
description: >
The push state of the device we are sending a command to.
expires: "85"
kind: uint
keyed: true
keys: ["ok", "expiredCallback", "noCallback"]
notification_emails:
- sync-team@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
push_state_this_device:
bug_numbers:
- 1644598
description: >
The reason why the push state for this device is in a bad shape.
expires: "85"
kind: uint
keyed: true
keys: ["expiredCallback", "noCallback"]
notification_emails:
- sync-team@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
security:
webauthn_used:
bug_numbers:
- 1265472
- 1558870
- 1630155
description: >
Counts of how often Web Authentication was used in this session, keyed
by authenticator protocol, method and result. Currently: U2FRegisterFinish,
U2FRegisterAbort, U2FSignFinish, U2FSignAbort.
expires: "88"
kind: uint
keyed: true
notification_emails:
- seceng-telemetry@mozilla.com
- jjones@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
intermediate_preloading_num_preloaded:
bug_numbers:
- 1519273
- 1553550
description: >
Number of intermediate certificates pre-loaded.
expires: "86"
kind: uint
notification_emails:
- seceng-telemetry@mozilla.com
- jjones@mozilla.com
- dkeeler@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
intermediate_preloading_num_pending:
bug_numbers:
- 1519273
- 1553550
description: >
Number of intermediate certificates pending pre-load.
expires: "86"
kind: uint
notification_emails:
- seceng-telemetry@mozilla.com
- jjones@mozilla.com
- dkeeler@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
client_cert:
bug_numbers:
- 1255120
description: >
Counts of events related to client certificates this session. Currently:
"requested" (a server requested a client certificate), "sent" (a client
certificate was sent), "compat" (a compatibility workaround was required).
expires: "66"
kind: uint
keyed: true
notification_emails:
- seceng-telemetry@mozilla.com
- dkeeler@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
tls_delegated_credentials_txn:
bug_numbers:
- 1564179
- 1645082
description: >-
Count of how many transactions used delegated credentials (ietf-draft-tls-subcerts)
expires: "86"
kind: uint
notification_emails:
- seceng-telemetry@mozilla.com
- kjacobs@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
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'
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
description: >
A count of the number of tracking events blocked.
expires: "86"
kind: uint
notification_emails:
- ewright@mozilla.com
- chsiang@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
datasanitization:
network_cookie_lifetimePolicy:
bug_numbers:
- 1589753
- 1617241
- 1645089
description: >
This scalar reports the value of the network.cookie.lifetimePolicy pref.
expires: "86"
kind: uint
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_sanitize_sanitizeOnShutdown:
bug_numbers:
- 1589753
- 1617241
- 1645089
description: >
A boolean reporting the value of the privacy.sanitize.sanitizeOnShutdown pref.
expires: "86"
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
description: >
A boolean reporting the value of the privacy.clearOnShutdown.cookies pref.
expires: "86"
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
description: >
A boolean reporting the value of the privacy.clearOnShutdown.history pref.
expires: "86"
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
description: >
A boolean reporting the value of the privacy.clearOnShutdown.formdata pref.
expires: "86"
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
description: >
A boolean reporting the value of the privacy.clearOnShutdown.downloads pref.
expires: "86"
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
description: >
A boolean reporting the value of the privacy.clearOnShutdown.cache pref.
expires: "86"
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
description: >
A boolean reporting the value of the privacy.clearOnShutdown.sessions pref.
expires: "86"
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
description: >
A boolean reporting the value of the privacy.clearOnShutdown.offlineApps pref.
expires: "86"
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
description: >
A boolean reporting the value of the privacy.clearOnShutdown.siteSettings pref.
expires: "86"
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
description: >
A boolean reporting the value of the privacy.clearOnShutdown.openWindows pref.
expires: "86"
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
description: >
A count of how many "session" cookie exceptions a user has set.
expires: "86"
kind: uint
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
downloads:
panel_shown:
bug_numbers:
- 1627676
description: >
The count of how many times the downloads panel was shown per session.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
- emalysz@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
file_opened:
bug_numbers:
- 1627676
description: >
The count of how many times files were opened from the download panel.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
- emalysz@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
sandbox:
no_job:
bug_numbers:
- 1392570
description: >
Indicates that we can't use a job object for sandboxed child processes.
Keyed by whether we are in a remote session or not from ::GetSystemMetrics(SM_REMOTESESSION).
expires: "62"
kind: boolean
keyed: true
notification_emails:
- bowen@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
operating_systems:
- "windows"
findbar:
shown:
bug_numbers:
- 1627688
description: >
The count of how many times the "Find toolbar" was shown per session.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
find_prev:
bug_numbers:
- 1627688
description: >
The count of how many times the find previous button was used per session.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
find_next:
bug_numbers:
- 1627688
description: >
The count of how many times the find next button was used per session.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
highlight_all:
bug_numbers:
- 1627688
description: >
The count of how many times the "Highlight All" button was used in find toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
match_case:
bug_numbers:
- 1627688
description: >
The count of how many times the "Match Case" button was used in find toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
match_diacritics:
bug_numbers:
- 1627688
description: >
The count of how many times the "Match Diacritics" button was used in find toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
whole_words:
bug_numbers:
- 1627688
description: >
The count of how many times the "Whole Words" button was used in find toolbar.
expires: never
kind: uint
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
sidebar:
opened:
bug_numbers:
- 1648530
description: >
The number of times the sidebar was opened, per view (e.g.: bookmarks, history,
synced tabs).
expires: never
kind: uint
keyed: true
notification_emails:
- emalysz@mozilla.com
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
search:
bug_numbers:
- 1648524
description: >
The number of searches from the sidebar, per view (e.g.: bookmarks, history).
expires: never
kind: uint
keyed: true
notification_emails:
- emalysz@mozilla.com
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
os.environment:
is_admin_without_uac:
bug_numbers:
- 1567219
description: >
Indicates that the process is lauched with Admin privileges but without
UAC.
expires: never
kind: boolean
notification_emails:
- tkikuchi@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
operating_systems:
- "windows"
allowed_app_sources:
bug_numbers:
- 1659157
description: >
Indicates what sources the OS is currently configured to allow apps to be
installed from. Possible values are "Anywhere", "Recommendations",
"PreferStore", "StoreOnly", "NoSuchFeature", or "Error". "Recommendations"
allows installs from anywhere, but recommends a comparable app from the
store, if available. "NoSuchFeature" will be reported on versions of
Windows that do not have an app source setting.
expires: never
kind: string
notification_emails:
- rtestard@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'thunderbird'
record_in_processes:
- main
operating_systems:
- "windows"
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: "87"
kind: uint
keyed: true
notification_emails:
- mconley@mozilla.com
- astevenson@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- content
closed_method:
bug_numbers:
- 1560590
- 1616045
description: >
The number of times a Picture-in-Picture window was closed, per trigger
mechanism (e.g.: the close button, the unpip button, originating tab going away,
process shutdown, etc).
expires: "87"
kind: uint
keyed: true
notification_emails:
- mconley@mozilla.com
- astevenson@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
saw_toggle:
bug_numbers:
- 1657155
description: >
The number of times a Picture-in-Picture toggle was presented to the user when
they hovered the video with the mouse pointer.
expires: "87"
kind: uint
notification_emails:
- mconley@mozilla.com
- astevenson@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- content
preferences:
created_new_user_prefs_file:
bug_numbers:
- 1367813
description: >-
A boolean indicating that profile/prefs.js was not found and it is being
created for the first time in this session.
expires: "62"
kind: boolean
notification_emails:
- bsmedberg@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
prefs_file_was_invalid:
bug_numbers:
- 1367813
description: >-
Set to true if a failure occurred reading profile/prefs.js.
expires: "62"
kind: boolean
notification_emails:
- bsmedberg@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
read_user_js:
bug_numbers:
- 1367813
description: >-
Set to true if user.js exists and was read.
expires: "62"
kind: boolean
notification_emails:
- bsmedberg@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
search_query:
bug_numbers:
- 1359306
description: >-
Each key is a search query string when user performs a search action within
about:preferences, and each value is the number of times that key is recorded.
The telemetry data will be recorded if there is a successful search result highlighted.
expires: "62"
kind: uint
keyed: true
notification_emails:
- chsiang@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
browser_home_page_change:
bug_numbers:
- 1392951
description: >-
The number of times the home page has been changed.
Recorded when a user changes his/her home page successfully.
expires: "62"
kind: uint
keyed: true
notification_emails:
- chsiang@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
browser_home_page_count:
bug_numbers:
- 1392951
description: >-
Each key is the number of home page urls when users change their home page,
multiple home pages can be set (delineated with a "|"),
and each value is the number of times that key is recorded.
The telemetry data will be recorded if a user changes his/her home page successfully.
expires: "62"
kind: uint
keyed: true
notification_emails:
- chsiang@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
use_current_page:
bug_numbers:
- 1392951
description: >-
The number of times the Use Current Page button has been clicked.
Recorded when a a user clicks the "Use Current Page" button.
expires: "62"
kind: uint
keyed: true
notification_emails:
- chsiang@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
use_bookmark:
bug_numbers:
- 1392951
description: >-
The number of times the "Use Bookmark..." button has been clicked.
Recorded when a a user clicks the "Use Bookmark..." button.
expires: "62"
kind: uint
keyed: true
notification_emails:
- chsiang@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
webrtc.video:
recv_codec_used:
bug_numbers:
- 1556766
description: >
The video codec used for receiving video on a WebRTC call.
expires: "never"
kind: uint
keyed: true
notification_emails:
- dminor@mozilla.com
- nohlmeier@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'content'
send_codec_used:
bug_numbers:
- 1556766
description: >
The video codec used for sending video on a WebRTC call.
expires: "never"
kind: uint
keyed: true
notification_emails:
- dminor@mozilla.com
- nohlmeier@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'content'
webrtc.sdp:
parser_diff:
bug_numbers:
- 1432955
- 1529787
- 1588571
description: >
The number of differences between the C based sipcc SDP parser and
the new rust based rsdparsa SDP parser keyed by predefined
names of attributes and values that do not match between
the sipcc parsing result and the rsdparsa parsing result or
between the rsdparsa parsing result and the original sdp.
This should help to improve the new rsdparsa to replace
the sipcc parser.
expires: "77"
kind: uint
keyed: true
notification_emails:
- nohlmeier@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'content'
mathml:
doc_count:
bug_numbers:
- 1362187
- 1538985
- 1590350
description: >
The number of documents that contained enabled MathML elements.
expires: never
kind: uint
notification_emails:
- emilio@mozilla.com
- fred.wang@free.fr
- dev-tech-layout@lists.mozilla.org
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'content'
mediarecorder:
recording_count:
bug_numbers:
- 1400757
- 1429765
- 1480589
- 1532391
description: >
The number of times a MediaRecorder has been started. Recorded when a MediaRecorder starts
expires: "72"
kind: uint
notification_emails:
- bvandyk@mozilla.com
- nohlmeier@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
- content
media:
element_in_page_count:
bug_numbers:
- 1476456
- 1499803
- 1570634
- 1652108
description: >
The number of times a document hierarchy contained at least one HTMLMediaElement. In addition, the telemetry probe 'MIXED_CONTENT_UNBLOCK_COUNTER' records the total number of loaded top level content documents, which can help us calculate the result of the percentage of documents using media.
expires: never
kind: uint
notification_emails:
- alwu@mozilla.com
- nohlmeier@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
# The following section contains content process base counters.
dom.contentprocess:
buildID_mismatch:
bug_numbers:
- 1366808
description: >
The number of times the about:restartrequired page appeared due to a
buildID mismatch between the parent and the content processes.
expires: never
kind: uint
notification_emails:
- spohl@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
os_priority_lowered:
bug_numbers:
- 1538987
description: >
The number of times a content process has had its OS priority lowered
due to only containing background tabs without audible media playing.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
- gsvelto@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
os_priority_raised:
bug_numbers:
- 1538987
description: >
The number of times a content process has had its OS priority raised
due to containing at least one foregrounded tab, or a tab with audible
media has started playing in it.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
- gsvelto@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
os_priority_change_considered:
bug_numbers:
- 1538987
description: >
The number of times we've had the opportunity to change content process
priority due to a tab switch or a tab being opened.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
- gsvelto@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
# The following section contains parent process base counters.
dom.parentprocess:
private_window_used:
bug_numbers:
- 1491047
description: >
Whether a private browsing window has been used in the session.
expires: never
kind: boolean
notification_emails:
- seceng-telemetry@mozilla.com
- ehsan+telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
devtools.toolbar.eyedropper:
opened:
bug_numbers:
- 1247985
- 1352115
description: Number of times the DevTools Eyedropper has been opened via the inspector toolbar.
expires: never
kind: uint
notification_emails:
- dev-developer-tools@lists.mozilla.org
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- 'main'
<