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
partner_link:
click:
objects: ["newtab", "urlbar"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: ["main"]
description: >
This is recorded when clicking a partner link. The value is the partner.
bug_numbers: [1637217, 1644442, 1643426]
notification_emails:
- "dao@mozilla.com"
expiry_version: never
attribution:
objects: ["success", "failure", "abort"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: ["main"]
description: >
This is recorded when sending an attribution request for a partner link. The value is the partner.
bug_numbers: [1637217, 1644442, 1643426]
notification_emails:
- "dao@mozilla.com"
expiry_version: never
activity_stream:
event:
objects: [
"ARCHIVE_FROM_POCKET",
"BLOCK",
"BOOKMARK_ADD",
"BOOKMARK_DELETE",
"CLICK",
"CLICK_PRIVACY_INFO",
"CLOSE_NEWTAB_PREFS",
"SHOW_PERSONALIZE",
"HIDE_PERSONALIZE",
"DELETE",
"DELETE_FROM_POCKET",
"DELETE_CONFIRM",
"DIALOG_CANCEL",
"DIALOG_OPEN",
"DRAG",
"DROP",
"IMPRESSION",
"FAKESPOT_CATEGORY",
"FAKESPOT_CLICK",
"MIGRATION_CANCEL",
"MIGRATION_START",
"OPEN_NEWTAB_PREFS",
"OPEN_NEW_WINDOW",
"OPEN_PRIVATE_WINDOW",
"PIN",
"POCKET_THUMBS_DOWN",
"POCKET_THUMBS_UP",
"PREF_CHANGED",
"PREVIEW_REQUEST",
"SAVE_TO_POCKET",
"SEARCH",
"SEARCH_EDIT_ADD",
"SEARCH_EDIT_CLOSE",
"SEARCH_EDIT_DELETE",
"SEARCH_HANDOFF",
"SHOW_PRIVACY_INFO",
"SKIPPED_SIGNIN",
"SUBMIT_EMAIL",
"DISCLAIMER_ACKED",
"MENU_ADD_SEARCH",
"MENU_ADD_TOPSITE",
"MENU_COLLAPSE",
"MENU_EXPAND",
"MENU_MANAGE",
"MENU_MOVE_DOWN",
"MENU_MOVE_UP",
"MENU_PRIVACY_NOTICE",
"MENU_REMOVE",
"TOP_SITES_EDIT",
"TOP_SITES_EDIT_CLOSE",
"TOPSITE_SPONSOR_INFO",
"UNPIN"]
release_channel_collection: opt-out
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: >
This is recorded with every user interaction on Activity Stream elements.
bug_numbers: [1429497, 1429489, 1514732]
notification_emails:
- "najiang@mozilla.com"
- "msamuel@mozilla.com"
- "rrosario@mozilla.com"
expiry_version: never
extra_keys:
addon_version: The Activity Stream addon version.
session_id: The ID of the Activity Stream session in which the event occurred
page: about:home or about_newtab - the page where the event occurred
user_prefs: An integer representaing a user's A-S settings.
action_position: The index of card receiving interactions.
end:
objects: ["session"]
release_channel_collection: opt-out
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: >
This is recorded with every session ended in Activity Stream.
bug_numbers: [1429497, 1429489]
notification_emails:
- "najiang@mozilla.com"
- "msamuel@mozilla.com"
expiry_version: never
extra_keys:
addon_version: The Activity Stream addon version.
session_id: The ID of the Activity Stream session in which the event occurred
page: about:home or about_newtab - the page where the event occurred
user_prefs: An integer representaing a user's A-S settings.
aboutprivatebrowsing:
click:
objects: ["info_link", "promo_link", "dismiss_button"]
release_channel_collection: opt-out
record_in_processes: ["content"]
description: >
This is recorded when a user clicks a link on the private browsing newtab.
bug_numbers: [1709344, 1754635, 1781973, 1811146, 1841925, 1871197, 1922596]
notification_emails:
- "pbz@mozilla.com"
- "tihuang@mozilla.com"
expiry_version: "139"
products:
- "firefox"
readermode:
view:
objects: ["on", "off"]
release_channel_collection: opt-out
record_in_processes: ["content"]
description: >
This is recorded any time Reader Mode is turned on or off.
bug_numbers: [1689201]
notification_emails:
- "kirill@getpocket.com"
- "sdowne@getpocket.com"
expiry_version: never
extra_keys:
subcategory: The broad event category for this probe. E.g. navigation
reader_time: Time spent in Reader Mode session in seconds (whole number)
scroll_position: Percentage of window scrolled in Reader Mode (whole number)
products:
- "firefox"
button:
objects: ["click"]
release_channel_collection: opt-out
record_in_processes: ["content"]
description: >
This is recorded any time a Reader Mode button is clicked.
bug_numbers: [1693362]
notification_emails:
- "kirill@getpocket.com"
- "sdowne@getpocket.com"
expiry_version: never
extra_keys:
label: The type of button clicked.
products:
- "firefox"
addonsManager:
install:
description: >
These events are recorded during the install and update flow for extensions and themes,
the value of the event is an install_id shared by the events related to the same install
or update flow.
objects:
- "extension"
- "theme"
- "locale"
- "dictionary"
- "sitepermission"
- "siteperm_deprecated"
- "other"
- "unknown"
methods: ["install", "update"]
extra_keys:
addon_id: A string which identify the extension (when available)
download_time: The number of ms needed to complete the download
error: The AddonManager error related to an install or update failure.
source: >
The source that originally triggered the add-on installation, one of "about:addons",
"about:debugging", "about:preferences", "amo", "browser-import", "disco", "distribution",
"extension", "enterprise-policy", "file-url", "geckoview-app", "gmp-plugin",
"internal", "plugin", "rtamo", "siteperm-addon-provider" "sync", "system-addon",
"temporary-addon", "unknown", "about:editprofile", "about:newprofile".
For events with method set to "sideload", the source value is derived from the XPIProvider
location name (e.g. possible values are "app-builtin", "app-global", "app-profile",
"app-system-addons", "app-system-defaults", "app-system-local", "app-system-profile",
"app-system-share", "app-system-user", "winreg-app-user", "winreg-app-gobal")
method: >
The method used by the source to install the add-on (included when the source can use more than one,
e.g. install events with source "about:addons" may have "install-from-file" or "url" as method),
one of "amWebAPI", "drag-and-drop", "installTrigger", "install-from-file", "link",
"management-webext-api", "sideload", "onboarding" "synthetic-install", "url", "product-updates".
e.g. install events with source "about:addons" may have "install-from-file" or "drag-and-drop" as method),
one of "amWebAPI", "drag-and-drop", "installTrigger", "install-from-file", "link", "management-webext-api",
"sideload", "synthetic-install", "url", "product-updates", "manager".
num_strings: The number of permission description strings in the extension permission doorhanger
updated_from: Determine if an update has been requested by the user or the application ("app" / "user")
install_origins: This flag indicates whether install_origins is defined in the addon manifest. ("1" / "0")
step: >
The current step in the install or update flow:
- started, postponed, cancelled, failed, permissions_prompt, completed
- site_warning, site_blocked, install_disabled_warning
- download_started, download_completed, download_failed
notification_emails: ["addons-dev-internal@mozilla.com"]
expiry_version: "140"
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main"]
bug_numbers: [1433335, 1515697, 1523641, 1549770, 1590736, 1630596, 1672570, 1714251, 1749878, 1781974, 1817100, 1861295, 1912166]
release_channel_collection: opt-out
install_stats:
description: >
These events are recorded at the end of the install flow, but only when
the source that originally triggered the add-on installation is "amo",
"rtamo" or "disco". The value of an event is the SHA256 hash of the
addon_id.
objects:
- "extension"
- "theme"
- "locale"
- "dictionary"
- "sitepermission"
- "siteperm_deprecated"
- "other"
- "unknown"
extra_keys:
addon_id: >
A string which identifies the add-on. This value might be trimmed.
taar_based: >
This extra key is only set for install flows related to the discovery
addon. When available it is going to be a string set to "1" for
TAAR based recommendations, "0" for manually curated and unset if
not relevant for the particular install flow.
utm_campaign: >
The specific product promotion or strategic campaign that drives
traffic to the install page.
utm_content: >
The specific item that a person clicks on to access the install page
(such as an A/B test, a website banner, or a specific ad).
utm_medium: The channel used to share the install page.
utm_source: >
The name of the product, domain of the website that drives traffic to
the install page.
notification_emails: ["addons-dev-internal@mozilla.com"]
expiry_version: never
products:
- "firefox"
record_in_processes: ["main"]
bug_numbers: [1653020, 1699225]
release_channel_collection: opt-out
manage:
description: >
This events are recorded when an installed add-ons is being disable/enabled/uninstalled,
the value of the event is the addon_id (which also allow to correlate multiple events
related to each other).
objects:
- "extension"
- "theme"
- "locale"
- "dictionary"
- "sitepermission"
- "siteperm_deprecated"
- "other"
- "unknown"
methods: ["disable", "enable", "sideload_prompt", "uninstall"]
extra_keys:
source: >
The source from which the addon has been installed (See extra_keys.source description from
addonsManager.install telemetry event definition).
method: >
The method used by the source to install the add-on (included when the source can use more than one,
e.g. install events with source "about:addons" may have "install-from-file" or "url" as method).
num_strings: The number of permission description strings in the extension permission doorhanger
blocklist_state: >
The add-on blocklistState (0 not-blocked, 1 soft-blocked, 2
hard-blocked) at the time the manage event was being collected.
notification_emails: ["addons-dev-internal@mozilla.com"]
expiry_version: "140"
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main"]
bug_numbers: [1433335, 1515697, 1523641, 1549770, 1590736, 1630596, 1672570, 1714251, 1749878, 1781974, 1817100, 1861295, 1912166, 1917859]
release_channel_collection: opt-out
addonsSearchDetection:
etld_change:
description: |
Recorded when a request for a search query is redirected to another
domain. This can be via the webRequest API, or through other means.
objects: ["webrequest", "other"]
methods: ["etld_change"]
extra_keys:
addonId: The id of the addon, if available.
addonVersion: The version of the addon.
from: The original domain (eTLD+1) of the request that matched a search endpoint.
to: The domain (eTLD+1) of the final redirect target.
notification_emails: ["addons-dev-internal@mozilla.com", "tlong@mozilla.com"]
expiry_version: "never"
products:
- "firefox"
record_in_processes: ["main"]
bug_numbers: [1894526]
release_channel_collection: opt-out
downloads:
added:
description: >
Sent when downloading a new file. Possible values are in contained in DownloadList::kFileExtensions.
All other downloads not in the listare marked as other.
objects: ["fileExtension"]
bug_numbers: [1627676, 1706355]
notification_emails: ["rtestard@mozilla.com", "emalysz@mozilla.com"]
products:
- "firefox"
record_in_processes: ["main"]
release_channel_collection: opt-out
expiry_version: never
form_autocomplete:
show:
objects: ["logins"]
bug_numbers: [1619498, 1628849]
description: >-
An content form autocomplete popup was shown. Details on the timing and context are provided.
The `value` is the number of milliseconds since the autocomplete search started.
expiry_version: never
extra_keys:
acFieldName: The "field name" token (last one) of the field's autocomplete attribute.
fieldType: The `type` property value of the field.
generatedPasswo: The number of generated password rows shown.
hadPrevious: Whether the autocomplete results had cached previous results it could use.
typeWasPassword: Whether the input `type` was ever "password".
insecureWarning: The number of insecure login field warning rows shown (should be 0 or 1).
login: The number of login rows shown (with or without the domain line).
importableLogin: The number of import suggestion rows shown.
loginsFooter: The number of "Manage Passwords" footer row shown.
stringLength: Length of the text in the field that triggered these results.
notification_emails: ["passwords-dev@mozilla.org"]
products:
- firefox
record_in_processes: ["main"]
release_channel_collection: opt-out
address:
doorhanger:
description: >-
User interactions for the browser address autofill doorhanger.
objects:
- "capture_doorhanger"
- "update_doorhanger"
- "edit_doorhanger"
methods:
- "show"
- "save"
- "update"
- "cancel"
- "disable"
- "pref"
- "learn_more"
bug_numbers: [1801039]
notification_emails: ["autofill@lists.mozilla.org", "passwords-dev@mozilla.org"]
expiry_version: never
products:
- "firefox"
record_in_processes: ["main"]
release_channel_collection: opt-out
manage:
description: >-
User interactions for address autofill preferences management UI.
objects:
- "manage"
methods:
- "show"
- "add"
- "delete"
- "show_entry"
- "edit"
bug_numbers: [1801039]
notification_emails: ["autofill@lists.mozilla.org", "passwords-dev@mozilla.org"]
expiry_version: never
products:
- "firefox"
record_in_processes: ["main"]
release_channel_collection: opt-out
address_form:
description: >-
User interactions for address autofill forms
'detected': Recorded when a form is recognized as a credit card form.
The possible value of cc_* in extra_keys are "true", "false", or 0
When the value is "true", the field is identified via autocomplete attribute
When the value is "false", the field is not detected in the form
When the value is an 0, then the field is identified by regexp-based heuristic
'popup_shown': Recorded when autofill popup is shown. Using field_name to record the field
that triggers this event
'filled': Recorded when a form is autofiled. Possible values are
`filled`, `not_filled`, `user_filled` or `unavailable`
'filled_modified': Recorded when a field is autofilled and then modified by the user.
Using field_name to record the field that triggers this event.
'submitted': Recorded when a form is submitted. Possible values are `autofilled`, `not_filled`, `user_filled` or `unavailable`
'cleared' Recorded when a form is cleared . Using field_name to record the field that triggers this event
objects: ["address_form"]
methods: ["detected", "popup_shown", "filled", "filled_modified", "submitted", "cleared"]
bug_numbers: [1804901]
notification_emails: ["autofill@lists.mozilla.org", "passwords-dev@mozilla.org"]
expiry_version: never
products:
- "firefox"
record_in_processes: ["main"]
release_channel_collection: opt-out
extra_keys:
street_address: street address result, filled when method is `detected`, `filled`, or `filled_modified`
address_line1: address_line1 result, filled when method is `detected`, `filled`, or `filled_modified`.
address_line2: address_line2 result, filled when method is `detected`, `filled`, or `filled_modified`.
address_line3: address_line3 result, filled when method is `detected`, `filled`, or `filled_modified`.
address_level1: address_level1 result, filled when method is `detected`, `filled`, or `filled_modified`.
address_level2: address_level2 result, filled when method is `detected`, `filled`, or `filled_modified`.
postal_code: postal_code result, filled when method is `detected`, `filled`, or `filled_modified`.
country: country result, filled when method is `detected`, `filled`, or `filled_modified`.
field_name: Name of the field being affected by the method, filled when method is `popup_shown` or `filled_modified`.
address_form_ext:
description: >-
Address has too many fields so we cannot cover them all in the above `address_form` telemetry
This telemetry is used to record address fields that are not listed in `address_form`
objects: ["address_form_ext"]
methods: ["detected", "filled", "submitted"]
bug_numbers: [1804901]
notification_emails: ["autofill@lists.mozilla.org", "passwords-dev@mozilla.org"]
expiry_version: never
products:
- "firefox"
record_in_processes: ["main"]
release_channel_collection: opt-out
extra_keys:
name: name
given_name: give_name
additional_name: additional_name
family_name: family_name
email: email
organization: organization
tel: telephone
creditcard:
doorhanger:
description: >-
User interactions for the browser credit card autofill doorhanger.
objects:
- "capture_doorhanger"
- "update_doorhanger"
methods:
- "show"
- "save"
- "update"
- "cancel"
- "disable"
bug_numbers: [1653073, 1653083, 1720608, 1767907]
notification_emails: ["autofill@lists.mozilla.org", "passwords-dev@mozilla.org"]
expiry_version: never
products:
- "firefox"
record_in_processes: ["main"]
release_channel_collection: opt-out
manage:
description: >-
User interactions for credit card autofill preferences management UI.
objects:
- "manage"
methods:
- "show"
- "add"
- "delete"
- "show_entry"
- "edit"
bug_numbers: [1653073, 1654167, 1720608, 1767907]
notification_emails: ["autofill@lists.mozilla.org", "passwords-dev@mozilla.org"]
expiry_version: never
products:
- "firefox"
record_in_processes: ["main"]
release_channel_collection: opt-out
cc_form_v2:
description: >-
User interactions for credit card autofill forms
Expected values are store in extra_keys and are varies depends on the methods
'detected': Recorded when a form is recognized as a credit card form.
The possible value of cc_* in extra_keys are "true", "false", or an integer between 0-100
When the value is "true", the field is identified via autocomplete attribute
When the value is "false", the field is not detected in the form
When the value is an integer greater than 0, the value indicates the confidence value from fathom (normalized to 0-100)
When the value is an 0, then the field is identified by regexp-based heuristic
'popup_shown': Recorded when autofill popup is shown. Using field_name to record the field
that triggers this event
'filled': Recorded when a form is autofiled. Possible values are
`filled`, `not_filled`, `user_filled` or `unavailable`
'filled_modified': Recorded when a field is autofilled and then modified by the user.
Using field_name to record the field that triggers this event.
'submitted': Recorded when a form is submitted. Possible values are `autofilled`, `user_filled` or `unavailable`
'cleared' Recorded when a form is cleared . Using field_name to record the field that triggers this event
objects:
- "cc_form_v2"
methods:
- "detected"
- "popup_shown"
- "filled"
- "filled_modified"
- "submitted"
- "cleared"
bug_numbers: [1757731]
notification_emails: ["autofill@lists.mozilla.org", "passwords-dev@mozilla.org"]
expiry_version: never
products:
- "firefox"
record_in_processes: ["main"]
release_channel_collection: opt-out
extra_keys:
cc_name: cardholder name field result. Used by `detected`, `filled`, and `filled_modified` methods.
cc_number: credit card number field result
cc_type: credit card type result
cc_exp: credit card expiration date
cc_exp_month: credit card expiration month
cc_exp_year: credit card expiration year
field_name: Name of the field being affected by the method. Used by `popup_shown` and `filled_modified` methods.
homepage:
preference:
objects: ["ignore"]
release_channel_collection: opt-out
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: >
This is recorded whenever the homepage preference is either reset due to
being on the ignore list, or setting is blocked due to being on the same
list.
The value field records the reason for the ignore. "saved_reset" for
when a saved preference value is reset. "set_blocked" for when the setting
was blocked and "set_blocked_extension" for when we know a WebExtension
attempting to set it was blocked.
bug_numbers: [1535049]
notification_emails:
- "mdeboer@mozilla.com"
- "rharter@mozilla.com"
expiry_version: never
extra_keys:
webExtensionId: The identifier of the webextension, if known.
upgrade_dialog:
trigger:
objects: ["reason"]
bug_numbers: [1697222]
description: >
Triggering behaviors of the upgrade dialog. Value indicates which condition failed or all satisfied.
expiry_version: never
notification_emails: ["edilee@mozilla.com"]
products: ["firefox"]
record_in_processes: ["main"]
release_channel_collection: opt-out
aboutpreferences:
show:
objects: ["initial", "click", "hash"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: ["main"]
description: >
This is recorded whenever a pane is shown inside about:preferences.
The object field records the type of action that resulted in showing a pane. Possible values are as follows,
"initial" is used when a pane is shown direclty. This happens with or without a hash in the URL. The "general" pane
loads without such a hash, when the pane is loaded via the "main" entrypoints in the menu system or with shortcuts.
"click" is used when a pane is shown when user clicks category name inside about:preferences.
"hash" is used when a pane is shown via a hash change in url.
The value field records identifier of pane shown
bug_numbers: [1738187]
notification_emails:
- "pdahiya@mozilla.com"
- "gijs@mozilla.com"
expiry_version: never
normandy:
enroll:
objects: ["preference_study", "addon_study", "preference_rollout", "addon_rollout", "nimbus_experiment"]
description: >
Sent when applying a Normandy recipe of the above types has succeeded.
extra_keys:
experimentType: >
For preference_study and nimbus_experiment recipes, the type of experiment this is ("exp" or "exp-highpop").
branch: >
The slug of the branch that was chosen for this client.
addonId: For addon_study recipes, the ID of the addon that was installed.
addonVersion: For addon_study recipes, the version of the addon that was installed.
bug_numbers: [1443560]
notification_emails: ["normandy-notifications@mozilla.com"]
products:
- "firefox"
- "fennec"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
enroll_failed:
methods: ["enrollFailed"]
objects: ["addon_study", "preference_rollout", "preference_study", "addon_rollout", "nimbus_experiment"]
description: >
Sent when applying a Normandy recipe of the above types has failed.
extra_keys:
reason: An error code describing the failure.
preference: >
For preference_rollout when reason=conflict, the name of the preference
that was going to be modified.
detail: >
For addon_study and branched_addon study, extra text describing the failure.
branch: >
The branch that failed to enroll.
addonId: The ID of the addon for the rollout when reason=conflict.
conflictingSlug: The slug for the conflicting rollout.
enrollmentId: The enrollment ID of the conflicting rollout.
prefBranch: For preference_study when reason=invalid-branch, the branch that was invalid.
bug_numbers: [1443560]
notification_emails: ["normandy-notifications@mozilla.com"]
products:
- "firefox"
- "fennec"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
update:
objects: ["addon_study", "preference_rollout", "addon_rollout", "nimbus_experiment"]
description: >
This event is fired when a client detects that a recipe of the
ahove types has changed on the server, and the new version of the
recipe is being applied over an existing, older version previously
fetched from the server.
extra_keys:
previousState: >
For preference_rollout recipes, the state of the rollout that had been applied
previously.
addonId: For addon_study recipes, the ID of the addon that was updated.
addonVersion: For addon_study recipes, the version of the addon that was installed.
branch: The branch that was updated.
enrollmentId: A unique ID for this enrollment that will be included in all related Telemetry.
bug_numbers: [1443560, 1474413]
notification_emails: ["normandy-notifications@mozilla.com"]
products:
- "firefox"
- "fennec"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
update_failed:
methods: ["updateFailed"]
objects: ["addon_study", "addon_rollout"]
description: >
Sent when applying a new version of a Normandy recipe of the above types (over an
existing, older version previously fetched from the server) has failed.
extra_keys:
reason: An error code describing the failure.
detail: >
Extra text describing the failure. Currently only provided for addon_study.
branch: The branch that failed to update.
enrollmentId: A unique ID for this enrollment that will be included in all related Telemetry.
bug_numbers: [1474413]
notification_emails: ["normandy-notifications@mozilla.com"]
products:
- "firefox"
- "fennec"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
unenroll:
objects: ["preference_study", "addon_study", "preference_rollback", "addon_rollback", "nimbus_experiment"]
description: >
Sent when a Normandy recipe of certain types "ends". N.B. For
preference_rollback, this is fired when the recipe is fired (the
recipe that "ends" is a corresponding preference_rollout).
extra_keys:
reason: A code describing the reason why the recipe ended.
didResetValue: >
For preference_study, "true" or "false" according to whether we put the preference back the way it was.
addonId: For addon_study, the ID of the addon that ended.
addonVersion: For addon_study, the version of the addon for which the recipe ended.
branch: The branch of the experiment that this client was on.
enrollmentId: A unique ID for this enrollment that will be included in all related Telemetry.
changedPref: >
For preference_study or nimbus_experiment, the preference that was
detected to change that caused the unenrollment.
conflictingSlug: >
For nimbus_experiment, if reason == "prefFlips-conflict", the conflicting
experiment that caused the unenrollment.
prefName: >
For nimbus_experiment, if reason == "prefFlips-failed", the name of the
pref that failed to set.
prefType: >
For nimbus_experiment, if reason = "prefFlips-failed", the type of the
existing pref value (one of "bool", "string", "int", or "invalid").
bug_numbers: [1443560, 1843126, 1896718, 1907649]
notification_emails:
- "normandy-notifications@mozilla.com"
- "nimbus-team@mozilla.com"
products:
- "firefox"
- "fennec"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
unenroll_failed:
methods: ["unenrollFailed"]
description: >
Sent when unenrolling a user fails (see the unenroll event).
objects: ["preference_rollback", "preference_study", "addon_rollback", "nimbus_experiment"]
extra_keys:
reason: A code describing the reason the unenroll failed.
enrollmentId: A unique ID for this enrollment that will be included in all related Telemetry.
changedPref: For preference_study, the preference that was detected to change that caused the attempted unenrollment.
caller: The function that caused the stop to happen, included on Nightly to aid debugging.
originalReason: The code that would had been used for the unenrollment, had it not failed.
bug_numbers: [1443560, 1693402]
notification_emails: ["normandy-notifications@mozilla.com"]
products:
- "firefox"
- "fennec"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
graduate:
objects: ["preference_rollout"]
description: >
Sent when a preference rollout ends due to the rolled-out
preference becoming a new default.
bug_numbers: [1443560]
notification_emails: ["normandy-notifications@mozilla.com"]
products:
- "firefox"
- "fennec"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
extra_keys:
enrollmentId: A unique ID for this enrollment that will be included in all related Telemetry.
reason: The reason the rollout graduated
expose:
objects: [
"nimbus_experiment",
]
methods: ["expose"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: ["main", "content"]
description: >
This records an event at the moment the user is exposed to an experiment
treatment. The event is triggered either by the code checking that a
certain experiment feature is enabled or when that feature value is used.
This is different from enrollment or experiment activation because it
registers when a user actually gets exposed to the experiment feature.
bug_numbers: [1675104]
notification_emails: ["ujet@mozilla.com"]
expiry_version: "never"
extra_keys:
branchSlug: The slug for the branch the user is enrolled in.
featureId: The type of experiment variant the user was enrolled into.
expPrefChanged:
objects: ["preference_study"]
methods: ["expPrefChanged"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: [main]
description: >
This records that a preference that was set by an experiment has been
changed away from its experimental value. This can be triggered by a
user changing a preference at runtime, by the preference being changed
on disk when Firefox is not running, or by the preference already
having a user-set value when a user has enrolls in a default branch
experiment.
bug_numbers: [1698684]
notification_emails: ["mcooper@mozilla.com"]
expiry_version: never
extra_keys:
preferenceName: The preference that changed
reason: The way that the preference change was detected ("observer", "sideload", or "onEnroll")
enrollmentId: A unique ID for this enrollment that will be included in all related Telemetry.
validation_failed:
objects: ["nimbus_experiment"]
methods: ["validationFailed"]
release_channel_collection: "opt-out"
products:
- "firefox"
record_in_processes: ["main"]
description: >
This records when validation of a recipe fails.
bug_numbers: [1762652]
notification_emails: ["beth@mozilla.com"]
expiry_version: never
extra_keys:
reason: Why validation failed (one of "invalid-recipe", "invalid-branch", or "invalid-reason").
branch: If reason == invalid-branch, the branch that failed validation.
feature: If reason == invalid-feature, the invalid feature ID.
locale: >
If reason == missing-locale, the locale that was missing from the
localization table.
If reason == missing-l10n-entry, the locale that was missing the
localization entries.
l10n_ids: >
If reason == missing-l10n-entry, a comma-separated list of missing
localization entries.
browser.launched_to_handle:
system_notification:
objects: ["toast"]
description: >
Recorded when Firefox launches to complete a native notification popped by
a system (chrome privileged) alert. Windows-only at the time of writing.
bug_numbers:
- 1788960
notification_emails:
- nalexander@mozilla.com
- rtestard@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
extra_keys:
name: >
The `name` of the system (chrome privileged) alert that Firefox was
launched to complete.
action: >
The `action` of the system (chrome privileged) alert that Firefox was
launched to complete.
browser.migration:
opened:
objects: ["wizard"]
description: >
Recorded when the migration wizard opens.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
no_browsers_found:
objects: ["wizard"]
description: >
Recorded when the migration wizard reports that there are no browsers to migrate from.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
browser_selected:
objects: ["wizard"]
description: >
Recorded when the user selects a browser to migrate from.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
extra_keys:
migrator_key: The key of the browser that was selected.
profile_selected:
objects: ["wizard"]
description: >
Recorded when the user selects a profile to migrate from. If the browser doesn't
support multiple profiles, this will not be recorded.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
extra_keys:
migrator_key: The key of the browser that had a profile selected for it.
resources_selected:
objects: ["wizard"]
description: >
Recorded when the user selects resources from the browser / profile to import.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
extra_keys:
migrator_key: The key of the browser that had resources selected for it.
history: >
"1" if history was selected. "0" otherwise.
formdata: >
"1" if form data was selected. "0" otherwise.
passwords: >
"1" if passwords was selected. "0" otherwise.
bookmarks: >
"1" if bookmarks were selected. "0" otherwise.
payment_methods: >
"1" if payment methods were selected. "0" otherwise.
extensions: >
"1" if extensions were selected. "0" otherwise.
other: A count of the number of other resource types that were selected.
configured: >
"1" if Variant 2 of the new Migration Wizard was being used, and the list of
resources was expanded. "0" otherwise.
linux_perms:
objects: ["wizard"]
description: >
Recorded if the user is on Linux and the browser is installed in a sandboxed
environment that prevents it from reading other browser's data, and the user
is presented with instructions and an option to grant the browser permission
to read that other data.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
extra_keys:
migrator_key: The key of the migrator that will perform the migration.
safari_perms:
objects: ["wizard"]
description: >
Recorded if the user is on macOS, chose to migrate from Safari, and was presented with
the page of the wizard requesting permission to read from the Safari profile folder.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
safari_password_file:
objects: ["wizard"]
description: >
Recorded if the user is on macOS, chose to migrate from Safari, and was presented with
the page of the wizard requesting to import passwords from a file. This only gets recorded
in the new migration wizard.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
migration_started:
objects: ["wizard"]
description: >
Recorded when the user begins a migration.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
extra_keys:
migrator_key: The key of the migrator that will perform the migration.
history: >
"1" if history is being migrated. "0" otherwise.
formdata: >
"1" if form data is being migrated. "0" otherwise.
passwords: >
"1" if passwords are being migrated. "0" otherwise.
bookmarks: >
"1" if bookmarks are being migrated. "0" otherwise.
payment_methods: >
"1" if payment methods are being migrated. "0" otherwise.
extensions: >
"1" if extensions are being migrated. "0" otherwise.
other: A count of the number of other resource types that are being migrated.
migration_finished:
objects: ["wizard"]
description: >
Recorded when the user finishes a migration.
bug_numbers:
- 1824786
notification_emails:
- mconley@mozilla.com
products:
- "firefox"
record_in_processes: [main]
release_channel_collection: opt-out
expiry_version: never
extra_keys:
migrator_key: The key of the migrator that will perform the migration.
history: >
"1" if history was migrated. "0" otherwise.
formdata: >
"1" if form data was migrated. "0" otherwise.
passwords: >
"1" if passwords were migrated. "0" otherwise.
bookmarks: >
"1" if bookmarks were migrated. "0" otherwise.
payment_methods: >
"1" if payment methods were migrated. "0" otherwise.
extensions: >
"1" if no extensions were matched, "2" if only some extensions
were matched, "3" if all extensions were matched, and "0" if extensions
weren't selected for migration.
other: A count of the number of other resource types that were migrated.
pwmgr:
open_management:
objects: ["aboutprotections", "autocomplete", "capturedoorhanger", "contextmenu", "direct", "fxamenu", "mainmenu", "pageinfo", "preferences", "snippet"]
methods: ["open_management"]
description: >
Sent when opening the password management UI.
bug_numbers: [1543499, 1454733, 1545172, 1550631, 1622971]
notification_emails: ["loines@mozilla.com", "passwords-dev@mozilla.org", "sfoster@mozilla.com"]
products:
- "firefox"
record_in_processes: [main, content]
release_channel_collection: opt-out
expiry_version: never
reauthenticate:
description: >
Measure how often users are asked to authenticate with their Operating System or Master Password to gain access to stored passwords.
Possible values are as follows,
"success" should be used when the user authenticates and provides a password or other authentication factor.
"success_no_prompt" should be used when the feature is enabled but no prompt is given to the user because they have recently authenticated.
"success_disabled" is used when the feature is disabled.
"success_unsupported_platform" should be set when the user attempts to authenticate on an unsupported platform.
"success_no_password" should be used when the user doesn't have an OS password set.
"fail" should be used when the user cancels the authentication prompt or an unexpected exception is encountered. The user may or may not have provided an incorrect password before cancelling.
objects: [
"master_password",
"os_auth",
]
methods: ["reauthenticate"]
extra_keys:
auto_admin: >
If the AutoAdminLogon Windows feature is enabled. This feature disables password prompt when logging in to Windows.
require_signon: >
If the Power Settings on Windows are configured to not prompt for password upon resuming from sleep.
bug_numbers:
- 1628029
- 1623745
- 1636729
- 1642267
expiry_version: never
notification_emails: ["loines@mozilla.com", "passwords-dev@mozilla.org", "jaws@mozilla.com"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: [main, content]
mgmt_interaction:
description: >
These events record interactions on the about:logins page.
extra_keys:
breached: >
Whether the login is marked as breached or not. If a login is both breached and vulnerable, it will only be reported as breached.
vulnerable: >
Whether the login is marked as vulnerable or not. If a login is both breached and vulnerable, it will only be reported as breached.
sort_key: The key that is used for sorting the login-list. Should only be set with the "sort" method.
objects: [
"existing_login",
"list",
"new_login",
"password",
"username",
]
methods: [
"cancel",
"copy",
"delete",
"dismiss_breach_alert",
"edit",
"filter",
"hide",
"learn_more_breach",
"learn_more_vuln",
"new",
"open_site",
"save",
"select",
"show",
"sort",
]
bug_numbers:
- 1548463
- 1600958
- 1549115
- 1628165
expiry_version: never
notification_emails: ["loines@mozilla.com", "passwords-dev@mozilla.org", "jaws@mozilla.com"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: [content]
autocomplete_field:
objects: ["generatedpassword"]
methods: ["autocomplete_field", "autocomplete_shown"]
description: >
"autocomplete_field": The first time each unique generated password is used to fill a login field - i.e. the user selects it from from the autocomplete dropdown on a password input
"autocomplete_shown": The first time the password generation option is shown in the autocomplete dropdown on a password input for a site per session
bug_numbers: [1548878, 1616356]
notification_emails: ["loines@mozilla.com", "passwords-dev@mozilla.org", "sfoster@mozilla.com"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
release_channel_collection: opt-out
expiry_version: never
filled_field_edited:
objects: ["generatedpassword"]
methods: ["filled_field_edited"]
description: >
The first time each generated password filled in a website form field is edited by the user in a field it was filled in
bug_numbers: [1548880]
notification_emails: ["loines@mozilla.com", "passwords-dev@mozilla.org"]
products:
- "firefox"
- "thunderbird"
record_in_processes: ["main"]
release_channel_collection: opt-out
expiry_version: never
saved_login_used:
objects: ["form_login", "form_password", "auth_login", "prompt_login"]
description: >
Each time a saved login is used in a form or authentication dialog.
bug_numbers: [1631130]
notification_emails: ["loines@mozilla.com", "passwords-dev@mozilla.org"]
products:
- "firefox"
record_in_processes: ["main"]
release_channel_collection: opt-out
expiry_version: never
extra_keys:
filled: Whether the browser filled the login details for the user vs. typing saved values.
mgmt_menu_item_used:
description: >
Record interactions with the about:logins menu.
objects: [
"import_from_browser",
"import_from_csv",
"import_csv_complete",
"export",
"export_complete",
"preferences",
]
bug_numbers: [1641396, 1641777, 1641393]
expiry_version: never
notification_emails: ["loines@mozilla.com", "passwords-dev@mozilla.org"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: [content, main]
doorhanger_submitted:
description: >
A login is saved or updated via the capture doorhanger. Carries information about whether
the username and password _that were saved/updated by the user_ were modified in the
doorhanger, selected from the suggestion autocomplete, or neither. `did_edit_X` and
`did_select_X` will never both be true in the same event.
The `object` describes the type of doorhanger when it was originally created. Note that user
updates to the doorhanger may change whether a login is actually saved or updated, but will
not impact the sent object.
objects: ["save", "update"]
bug_numbers: [1650929, 1650941, 1678200, 1714252, 1754637, 1850872]
expiry_version: "142"
release_channel_collection: opt-out
products: ["firefox"]
record_in_processes: [main]
notification_emails: ["passwords-dev@mozilla.org"]
extra_keys:
did_edit_un: >
Whether or not the saved/updated username was modified by the user typing into the
username field.
did_select_un: >
Whether or not the saved/updated username was selected by the user choosing a suggested
value from the autocomplete popup.
did_edit_pw: >
Whether or not the saved/updated password was modified by the user typing into the
password field.
did_select_pw: >
Whether or not the saved/updated password was selected by the user choosing a suggested
value from the autocomplete popup.
# Record telemetry based on individual Firefox relay UI (autocomplete popup, notification panel)
relay_integration:
popup_option:
description: >
Firefox relay integration autocomplete popup
objects: ["offer_relay", "fill_username"]
methods: ["shown", "clicked"]
bug_numbers: [1804502]
expiry_version: "never"
products: ["firefox"]
record_in_processes: [main]
notification_emails: ["passwords-dev@mozilla.org"]
extra_keys:
scenario: Describes the auth context for now only SignupForm is supported
error_code: >
The error code after users click the fill username autocomplete entry.
Only present if the object is "fill_username".
When the event is successful, the error_code is 0.
is_relay_user: >
Whether the user is a relay user or not.
Only present if the object is "offer_relay"
release_channel_collection: opt-out
mask_panel:
description: >
Panels to show the state of the email alias generation
objects: ["reuse_panel"]
methods: ["shown", "get_unlimited_masks", "reuse_mask"]
bug_numbers: [1804502]
expiry_version: "never"
products: ["firefox"]
record_in_processes: [main]
notification_emails: ["passwords-dev@mozilla.org"]
extra_keys:
error_code: >
The error code after users click the email alias generation panel.
When the event is successful, the error_code is 0.
release_channel_collection: opt-out
opt_in_panel:
description: >
Panel to opt-in Firefox Relay Integration
objects: ["opt_in_panel"]
methods: ["shown", "enabled", "postponed", "disabled"]
bug_numbers: [1804502]
expiry_version: "never"
products: ["firefox"]
record_in_processes: [main]
notification_emails: ["passwords-dev@mozilla.org"]
release_channel_collection: opt-out
pref_change:
description: >
Checkbox in the settings page to enable/disable relay
objects: ["pref_change"]
methods: ["enabled", "disabled"]
bug_numbers: [1804502]
expiry_version: "never"
products: ["firefox"]
record_in_processes: [main]
notification_emails: ["passwords-dev@mozilla.org"]
release_channel_collection: opt-out
jsonfile:
load:
description: >
Records when JSONFile.sys.mjs consumers are trying to access a missing or corrupt json file.
For example, Login Store trying to access logins.json when it has gone missing or corrupt.
# Keep synchronized with TELEMETRY_BASENAMES from JSONFile.sys.mjs.
objects: ["logins", "autofillprofiles"]
bug_numbers: [1599567]
expiry_version: never
products: ["firefox"]
record_in_processes: [main]
notification_emails: ["prathiksha@mozilla.com", "passwords-dev@mozilla.org"]
fxa:
connect:
objects: ["account"]
methods: ["connect", "disconnect"]
description: >
Records when a Firefox Account, or a Firefox Account service, is explicitly
connected or disconnected from the browser via an intentional user action.
extra_keys:
fxa: Whether the account itself was connected or disconnected.
sync: Whether sync was connected or disconnected.
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
bug_numbers: [1595954]
notification_emails: ["sync-dev@mozilla.org"]
release_channel_collection: opt-out
expiry_version: never
fxa_avatar_menu:
click:
objects: [
"account_settings",
"cad",
"login",
"send_tab",
"sync_now",
"sync_settings",
"sync_tabs",
"sync_tabs_sidebar",
"toolbar_icon",
"unver_sync_settings",
"open_monitor",
"open_send",
"monitor_cta",
"relay_cta",
"vpn_cta",
"sync_cta"
]
methods: ["click"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: ["main"]
description: This is recorded on interactions with the FxA avatar menu on the toolbar
bug_numbers: [1524665, 1585459, 1606203]
notification_emails: ["vbudhram@mozilla.com", "loines@mozilla.com"]
expiry_version: "never"
extra_keys:
fxa_status: >
The current state of the user. Possible states are "not_configured", "unverified",
"signedin" and "login_failed".
fxa_avatar: Boolean for whether or not account has set an avatar
fxa_app_menu:
click:
objects: [
"account_settings",
"cad",
"login",
"send_tab",
"sync_now",
"sync_settings",
"sync_tabs",
"sync_tabs_sidebar",
"toolbar_icon",
"unver_sync_settings",
"open_monitor",
"open_send",
"monitor_cta",
"relay_cta",
"vpn_cta",
"sync_cta"
]
methods: ["click"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: ["main"]
description: This is recorded on interactions with the FxA menu in the app (hamburger) menu
bug_numbers: [1542334, 1606203]
notification_emails: ["vbudhram@mozilla.com", "loines@mozilla.com"]
expiry_version: "never"
extra_keys:
fxa_status: >
The current state of the user. Possible states are "not_configured", "unverified",
"signedin" and "login_failed".
fxa_avatar: Boolean for whether or not account has set an avatar
messaging_experiments:
reach:
objects: [
"cfr",
"moments_page",
"infobar",
"spotlight",
"featureCallout",
"fxms_bmb_button",
"fxms_message_1",
"fxms_message_2",
"fxms_message_3",
"fxms_message_4",
"fxms_message_5",
"fxms_message_6",
"fxms_message_7",
"fxms_message_8",
"fxms_message_9",
"fxms_message_10",
"fxms_message_11"
]
methods: ["reach"]
release_channel_collection: opt-out
products:
- "firefox"
record_in_processes: ["main"]
description: >
This records whether a branch's targeting is satisfied for Messaging System
experiments. All qualified branch ID(s) will be recorded in the 'extra_keys'
for each active experiment, and the event 'value' will be the experiment ID
bug_numbers: [1471318]
notification_emails: ["ujet@mozilla.com"]
expiry_version: "never"
extra_keys:
branches: >
A semicolon separated string for all the qualified branch ID(s).
e.g. "control;variant_01;treatment_02".
targeting:
objects:
- attribute_error
- attribute_timeout
methods:
- targeting
extra_keys:
source: "Source of targeting expression: experiment slug or message id"
release_channel_collection: opt-out
products:
- firefox
record_in_processes:
- main
description: >
Record generic JEXL errors that result from issues with experiment or
message targeting expressions. The value field contains the namespace and
attribute name that caused the error.
bug_numbers:
- 1644743
notification_emails:
- ujet@mozilla.com
expiry_version: never
# This category contains event entries used for Telemetry tests.
# They will not be sent out with any pings.
telemetry.test:
test:
methods: ["test1", "test2"]
objects: ["object1", "object2"]
bug_numbers: [1286606]
notification_emails: ["telemetry-client-dev@mozilla.com"]
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main"]
description: This is a test entry for Telemetry.
expiry_version: never
extra_keys:
key1: This is just a test description.
key2: This is another test description.
optout:
objects: ["object1", "object2"]
bug_numbers: [1286606]
notification_emails: ["telemetry-client-dev@mozilla.com"]
release_channel_collection: opt-out
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main"]
description: This is an opt-out test entry.
expiry_version: never
extra_keys:
key1: This is just a test description.
expired_version:
objects: ["object1", "object2"]
bug_numbers: [1286606]
notification_emails: ["telemetry-client-dev@mozilla.com"]
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main"]
description: This is a test entry with an expired version.
expiry_version: "3"
not_expired_optout:
objects: ["object1"]
bug_numbers: [1286606, 1685406]
notification_emails: ["telemetry-client-dev@mozilla.com"]
description: This is an opt-out test entry with unexpired date and version.
release_channel_collection: opt-out
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main", "content"]
expiry_version: "999"
main_only:
objects: ["object1"]
bug_numbers: [1313326]
notification_emails: ["telemetry-client-dev@mozilla.com"]
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main"]
description: This event is used to test main-process only recording.
expiry_version: never
content_only:
objects: ["object1"]
bug_numbers: [1313326]
notification_emails: ["telemetry-client-dev@mozilla.com"]
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["content"]
description: This event is used to test content-process only recording.
expiry_version: never
extra_keys:
foo: This is just a test description.
bar: And this is another test description.
main_and_content:
objects: ["object1"]
bug_numbers: [1313326]
notification_emails: ["telemetry-client-dev@mozilla.com"]
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main", "content"]
description: This event is used to test main and content process recording.
expiry_version: never
default_products:
objects: ["object1"]
bug_numbers: [1452552]
notification_emails: ["telemetry-client-dev@mozilla.com"]
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main"]
description: This event is used to test default products main recording.
expiry_version: never
desktop_only:
objects: ["object1"]
bug_numbers: [1452552]
notification_emails: ["telemetry-client-dev@mozilla.com"]
record_in_processes: ["main"]
description: This event is used to test desktop-only main recording.
expiry_version: never
products: ["firefox","thunderbird"]
multiproduct:
objects: ["object1"]
bug_numbers: [1452552]
notification_emails: ["telemetry-client-dev@mozilla.com"]
record_in_processes: ["main"]
description: This event is used to test multiproduct main recording.
expiry_version: never
products: ["firefox", "fennec", "thunderbird"]
mobile_only:
objects: ["object1"]
bug_numbers: [1452552]
notification_emails: ["telemetry-client-dev@mozilla.com"]
record_in_processes: ["main"]
description: This event is used to test mobile-only main recording.
expiry_version: never
products: ["fennec"]
mirror_with_extra:
objects: ["object1"]
bug_numbers: [1685406]
notification_emails: ["glean-team@mozilla.com"]
record_in_processes: ["all"]
description: Test-only. This event is mirrored to from Glean.
expiry_version: never
extra_keys:
extra1: "This must be kept in-sync"
extra2: "With the extra_keys in the Glean metric"
products: ["firefox", "thunderbird"]
release_channel_collection: opt-out
# This is a secondary category used for Telemetry tests.
# The events here will not be sent out with any pings.
telemetry.test.second:
test:
objects: ["object1", "object2", "object3"]
bug_numbers: [1286606]
notification_emails: ["telemetry-client-dev@mozilla.com"]
products:
- "firefox"
- "fennec"
- "thunderbird"
record_in_processes: ["main"]
description: This is a test entry for Telemetry.
expiry_version: never
extra_keys:
key1: This is just a test description.
devtools.main:
activate:
objects: ["responsive_design", "split_console"]
bug_numbers: [1455273]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User activates the responsive_design or split_console in the devtools toolbox.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
host: "Toolbox host (positioning): bottom, left, right, window, page or other."
width: Toolbox width rounded up to the nearest 50px.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
add_breakpoint:
objects: ["debugger"]
bug_numbers: [1463123]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has added a breakpoint to a script.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
blackbox:
objects: ["debugger"]
bug_numbers: [1463126]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User clicked the blackbox button to blackbox a script.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
close:
objects: ["tools"]
bug_numbers: [1453312]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User closes devtools toolbox.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
host: "Toolbox host (positioning): bottom, side, window or other."
width: Toolbox width rounded up to the nearest 50px.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
close_adbg:
objects: ["aboutdebugging"]
bug_numbers: [1504173]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User closes about:debugging.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
width: Toolbox width rounded up to the nearest 50px.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
connection_attempt:
objects: ["aboutdebugging"]
bug_numbers: [1549970]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User is trying to connect to a remote runtime.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
connection_id: Randomly generated id to keep to group various events related to the same connection attempt.
connection_type: Connection type
runtime_id: Random id generated to track events related to a single runtime
status: One of (cancelled, failed, not responding, start, success).
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
continue:
objects: ["debugger"]
bug_numbers: [1463122]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has pressed the continue button on a paused script.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
deactivate:
objects: ["responsive_design", "split_console"]
bug_numbers: [1455275]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User deactivates the responsive_design or split_console in the devtools toolbox.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
host: "Toolbox host (positioning): bottom, side, window or other."
width: Toolbox width rounded up to the nearest 50px.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
device_added:
objects: ["aboutdebugging"]
bug_numbers: [1521507]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: A new device was detected in about:debugging
release_channel_collection: opt-out
expiry_version: never
extra_keys:
connection_type: Connection type
device_name: Device name
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
device_removed:
objects: ["aboutdebugging"]
bug_numbers: [1521507]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: A previously listed device was removed in about:debugging
release_channel_collection: opt-out
expiry_version: never
extra_keys:
connection_type: Connection type
device_name: Device name
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
edit_html:
objects: ["inspector"]
bug_numbers: [1463080]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User is editing HTML via the context menu item in the markup view.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
made_changes: Indicates whether changes were made.
time_open: The amount of time in ms that the HTML editor was open.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
edit_resend:
objects: ["netmonitor"]
bug_numbers: [1463171]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has executed edit / resend in the netmonitor.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The toolbox session start time e.g. 13963.
edit_rule:
objects: ["ruleview"]
bug_numbers: [1463081]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User is editing a CSS rule by clicking on or next to a CSS property, enabling / disabling a rule or creating a new property.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
enter:
objects: ["accessibility", "application", "dom", "inspector", "jsdebugger", "memory", "netmonitor", "options", "performance", "storage", "styleeditor", "webconsole", "whatsnew","other", "fakeTool4242", "testBlankPanel", "testTool", "testtool1", "testTool1072208", "testtool2"]
bug_numbers: [1441070]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User opens a tool in the devtools toolbox.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
host: "Toolbox host (positioning): bottom, side, window or other."
width: Toolbox width rounded up to the nearest 50px.
message_count: The number of cached console messages.
start_state: debuggerStatement, breakpoint, exception, tab_switch, toolbox_show, initial_panel, toggle_settings_off, toggle_settings_on, key_shortcut, select_next_key, select_prev_key, tool_unloaded, inspect_dom, unknown etc.
panel_name: The name of the panel opened or other
cold: Is this the first time the current panel has been opened in this toolbox?
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
execute_js:
objects: ["webconsole"]
bug_numbers: [1463083]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has executed some JS in the Web Console.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
input: Indicates from which input the command was evaluated ("inline" for regular input, "multiline" for editor mode).
lines: The number of lines contained in the command.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
reverse_search:
objects: ["webconsole"]
bug_numbers: [1489489]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has toggled, navigated or evaluated expressions from reverse search .
release_channel_collection: opt-out
expiry_version: never
extra_keys:
functionality: Indicates functionality of reverse search being accessed.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
exit:
objects: ["accessibility", "application", "dom", "inspector", "jsdebugger", "memory", "netmonitor", "options", "performance", "storage", "styleeditor", "webconsole", "whatsnew", "other", "fakeTool4242", "testBlankPanel", "testTool", "testtool1", "testTool1072208", "testtool2"]
bug_numbers: [1455270]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User closes a tool in the devtools toolbox.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
host: "Toolbox host (positioning): bottom, side, window or other."
width: Toolbox width rounded up to the nearest 50px.
next_panel: The name of the panel closed or other.
panel_name: The name of the panel opened or other
reason: debuggerStatement, breakpoint, exception, tab_switch, toolbox_show, initial_panel, toggle_settings_off, toggle_settings_on, key_shortcut, select_next_key, select_prev_key, tool_unloaded, inspect_dom, toolbox_closed, unknown etc.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
filters_changed:
objects: ["netmonitor", "webconsole"]
bug_numbers: [1463144, 1463095]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has changed filters in the web console.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
trigger: "The cause of the filter change: error, warn, log, info, debug, css, netxhr, net, text or reset and all, html, css, js, xhr, fonts, images, media, ws or other for netmonitor"
active: Comma separated list of active filters.
inactive: Comma separated list of inactive filters.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
inspect:
objects: ["aboutdebugging"]
bug_numbers: [1504173]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has clicked on the inspect button of one of the debug targets of aboutdebugging.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
runtime_type: The runtime type
target_type: The target type
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
jump_to_definition:
objects: ["webconsole"]
bug_numbers: [1463101]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has clicked "Jump to definition" icon (next to logged functions) in the web console.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
jump_to_source:
objects: ["webconsole"]
bug_numbers: [1463092]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has clicked a link to a source file in the web console.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
object_expanded:
objects: ["webconsole"]
bug_numbers: [1463104]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has expanded an object in the web console.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
open:
objects: ["tools"]
bug_numbers: [1416024, 1456984]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User opens devtools toolbox.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
entrypoint: How was the toolbox opened? CommandLine, ContextMenu, HamburgerMenu, KeyShortcut, SessionRestore, SystemMenu or SlowScript
first_panel: The name of the first panel opened.
host: "Toolbox host (positioning): bottom, side, window or other."
splitconsole: Indicates whether the split console was open.
width: Toolbox width rounded up to the nearest 50px.
shortcut: The key combination pressed. Used only in the case that entrypoint === KeyShortcut.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
open_adbg:
objects: ["aboutdebugging"]
bug_numbers: [1504173]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User opens about:debugging.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
width: Toolbox width rounded up to the nearest 50px.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
pause_on_exceptions:
objects: ["debugger"]
bug_numbers: [1463117]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has changed pausing behaviour in the debugger.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
exceptions: Pause on exceptions is checked.
caught_exceptio: Pause on caught exceptions is checked.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
pause:
objects: ["debugger"]
bug_numbers: [1463118]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: Debugger has paused in a script due to a breakpoint or exception.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
reason: caught-exception, uncaught-exception, pausing, debugger-statement or breakpoint.
lib_stacks: Number of collapsed callstacks in the call tree. These are call stacks that are part of external libraries e.g. react, which are collapsed by default.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
persist_changed:
objects: ["netmonitor", "webconsole"]
bug_numbers: [1531395, 1542312]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has changed log persist status.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
pretty_print:
objects: ["debugger"]
bug_numbers: [1463125]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User clicked the pretty print button to pretty print a script.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
remove_breakpoint:
objects: ["debugger"]
bug_numbers: [1463124]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has removed a breakpoint from a script.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
runtime_added:
objects: ["aboutdebugging"]
bug_numbers: [1521507]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: A new remote runtime has been detected in about:debugging
release_channel_collection: opt-out
expiry_version: never
extra_keys:
connection_type: Connection type
device_name: Name of the device on which the runtime is running (optional)
runtime_id: Random id generated to track events related to a single runtime
runtime_name: Name of the runtime
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
runtime_connected:
objects: ["aboutdebugging"]
bug_numbers: [1521507, 1530997]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: Connection was established with a remote runtime in about:debugging
release_channel_collection: opt-out
expiry_version: never
extra_keys:
connection_type: Connection type
device_name: Name of the device on which the runtime is running (optional)
runtime_id: Random id generated to track events related to a single runtime
runtime_name: Name of the runtime
runtime_os: Operating system on which the runtime is running (eg Android or Linux)
runtime_version: Version of the runtime (eg 67.0a1)
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
runtime_disconnected:
objects: ["aboutdebugging"]
bug_numbers: [1521507]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: Connection was lost with a remote runtime in about debugging
release_channel_collection: opt-out
expiry_version: never
extra_keys:
connection_type: Connection type
device_name: Name of the device on which the runtime is running (optional)
runtime_id: Random id generated to track events related to a single runtime
runtime_name: Name of the runtime
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
runtime_removed:
objects: ["aboutdebugging"]
bug_numbers: [1521507]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: A previously listed runtime was removed in about:debugging
release_channel_collection: opt-out
expiry_version: never
extra_keys:
connection_type: Connection type
device_name: Name of the device on which the runtime is running (optional)
runtime_id: Random id generated to track events related to a single runtime
runtime_name: Name of the runtime
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
select_page:
objects: ["aboutdebugging", "application"]
bug_numbers: [1504173, 1643253]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User navigates to a new page of an application such as about:debugging
release_channel_collection: opt-out
expiry_version: never
extra_keys:
page_type: Type of page the user navigates to (this-firefox, connect, runtime)
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
show_profiler:
objects: ["aboutdebugging"]
bug_numbers: [1521511]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has clicked on the "Open Profiler" button in a runtime page of about:debugging
release_channel_collection: opt-out
expiry_version: never
extra_keys:
runtime_id: Random id generated to track events related to a single runtime
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
select_ws_frame:
objects: ["netmonitor"]
bug_numbers: [1555638]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has selected a WebSocket frame.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
sidepanel_changed:
objects: ["inspector", "netmonitor"]
bug_numbers: [1463083, 1463169]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has switched sidepanel tabs.
release_channel_collection: opt-out
expiry_version: never
extra_keys:
oldpanel: The panel the user is switching from
newpanel: The panel the user is switching to
os: The OS name and version e.g. "Linux 4.4.0-1014-aws", "Darwin 14.5.0", "Windows_NT 6.1.7601" or "Windows_NT 10.0.15063." This can be used to make sense of data when a feature is only available from a particular operating system build number.
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
start_worker:
objects: ["application"]
bug_numbers: [1643253]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
record_in_processes: ["main"]
description: User manually starts a service worker
release_channel_collection: opt-out
expiry_version: never
extra_keys:
session_id: The start time of the session in milliseconds since epoch (Unix Timestamp) e.g. 1396381378123.
throttle_changed:
objects: ["netmonitor"]
bug_numbers: [1463147]
notification_emails: ["dev-developer-tools@lists.mozilla.org"]
products:
- "firefox"
- "fennec"
record_in_processes: ["main"]
description: User has changed the throttle setting in the netmonitor.
release_channel_collection: opt-out
expiry_version: never