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:
always_underline_links:
bug_numbers:
- 1835194
description: >
Bool tracking if the user has always underline links 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
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'
installation.firstSeen:
failure_reason:
bug_numbers:
- 1811374
description: >
Only sent if unable to collect firstSeen data. Can have
value "NotFoundError" if file not found or other values
depending on the failure reason.
keyed: false
expires: "140"
kind: string
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
installer_type:
bug_numbers:
- 1811374
description: >
The type of installer used to install Firefox.
The value is one of "stub", "full", or "msix"
keyed: false
expires: "140"
kind: string
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
version:
bug_numbers:
- 1811374
description: >
The application version installed by the installer
(not necessarily the current version)
keyed: false
expires: "140"
kind: string
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
admin_user:
bug_numbers:
- 1811374
description: >
Whether the installer is running from an elevated admin user
keyed: false
expires: "140"
kind: boolean
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
install_existed:
bug_numbers:
- 1811374
description: >
'Whether there was already an install in this location'
keyed: false
expires: "140"
kind: boolean
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
profdir_existed:
bug_numbers:
- 1811374
description: >
'Whether the top-level profile directory existed'
keyed: false
expires: "140"
kind: boolean
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
other_inst:
bug_numbers:
- 1811374
description: >
'Whether there was already any non-MSIX install on this system'
keyed: false
expires: "140"
kind: boolean
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
other_msix_inst:
bug_numbers:
- 1811374
description: >
'Whether there was already any MSIX install on this system'
keyed: false
expires: "140"
kind: boolean
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
silent:
bug_numbers:
- 1811374
description: >
(optional, present if installer_type is "full")
Whether this was a silent install
keyed: false
expires: "140"
kind: boolean
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
from_msi:
bug_numbers:
- 1811374
description: >
(optional, present if installer_type is "full")
Whether this was an MSI install
keyed: false
expires: "140"
kind: boolean
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
default_path:
bug_numbers:
- 1811374
description: >
(optional, present if installer_type is "full")
Whether the default path was used
keyed: false
expires: "140"
kind: boolean
notification_emails:
- rtestard@mozilla.com
- application-update-telemetry-alerts@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
record_into_store:
- 'new-profile'
browser.backup:
enabled:
bug_numbers:
- 1908727
description: >
True if the BackupService is enabled by default.
expires: never
kind: boolean
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
scheduler_enabled:
bug_numbers:
- 1908727
description: >
True if the BackupService is configured to automatically create backups
in the background.
expires: never
kind: boolean
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
pswd_encrypted:
bug_numbers:
- 1908727
description: >
True if the BackupService is configured to encrypt backups.
expires: never
kind: boolean
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
location_on_device:
bug_numbers:
- 1908727
description: >
1 = the default location, 2 = a non-default location
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
prof_d_disk_space:
bug_numbers:
- 1884407
description: >
The total disk space available on the storage device that the profile
directory is stored on. To reduce fingerprintability, we round to the
nearest 10 megabytes and return the result in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
places_size:
bug_numbers:
- 1883642
description: >
The total file size of the places.sqlite db located in the current profile
directory, in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
favicons_size:
bug_numbers:
- 1883642
description: >
The total file size of the favicons.sqlite db located in the current profile
directory, in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
credentials_data_size:
bug_numbers:
- 1883736
description: >
The total size of logins, payment method, and form autofill related files
in the current profile directory, in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
security_data_size:
bug_numbers:
- 1883736
description: >
The total size of files needed for NSS initialization parameters and security
certificate settings in the current profile directory, in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
preferences_size:
bug_numbers:
- 1883739
description: >
The total size of files relating to user preferences and permissions in the current profile
directory, in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
misc_data_size:
bug_numbers:
- 1883747
- 1887746
description: >
The total size of files for telemetry, site storage, media device origin mapping,
chrome privileged IndexedDB databases, and Mozilla Accounts in the current profile directory,
rounded to the nearest tenth kilobyte.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
cookies_size:
bug_numbers:
- 1883740
description: >
The total file size of the cookies.sqlite db located in the current profile
directory, in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
form_history_size:
bug_numbers:
- 1883740
description: >
The file size of the formhistory.sqlite db located in the current profile
directory, in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
session_store_backups_directory_size:
bug_numbers:
- 1883740
description: >
The total size of the session store backups directory, in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
session_store_size:
bug_numbers:
- 1883740
description: >
The size of uncompressed session store json, in kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
extensions_json_size:
bug_numbers:
- 1883655
description: >
The total file size of the extensions json files located in the current
profile directory,rounded to the nearest 10 kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
extension_store_permissions_data_size:
bug_numbers:
- 1883655
description: >
The file size of the current profiles extension-store-permissions/data.safe.bin
file, rounded to the nearest 10 kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
storage_sync_size:
bug_numbers:
- 1883655
description: >
The file size of the current profiles storage-sync-v2.sqlite database,
rounded to the nearest 10 kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
browser_extension_data_size:
bug_numbers:
- 1883655
description: >
The total size of the current profiles storage.local legacy JSON backend
in the browser-extension-data directory, rounded to the nearest 10 kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
extensions_xpi_directory_size:
bug_numbers:
- 1883655
description: >
The total size of the current profiles extensions directory,
rounded to the nearest 10 kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
extensions_storage_size:
bug_numbers:
- 1883655
description: >
The total size of all extensions storage directories,
rounded to the nearest 10 kilobytes.
expires: never
kind: uint
notification_emails:
- mconley@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
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'
max_concurrent_vertical_tab_count:
bug_numbers:
- 1899352
description: >
The count of maximum number of tabs with vertical tabs enabled.
expires: never
kind: uint
notification_emails:
- vsabino@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
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'
vertical_tab_open_event_count:
bug_numbers:
- 1899352
description: >
The count of tab open events with vertical tabs enabled.
expires: never
kind: uint
notification_emails:
- vsabino@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
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'
max_concurrent_vertical_tab_pinned_count:
bug_numbers:
- 1899352
description: >
The count of maximum number of pinned tabs with vertical tabs enabled.
expires: never
kind: uint
notification_emails:
- vsabino@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
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'
vertical_tab_pinned_event_count:
bug_numbers:
- 1899352
description: >
The count of tab pinned events with vertical tabs enabled.
expires: never
kind: uint
notification_emails:
- vsabino@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
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'
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.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'
vertical_tabs_container:
bug_numbers:
- 1921789
description: >
Records a count of interactions with items in the vertical tab bar.
expires: never
kind: uint
keyed: true
notification_emails:
- vsabino@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'
extensions.apis.dnr:
startup_cache_entries:
bug_numbers:
- 1803363
- 1850890
- 1881406
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: '138'
kind: uint
notification_emails:
- addons-dev-internal@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
evaluate_rules_count_max:
bug_numbers:
- 1803363
- 1850890
- 1881406
description: >
Max amount of DNR rules being evaluated.
expires: '138'
kind: uint
notification_emails:
- addons-dev-internal@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
extensions.startupCache:
write_byteLength:
bug_numbers:
- 1767336
- 1892151
- 1928258
description: >
The amount of bytes writted into the Extensions StartupCache file.
expires: "140"
kind: uint
notification_emails:
- addons-dev-internal@mozilla.com
- lgreco@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
read_errors:
bug_numbers:
- 1767336
- 1892151
- 1928258
description: >
The amount of times an unexpected error has been raised while
reading the Extensions StartupCache file
expires: "140"
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
- 1912170
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: "140"
kind: uint
notification_emails:
- addons-dev-internal@mozilla.com
- lgreco@mozilla.com
products:
- 'firefox'
record_in_processes:
- main
security:
https_only_mode_enabled:
bug_numbers:
- 1620244
description: >
Measures user retention of the HTTPS-Only Mode.
0 = never enabled, 1 = enabled, 2 = disabled (but was enabled)
expires: never
kind: uint
notification_emails:
- julianwels@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
https_only_mode_enabled_pbm:
bug_numbers:
- 1647719
description: >
Measures user retention of the HTTPS-Only Mode in Private Browsing.
0 = https-only never enabled in PBM,
1 = https-only enabled in PBM,
2 = https-only disabled in PBM (but was enabled)
expires: never
kind: uint
notification_emails:
- julianwels@mozilla.com
- ckerschb@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
global_privacy_control_enabled:
bug_numbers:
- 1734185
description: >
Measures user retention of the Global Privacy Control.
0 = never enabled, 1 = enabled, 2 = disabled (but was enabled)
expires: never
kind: uint
notification_emails:
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- 'main'
client_auth_cert_usage:
bug_numbers:
- 1749884
description: >
Measures how many servers have requested a client authentication
certificate (key: "requested") and how many times the user has opted to
send one in response (key: "sent").
expires: never
kind: uint
keyed: true
notification_emails:
- dkeeler@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
pwmgr:
potentially_breached_passwords:
bug_numbers:
- 1577808
description: >
The number of potentially breached passwords, as determined by
LoginBreaches.getPotentialBreachesByLoginGUID.
expires: never
kind: uint
notification_emails:
- seceng-telemetry@mozilla.com
- passwords-dev@mozilla.org
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
contentblocking:
cryptomining_blocking_enabled:
bug_numbers:
- 1522919
description: >
True if cryptominer blocking is enabled globally at startup.
expires: never
kind: boolean
notification_emails:
- aedelstein@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
fingerprinting_blocking_enabled:
bug_numbers:
- 1522919
description: >
True if fingerprinter blocking is enabled globally at startup.
expires: never
kind: boolean
notification_emails:
- aedelstein@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
category:
bug_numbers:
- 1529425
description: >
This scalar reports the value of the content blocking category pref (0 = "standard", 1 = "strict", 2 = "custom", 3 = some other value, this is not supported).
expires: never
kind: uint
notification_emails:
- aedelstein@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
- 'fennec'
record_in_processes:
- main
trackers_blocked_count:
bug_numbers:
- 1577030
- 1610894
- 1645088
- 1678209
description: >
A count of the number of tracking events blocked.
expires: never
kind: uint
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-out
products:
- 'firefox'
record_in_processes:
- main
datasanitization:
privacy_sanitize_sanitizeOnShutdown:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.sanitize.sanitizeOnShutdown pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_cookies:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.cookies pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in
products:
- 'firefox'
record_in_processes:
- main
privacy_clearOnShutdown_history:
bug_numbers:
- 1589753
- 1617241
- 1645089
- 1678210
description: >
A boolean reporting the value of the privacy.clearOnShutdown.history pref.
expires: never
kind: boolean
notification_emails:
- ewright@mozilla.com
- seceng-telemetry@mozilla.com
release_channel_collection: opt-in