Adding upstream version 115.8.0esr.upstream/115.8.0esr

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 4076 insertions, 0 deletions

diff --git a/toolkit/components/telemetry/Events.yaml b/toolkit/components/telemetry/Events.yaml
new file mode 100644
index 0000000000..6e4305b2f3
--- /dev/null
+++ b/toolkit/components/telemetry/Events.yaml
@@ -0,0 +1,4076 @@
+# 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
+# file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+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",
+      "MIGRATION_CANCEL",
+      "MIGRATION_START",
+      "OPEN_NEWTAB_PREFS",
+      "OPEN_NEW_WINDOW",
+      "OPEN_PRIVATE_WINDOW",
+      "PIN",
+      "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]
+    notification_emails:
+      - "dmosedale@mozilla.com"
+      - "barret@mozilla.com"
+      - "omc@mozilla.com"
+    expiry_version: "118"
+    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"
+  pocket_cta:
+    objects: ["close_cta", "sign_up_click", "rec_click", "minimize_recs_click", "cta_seen", "rec_saved"]
+    release_channel_collection: opt-out
+    record_in_processes: ["content"]
+    description: >
+      Reader Mode Pocket CTA events
+    bug_numbers: [1726395]
+    notification_emails:
+      - "kirill@getpocket.com"
+      - "sdowne@getpocket.com"
+    expiry_version: never
+    extra_keys:
+      logged_in: Pocket user login status.
+    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", "disco", "distribution",
+        "extension", "enterprise-policy", "file-url", "geckoview-app", "gmp-plugin",
+        "internal", "plugin", "rtamo", "siteperm-addon-provider" "sync", "system-addon",
+        "temporary-addon", "unknown".
+        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", "synthetic-install", "url", "product-updates".
+      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: "122"
+    products:
+      - "firefox"
+      - "fennec"
+      - "thunderbird"
+    record_in_processes: ["main"]
+    bug_numbers: [1433335, 1515697, 1523641, 1549770, 1590736, 1630596, 1672570, 1714251, 1749878, 1781974, 1817100]
+    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
+    notification_emails: ["addons-dev-internal@mozilla.com"]
+    expiry_version: "122"
+    products:
+      - "firefox"
+      - "fennec"
+      - "thunderbird"
+    record_in_processes: ["main"]
+    bug_numbers: [1433335, 1515697, 1523641, 1549770, 1590736, 1630596, 1672570, 1714251, 1749878, 1781974, 1817100]
+    release_channel_collection: opt-out
+  report:
+    description: >
+      An abuse report submitted by a user for a given extension. The object of the event
+      represent the report entry point, the value is the id of the addon being reported.
+    objects:
+      - amo
+      - menu
+      - toolbar_context_menu
+      - unified_context_menu
+      - uninstall
+    extra_keys:
+      addon_type: >
+        The type of the add-on being reported (missing on ERROR_ADDON_NOT_FOUND, ERROR_AMODETAILS_NOTFOUND
+        and ERROR_AMODETAILS_FAILURE).
+      error_type: >
+        AbuseReport Error Type (included in case of submission failures). The error types include
+        ERROR_ABORTED_SUBMIT, ERROR_ADDON_NOT_FOUND, ERROR_CLIENT, ERROR_NETWORK, ERROR_UNKNOWN,
+        ERROR_RECENT_SUBMIT, ERROR_SERVER, ERROR_AMODETAILS_NOTFOUND, ERROR_AMODETAILS_FAILURE.
+    notification_emails: ["addons-dev-internal@mozilla.com"]
+    expiry_version: "122"
+    products:
+      - "firefox"
+      - "fennec"
+      - "thunderbird"
+    record_in_processes: ["main"]
+    bug_numbers: [1544927, 1580561, 1590736, 1630596, 1672570, 1714251, 1749878, 1780746, 1781974, 1817100]
+    release_channel_collection: opt-out
+  reportSuspiciousSite:
+    description: >
+      Sent when a user clicks "Report Suspicious Site" on the dropdown menu of the third-
+      party xpinstall doorhanger. The object is always suspiciousSite. The value is the
+      site domain, or "(unknown)" if there is no site associated with the prompt.
+    objects:
+      - suspiciousSite
+    notification_emails: ["addons-dev-internal@mozilla.com"]
+    expiry_version: "122"
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    bug_numbers: [1806056, 1817100]
+    release_channel_collection: opt-out
+
+blocklist:
+  addonBlockChange:
+    description: >
+      An add-on is blocked, or an installed add-on is unblocked.
+      When an add-on install/update is blocked, its installation is aborted and the
+      add-on is no longer listed in the activeAddons field of TelemetryEnvironment.
+      The value is the ID of the add-on.
+      The object represents the reason for triggering the blocklistState check:
+      "addon_install" is when an add-on is installed.
+      "addon_update" is when an add-on is updated after an update check.
+      "addon_update_check" is when an add-on is blocked during the update check.
+      "addon_db_modified" is when an add-on's blocklistState was altered between application restarts.
+      "blocklist_update" is when an add-on's blocklistState changed due to a blocklist update. This
+      may be due to the blocklist being disabled by preferences or enterprise policies, but it is
+      more commonly the result of updating entries in the blocklist.
+    objects: ["addon_install", "addon_update", "addon_update_check", "addon_db_modified", "blocklist_update"]
+    extra_keys:
+      blocklistState: >
+        The blocklistState of the add-on. 0 is unblocked, 2 is blocked.
+        1 is soft blocked (only if blocklist v3 was disabled in favor of v2).
+      addon_version: >
+        Version of the add-on. Used together with an add-on's ID (value) to identify
+        add-ons to block.
+      signed_date: >
+        Timestamp of the add-on (when it was signed via AMO).
+        This field is missing (0) for "addon_update_check".
+      hours_since: >
+        The number of hours that have passed since this version of the add-on was installed or updated.
+        At least zero when the blocklist is updated, -1 otherwise.
+      mlbf_last_time: >
+        The generation time of the most recent entry in the blocklist.
+        Time generated by AMO when the blocklist entry was created.
+        May be 0 when the blocklist is disabled.
+      mlbf_generation: >
+        The generation time to identify the bloomfilter that was used for this blocklist decision.
+        The bloomfilter is updated less frequently than the so-called stashes in the RemoteSettings
+        collection that holds the blocklist data. The stashes take precedence over the bloomfilter
+        in blocklist decisions.
+        Time generated by AMO when the blocklist entry was created.
+        May be 0 when the blocklist is disabled.
+      mlbf_source: >
+        The source of the RemoteSettings attachment that holds the bloom filter.
+        This field is documented in more detail in the definition of the blocklist.mlbf_source scalar.
+        Possible values are "dump_match", "cache_match", "remote_match", "dump_fallback", "cache_fallback", "unknown".
+    notification_emails: ["addons-dev-internal@mozilla.com", "rwu@mozilla.com"]
+    expiry_version: "122"
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    bug_numbers: [1662857, 1730037, 1763529, 1811159]
+    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 "View Saved Logins" 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"
+    methods:
+      - "show"
+      - "save"
+      - "update"
+      - "cancel"
+      - "disable"
+      - "pref"
+    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: ["content"]
+    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: ["content"]
+    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:
+    description: >-
+      User interactions for credit card autofill forms
+    objects:
+      - "cc_form"
+    methods:
+      - "detected"
+      - "popup_shown"
+      - "filled"
+      - "filled_modified"
+      - "submitted"
+    bug_numbers: [1653073, 1653162, 1720608, 1767907]
+    notification_emails: ["autofill@lists.mozilla.org", "passwords-dev@mozilla.org"]
+    expiry_version: never
+    products:
+      - "firefox"
+    record_in_processes: ["content"]
+    release_channel_collection: opt-out
+    extra_keys:
+      cc_name_found: Whether the cardholder name field was identified
+      cc_number_found: Whether the credit card number field was identified
+      cc_exp_found: Whether the expiration date was identified
+      cc_name: Whether the name was autofilled (autofilled / not_filled / user_filled / unavailable)
+      cc_number: Whether the credit card number field was autofilled (autofilled / not_filled / user_filled / unavailable)
+      cc_exp: Whether the expiration date was autofilled (autofilled / not_filled / user_filled / unavailable)
+      field_name: Name of the field being affected by the method
+      fields_not_auto: >-
+        Number of fields in a `submitted` event that were not autofilled.
+        Note that this number counts all fields in a form, even if some of those fields might have been identified as password and/or address fields.
+        Additionally, it may include input elements that are not rendered as user-modifiable, such as hidden fields as well as <button> elements.
+      fields_auto: Number of fields in the `submitted` event that were autofilled
+      fields_modified: Number of fields in a `submitted` event that were autofilled and later modified
+  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: ["content"]
+    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.
+
+extensions.data:
+  migrateResult:
+    objects: ["storageLocal"]
+    bug_numbers: [1470213, 1553297, 1590736, 1630596, 1672570, 1714251, 1749878, 1781974, 1817100]
+    notification_emails: ["addons-dev-internal@mozilla.com"]
+    expiry_version: "122"
+    products:
+      - "firefox"
+      - "fennec"
+    record_in_processes: ["main"]
+    release_channel_collection: opt-out
+    extra_keys:
+      backend: The selected backend ("JSONFile" / "IndexedDB").
+      data_migrated: The old extension data has been migrated ("y" / "n").
+      error_name: >
+        A DOMException error name if any ("OtherError" for unknown errors).
+        The error has been fatal if the `backend` extra key is "JSONFile",
+        otherwise it is a non fatal error which didn't prevented the
+        extension from switching to the IndexedDB backend.
+      has_jsonfile: The extension has a JSONFile ("y" / "n").
+      has_olddata: The extension had some data stored in the JSONFile ("y" / "n").
+    description: >
+      These events are sent when an extension is migrating its data to the new IndexedDB backend,
+      the value of this event is the addon id.
+  storageLocalError:
+    objects: ["get", "set", "remove", "clear"]
+    bug_numbers: [1606903, 1649948, 1689255, 1730038, 1763523, 1811148]
+    notification_emails: ["addons-dev-internal@mozilla.com"]
+    expiry_version: "122"
+    products:
+      - "firefox"
+    record_in_processes: ["main", "content"]
+    release_channel_collection: opt-out
+    extra_keys:
+      error_name: >
+        A DOMException error name if any ("OtherError" for unknown errors).
+    description: >
+      These events are collected when an extension triggers an unexpected error
+      while running a storage.local API call (e.g. because of some underlying
+      QuotaManager and/or IndexedDB error), the value of this event is the
+      addon id.
+
+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.
+
+navigation:
+  search:
+    objects: ["about_home", "about_newtab", "contextmenu", "oneoff",
+              "suggestion", "alias", "enter", "searchbar", "urlbar",
+              "urlbar_handoff", "urlbar_persisted", "urlbar_searchmode",
+              "webextension"]
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+      - "fennec"
+    record_in_processes: ["main"]
+    description: >
+      This is recorded on each search navigation.
+      The value field records the action used to trigger the search:
+        "enter", "oneoff", "suggestion", "alias", null (for contextmenu and webextension)
+    bug_numbers: [1316281, 1496764]
+    notification_emails:
+      - "mdeboer@mozilla.com"
+      - "rharter@mozilla.com"
+    expiry_version: never
+    extra_keys:
+      engine: The id of the search engine used.
+
+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
+
+urlbar:
+  engagement:
+    objects: ["click", "enter", "paste_go", "drop_go"]
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    description: >
+      This is recorded on urlbar engagement, that is when the user picks a
+      search result.
+      The value field records the initial interaction type. One of:
+        "typed", "dropped", "pasted", "topsites"
+    bug_numbers: [1559136, 1671404]
+    notification_emails:
+      - "fx-search-telemetry@mozilla.com"
+    expiry_version: never
+    extra_keys:
+      elapsed: engagement time in milliseconds.
+      numChars: number of input characters.
+      numWords: number of words in the input.
+      selIndex: index of the selected result in the urlbar panel, or -1.
+      selType: >
+        type of the selected result in the urlbar panel. One of:
+          "autofill", "visit", "bookmark", "history", "keyword", "search",
+          "searchsuggestion", "searchsuggestion_rich", "switchtab",
+          "remotetab", "extension", "oneoff", "keywordoffer", "canonized",
+          "tip", "tiphelp", "formhistory", "tabtosearch", "quicksuggest",
+          "weather", "dynamic-wikipedia", "navigational", "none"
+      provider: The name of the provider that presented the result.
+  abandonment:
+    objects: ["blur"]
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    description: >
+      This is recorded on urlbar search abandon, that is when the user starts
+      an interaction but then blurs the urlbar.
+      The value field records the initial interaction type. One of:
+        "typed", "dropped", "pasted", "topsites"
+    bug_numbers: [1559136]
+    notification_emails:
+      - "fx-search-telemetry@mozilla.com"
+    expiry_version: never
+    extra_keys:
+      elapsed: abandonement time in milliseconds.
+      numChars: number of input characters.
+      numWords: number of words in the input.
+
+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.
+      enrollmentId: A unique ID for this enrollment that will be included in all related Telemetry.
+    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, the preference that was detected to change that caused the unenrollment.
+    bug_numbers: [1443560]
+    notification_emails: ["normandy-notifications@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: ["barret@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: ["legacy_wizard", "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: ["legacy_wizard", "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: ["legacy_wizard", "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: ["legacy_wizard", "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: ["legacy_wizard", "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.
+      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.
+  safari_perms:
+    objects: ["legacy_wizard", "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: ["legacy_wizard", "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.
+      other: A count of the number of other resource types that are being migrated.
+  migration_finished:
+    objects: ["legacy_wizard", "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.
+      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]
+    expiry_version: "120"
+    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"
+  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.
+  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"]
+  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"]
+
+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"
+      ]
+    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"
+      ]
+    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"
+    ]
+    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
+  feature_callout:
+    objects:
+      - create_failed
+    methods:
+      - feature_callout
+    release_channel_collection: opt-out
+    products:
+      - firefox
+    record_in_processes:
+      - main
+    description: >
+      Record errors when the feature callout surface is unable to be
+      created due to a missing parent element. The value field contains a
+      concatenation of the Message ID and the parent selector.
+    bug_numbers:
+      - 1788996
+    notification_emails:
+      - omc@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
+    extra_keys:
+      mode: No throttling, GPRS, Regular 2G, Good 2G, Regular 3G, Good 3G, Regular 4G / LTE, DSL or WI-FI.
+      session_id: The toolbox session start time e.g. 13963.
+  tool_timer:
+    objects: ["animationinspector", "compatibilityview", "computedview", "changesview", "fontinspector", "layoutview", "ruleview"]
+    bug_numbers: [1483817, 1639454]
+    notification_emails: ["dev-developer-tools@lists.mozilla.org"]
+    products:
+      - "firefox"
+      - "fennec"
+    record_in_processes: ["main"]
+    description: The amount of time a tool was opened for.
+    release_channel_collection: opt-out
+    expiry_version: never
+    extra_keys:
+      time_open: Time open.
+      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.
+  unregister_worker:
+    objects: ["application"]
+    bug_numbers: [1643253]
+    notification_emails: ["dev-developer-tools@lists.mozilla.org"]
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    description: User manually unregisters a service worker registration
+    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.
+  update_conn_prompt:
+    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 "Enable/Disable connection prompt" button in a runtime page of about:debugging
+    release_channel_collection: opt-out
+    expiry_version: never
+    extra_keys:
+      prompt_enabled: True if the user enables the prompt, false otherwise.
+      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.
+
+security.ui.protections:
+  show:
+    objects: [
+      "protection_report",
+      "vpn_banner",
+    ]
+    bug_numbers:
+      - 1557050
+      - 1610897
+      - 1643428
+      - 1650468
+      - 1661756
+      - 1678201
+      - 1739287
+      - 1787249
+    description: >
+      User arrived on the protection report. This also includes a 'value' attribute which defaults to 'direct' or will be the value that a referring website addds to the url. This also indicates if the vpn banner has been seen.
+    expiry_version: never
+    record_in_processes: ["content"]
+    release_channel_collection: opt-out
+    notification_emails:
+      - pbz@mozilla.com
+      - seceng-telemetry@mozilla.com
+    products:
+      - firefox
+    extra_keys:
+      category: The category of protections the user is in, standard, strict or custom.
+  close:
+    objects: [
+      "protection_report",
+    ]
+    bug_numbers:
+      - 1557050
+      - 1610897
+      - 1612091
+      - 1643428
+      - 1678201
+      - 1739287
+      - 1787249
+    description: >
+      User closed on the protection report.
+    expiry_version: never
+    record_in_processes: ["content"]
+    release_channel_collection: opt-out
+    notification_emails:
+      - pbz@mozilla.com
+      - seceng-telemetry@mozilla.com
+    products:
+      - firefox
+    extra_keys:
+      category: The category of protections the user is in, standard, strict or custom.
+  click:
+    bug_numbers:
+      - 1557050
+      - 1572825
+      - 1610897
+      - 1612088
+      - 1612091
+      - 1637615
+      - 1643428
+      - 1661756
+      - 1678201
+      - 1739287
+      - 1787249
+    description: >
+      User interaction by click events on the protection report.
+    objects: [
+      "lw_open_button",
+      "lw_sync_link",
+      "lw_about_link",
+      "mtr_about_link",
+      "mtr_report_link",
+      "mtr_signup_button",
+      "trackers_about_link",
+      "mobile_app_link",
+      "settings_link",
+      "vpn_banner_link",
+      "vpn_banner_close",
+      "vpn_card_link",
+      "vpn_app_link_android",
+      "vpn_app_link_ios",
+    ]
+    expiry_version: never
+    record_in_processes: ["content"]
+    release_channel_collection: opt-out
+    notification_emails:
+      - pbz@mozilla.com
+      - seceng-telemetry@mozilla.com
+    products:
+      - firefox
+    extra_keys:
+      category: The category of protections the user is in, standard, strict or custom.
+
+security.ui.app_menu:
+  click:
+    bug_numbers:
+      - 1603545
+      - 1616229
+      - 1643428
+      - 1678201
+      - 1739287
+      - 1787249
+    description: >
+      Privacy and Security click events on app menu.
+    objects: [
+      "open_full_report",
+    ]
+    expiry_version: never
+    record_in_processes:
+      - main
+    release_channel_collection: opt-out
+    notification_emails:
+      - pbz@mozilla.com
+      - seceng-telemetry@mozilla.com
+    products:
+      - firefox
+
+security.ui.protectionspopup:
+  open:
+    objects: ["protections_popup"]
+    bug_numbers:
+      - 1560327
+      - 1607488
+      - 1643428
+      - 1678201
+      - 1739287
+      - 1787249
+    description: >
+      How many times the protections panel was opened.
+    expiry_version: never
+    notification_emails:
+      - pbz@mozilla.com
+      - seceng-telemetry@mozilla.com
+    release_channel_collection: opt-out
+    record_in_processes:
+      - main
+    products:
+      - firefox
+  click:
+    objects: [
+      "etp_toggle_on",
+      "etp_toggle_off",
+      "sitenotworking_link",
+      "send_report_link",
+      "send_report_submit",
+      "social",
+      "cookies",
+      "trackers",
+      "fingerprinters",
+      "cryptominers",
+      "subview_settings",
+      "settings",
+      "full_report",
+      "milestone_message",
+      "cookieb_toggle_on",
+      "cookieb_toggle_off",
+    ]
+    bug_numbers:
+      - 1560327
+      - 1602015
+      - 1607488
+      - 1643428
+      - 1678201
+      - 1739287
+      - 1787249
+      - 1798669
+    description: >
+      User interaction by click events in the protections panel.
+    expiry_version: never
+    notification_emails:
+      - pbz@mozilla.com
+      - tihuang@mozilla.com
+      - seceng-telemetry@mozilla.com
+    release_channel_collection: opt-out
+    record_in_processes:
+      - main
+    products:
+      - firefox
+
+uptake.remotecontent.result:
+  uptake:
+    description: >
+      Was the remote content successfully pulled?
+      This uptake telemetry allows to monitor the behaviour of our clients when it comes
+      to fetching data from remote servers. This helps defect-detection and allow observation of
+      the proportion of success among clients and sources, the distribution of error causes, and
+      its evolution over time.
+    methods:
+      - uptake
+    objects:
+      - remotesettings
+      - normandy
+    extra_keys:
+      source: >
+        A label to distinguish what is being pulled or updated in the component (eg. recipe id,
+        settings collection name, ...).
+      trigger: >
+        A label to distinguish what triggered the polling/fetching of remote content (eg. "broadcast",
+        "timer", "forced", "manual")
+      age: >
+        The age of pulled data in seconds (ie. difference between publication time and fetch time).
+      duration: >
+        The duration of the synchronization process in milliseconds.
+      timestamp: >
+        The current timestamp, received during synchronization.
+      errorName: >
+        An optional string with the error name attribute in case of failure.
+    bug_numbers:
+      - 1517469
+      - 1617133
+    products:
+      - "firefox"
+      - "fennec"
+      - "thunderbird"
+    record_in_processes: ["main"]
+    release_channel_collection: opt-out
+    expiry_version: never
+    notification_emails:
+      - mleplatre@mozilla.com
+      - bens-directs@mozilla.com
+
+intl.ui.browserLanguage:
+  action:
+    description: >
+      User interactions for the browser language within about-preferences in the main pane and in
+      the browser language dialog. Each dialog event (on the dialog object, and the manage and
+      search methods of the main object) has a value which is a monotonically increasing number
+      that links it with other events related to the same dialog instance.
+    objects:
+      - dialog
+      - main
+    methods:
+      - manage
+      - search
+      - add
+      - remove
+      - reorder
+      - apply
+      - accept
+      - cancel
+    extra_keys:
+      installId: The id for an install.
+    products:
+      - firefox
+    expiry_version: "122"
+    notification_emails:
+      - flod@mozilla.com
+      - mstriemer@mozilla.com
+    release_channel_collection: opt-out
+    record_in_processes: ["main"]
+    bug_numbers:
+      - 1486507
+      - 1553311
+      - 1607501
+      - 1672571
+      - 1739288
+      - 1796396
+
+network.dns:
+  trrConfirmation:
+    objects: ["context"]
+    bug_numbers:
+      - 1691408
+      - 1694949
+    description: >
+      This telemetry records the status of the TRR confirmation across.
+      The value of the event is one of:
+        "ok"
+        "trying"
+    notification_emails:
+      - vgosu@mozilla.com
+      - necko@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - firefox
+    expiry_version: "never"
+    record_in_processes: ["main", "socket"]
+    extra_keys:
+      trigger: >
+        The reason why this confirmation was triggered.
+        Values: [cp-connectivity, pref-change, context-init, retry, failed-lookups]
+      contextReason: >
+        The cause of the current confirmation context.
+        Values: [success, pref-change, network-change, shutdown]
+      attemptCount: >
+        The number of NS requests that were issued for this confirmation.
+      results: >
+        String representation of the last 32 confirmation results.
+        Example: nnnnnnttttttttt indicates a number of network (n) failures
+        followed by timeouts (t).
+      failedLookups: >
+        When the trigger is failed-lookups, this contains the string
+        representation of the failures that triggered the confirmation.
+      networkID: >
+        The network ID for the recorded confirmation attempts
+      captivePortal: >
+        One of [unknown, not_captive, unlocked, locked]
+      time: >
+        Time from first confirmation attempt to event being recorded
+
+security:
+  prefUsage:
+    objects: ["contentProcess"]
+    bug_numbers:
+      - 1782544
+      - 1708798
+    description: >
+      We block certain preferences from being sent to the content process because they contain sensitive
+      user data. Some preferences are blocked by name, others by heuristic. If one of the preferences so
+      blocked is accidently accessed we want to know about it so we can allowlist it or refactor the access.
+    notification_emails:
+      - tom@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - firefox
+    expiry_version: "never"
+    record_in_processes:
+      - all_children
+  fissionPrincipals:
+    objects: ["contentParent"]
+    bug_numbers:
+      - 1687891
+    description: >
+      When running with Fission, we received an unexpected principal from the content process.
+      Expected values for this telemetry event are the method names in ContentParent that
+      received the unexpected principal.
+    notification_emails:
+      - tom@mozilla.com
+      - ckerschb@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - firefox
+    expiry_version: "never"
+    record_in_processes:
+      - main
+    extra_keys:
+      principalType: >
+        The type of principal that was received. Expected values for this field are
+          NullPtr
+          SystemPrincipal
+          ExpandedPrincipal
+          ContentPrincipal
+          Unknown
+      scheme: If the principal is a ContentPrincipal, we also collect the scheme
+  evalUsage:
+    objects: ["systemContext", "parentProcess"]
+    bug_numbers:
+      - 1567623
+    description: >
+      eval() (or an eval()-like method) was called while running in the System Principal
+      context or the Parent Process.
+      Expected values are:
+        chromeuri - chrome:// file
+        resourceuri - resource:// file
+        datauri - a data URI
+        bloburi - a blob URI
+        abouturi - an about URI
+        singlestring - A single file or string with no slashes
+        mozillaextension - An extension claiming to be from *mozilla.org (Deprecated)
+        otherextension - Another extension not from Mozilla (Deprecated)
+        mozillaextension_file - An extension claiming to be from *mozilla.org, loaded from a file://
+        otherextension_file - Another extension not from Mozilla, loaded from a file://
+        extension_uri - A URI with the moz-extension:// scheme
+        suspectedUserChromeJS - A filepath ending in .uc.js
+        sanitizedWindowsPath - A filepath, on Windows, sanitized by WinUtils::PreparePathForTelemetry
+                               which is a bare filename or a subpath of %ProgramFiles%, %SystemRoot%,
+                               or %TEMP%
+        sanitizedWindowsURL - A partial URL, on Windows, consisting of either file://../ followed by
+                              the value prepared as for sanitizedWindowsPath, or the bare scheme of
+                              the original url
+        other - Unknown
+        other-on-worker - We cannot do a regex; it is not a chrome, resource, data, or blob uri, but
+                          could be any other.
+        regexfailure - Our Regex Matching code threw an error
+      The fileinfo key may contain additional information about the file that caused the eval()
+      depending on the above value. Resource, Chrome, About, and SingleString will contain the full value.
+      (About URIs will remove any querystring values.)
+      Extensions-from-file will contain the full value; however .xpi! will be shortened to !,
+      shield.mozilla.org! to s! and mozilla.org! to m!.  Data, Blob, UserChromeJS, Other, and
+      Regexfailure should have no value.
+    notification_emails:
+      - tom@mozilla.com
+      - ckerschb@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - firefox
+    expiry_version: "never"
+    record_in_processes:
+      - all
+    extra_keys:
+      fileinfo: Information about the file that triggered eval
+  javascriptLoad:
+    objects: ["parentProcess"]
+    bug_numbers:
+      - 1582512
+    description: >
+      The javascript engine requested to load a filename that was not allowed.
+      Expected values, and fileinfo key, are the same possible values as above in 'evalUsage'
+    notification_emails:
+      - tom@mozilla.com
+      - gijs@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - firefox
+    expiry_version: "never"
+    record_in_processes:
+      - main
+    extra_keys:
+      fileinfo: Information about the filename that was requested to be loaded
+  unexpectedload:
+    objects: ["systemprincipal"]
+    bug_numbers:
+      - 1644671
+    description: >
+      Long term want to block all loads from the system principal that cause us to parse non-trivial data.
+      We don't look to break existing functionality and will allow exceptions, for this we are collecting
+      information about unexpected requests triggered by the system principal
+      Our measurement *excludes* acceptable requests. Those are:
+      - annotated using the 'AllowedDeprecatedSystemRequests' loadinfo flag
+      - using a nsContentPolicyType of FETCH, XMLHTTPREQUEST, WEBSOCKET, SAVEAS_DOWNLOAD or IMAGE
+      - with a requested URI object has the flag URI_IS_UI_RESOURCE
+      - if the URL scheme is 'view-source'
+      - if the URL scheme is 'file' and the Content-Type is STYLESHEET or OTHER
+      - if the scheme is 'jar', 'about' or 'moz-extension'
+    notification_emails:
+      - fbraun@mozilla.com
+      - ckerschb@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - firefox
+    expiry_version: "never"
+    record_in_processes:
+      - all
+    extra_keys:
+      contenttype: Information about the content-type we expect to receive
+      remotetype: Information about the remoteType in which we triggered the load
+      filedetails: Information about the file that triggered the load
+      redirects: Comma-separated string listing schemes for URLs that we redirected from
+
+pictureinpicture:
+  create:
+    objects: ["player"]
+    description: >
+      Recorded when the Picture-in-Picture player window is created.
+    extra_keys:
+      width: The width that the window was created at
+      height: The height that the window was created at
+      screenX: The screen X coordinate that the window was created at
+      screenY: The screen Y coordinate that the window was created at
+      ccEnabled: Are subtitles enabled for PiP
+      webVTTSubtitles: Are the subtitles WebVTT
+    notification_emails:
+      - mconley@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1560590
+      - 1678202
+      - 1730039
+      - 1756703
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  resize:
+    objects: ["player"]
+    description: >
+      Recorded when the Picture-in-Picture player window is resized.
+    extra_keys:
+      width: The width that the window was resized to
+      height: The height that the window was resize to
+    notification_emails:
+      - mconley@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1560590
+      - 1678202
+      - 1730039
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  saw_toggle:
+    objects: ["toggle"]
+    description: >
+      Recorded when the Picture-in-Picture toggle is shown
+    extra_keys:
+      firstTime: If the user has used Picture-in-Picture before
+    notification_emails:
+      - mconley@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes: ["main", "content"]
+    bug_numbers:
+      - 1749585
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  opened_method:
+    objects: ["toggle", "contextMenu", "urlBar", "shortcut"]
+    description: >
+      Records the method for opening the Picture-in-Picture window.
+    extra_keys:
+      firstTimeToggle: If the user has used Picture-in-Picture before
+      disableDialog: True when urlbar button opens the disable PiP dialog
+    notification_emails:
+      - mconley@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes: ["main", "content"]
+    bug_numbers:
+      - 1749585
+      - 1834554
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  closed_method:
+    objects: ["closeButton", "unpip", "pagehide", "fullscreen", "setupFailure", "closePlayerShortcut", "contextMenu", "videoElRemove", "videoElEmptied", "urlBar", "shortcut"]
+    description: >
+      Records the method for closing the Picture-in-Picture window.
+    notification_emails:
+      - mconley@mozilla.com
+      - mtigley@mozilla.com
+      - mhowell@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - "main"
+    bug_numbers:
+      - 1756703
+      - 1834554
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  subtitles_shown:
+    objects: ["subtitles"]
+    description: >
+      Records if subtitles are shown in the Picture-in-Picture window.
+    extra_keys:
+      webVTTSubtitles: Will be true or false
+    notification_emails:
+      - mconley@mozilla.com
+      - mhowell@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - "content"
+    bug_numbers:
+      - 1772546
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  fullscreen:
+    objects: ["player"]
+    extra_keys:
+      enter: true if entering fullscreen, false if exiting fullscreen
+    description: >
+      Recorded when the user clicks the fullscreen button
+    notification_emails:
+      - mconley@mozilla.com
+      - mhowell@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - "main"
+    bug_numbers:
+      - 1822395
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  disrespect_disable:
+    objects: ["urlBar"]
+    description: >
+      Recorded when the user chooses to enable PiP anyway on a PiP disabled video
+    notification_emails:
+      - mconley@mozilla.com
+      - mhowell@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - "main"
+    bug_numbers:
+      - 1834554
+    expiry_version: "never"
+    release_channel_collection: opt-out
+
+pictureinpicture.settings:
+  enable:
+    objects: ["settings"]
+    description: Recorded when Picture-in-Picture is enabled.
+    notification_emails:
+      - mconley@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1639774
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  disable:
+    objects: ["player", "settings"]
+    description: >
+      Recorded with "settings" object when Picture-in-Picture is disabled via settings
+      Recorded with "player" object when Picture-in-Picture is disabled via PiP context menu
+    notification_emails:
+      - mconley@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1639774
+    expiry_version: "never"
+    release_channel_collection: opt-out
+
+doh:
+  evaluate_v2:
+    methods: ["evaluate_v2"]
+    objects: ["heuristics"]
+    bug_numbers:
+      - 1573840
+      - 1631609
+      - 1603779
+      - 1654714
+    description: >
+      Results of DoH heuristics at startup and after network changes.
+    expiry_version: never
+    record_in_processes:
+      - main
+    release_channel_collection: opt-out
+    notification_emails:
+      - nhnt11@mozilla.com
+      - ddamjanovic@mozilla.com
+      - seceng-telemetry@mozilla.com
+      - necko@mozilla.com
+    products:
+      - firefox
+    extra_keys:
+      canaries: Comma-separated list of canaries that were detected (canary,zscalerCanary)
+      filtering: Comma-separated list of detected parental controls/content filtering (browserParent,google,youtube)
+      enterprise: Comma-separated list of detected enterprise config (policy,modifiedRoots,thirdPartyRoots)
+      steeredProvider: Whether we detected a steering provider
+      evaluateReason: The reason for running heuristics - startup or netchange
+      networkID: An ID representing the network on which heuristics were run, unique to this client
+      captiveState: The Captive Portal Service state - unknown, not_captive, locked, or unlocked
+      platform: Comma-separated list of platform attributes that would cause split-horizon issues (vpn, proxy, nrpt)
+  evaluate:
+    methods: ["evaluate"]
+    objects: ["heuristics"]
+    bug_numbers:
+      - 1573840
+      - 1631609
+      - 1603779
+    description: >
+      Results of DoH heuristics at startup and after network changes. OLD FORMAT: here for documentation
+    expiry_version: never
+    record_in_processes:
+      - main
+    release_channel_collection: opt-out
+    notification_emails:
+      - nhnt11@mozilla.com
+      - ddamjanovic@mozilla.com
+      - seceng-telemetry@mozilla.com
+      - necko@mozilla.com
+    products:
+      - firefox
+    extra_keys:
+      google: Google safe search result
+      youtube: YouTube safe search result
+      zscalerCanary: ZScaler canary result
+      canary: Global canary result
+      modifiedRoots: Whether enterprise roots were enabled
+      browserParent: Whether OS parental controls were detected
+      thirdPartyRoots: Whether third party roots were installed
+      policy: Enterprise policy presence - no policy/with DoH/without DoH.
+      steeredProvider: Whether we detected a steering provider
+      evaluateReason: The reason for running heuristics - startup or netchange
+  state:
+    methods: ["state"]
+    objects: [
+      "enabled",
+      "disabled",
+      "manuallyDisabled",
+      "policyDisabled",
+      "uninstalled",
+      "UIOk",
+      "UIDisabled",
+      "rollback",
+      "shutdown",
+    ]
+    bug_numbers:
+      - 1573840
+      - 1631609
+      - 1603779
+    description: >
+      Results of DoH heuristics at startup and after network changes.
+    expiry_version: never
+    record_in_processes:
+      - main
+    release_channel_collection: opt-out
+    notification_emails:
+      - nhnt11@mozilla.com
+      - ddamjanovic@mozilla.com
+      - seceng-telemetry@mozilla.com
+      - necko@mozilla.com
+    products:
+      - firefox
+
+security.doh.trrPerformance:
+  resolved:
+    objects: ["record"]
+    bug_numbers:
+      - 1613790
+    description: >
+      How long it took to resolve a test domain using TRR.
+    expiry_version: never
+    record_in_processes:
+      - main
+    release_channel_collection: opt-out
+    notification_emails:
+      - nhnt11@mozilla.com
+      - ddamjanovic@mozilla.com
+      - seceng-telemetry@mozilla.com
+    products:
+      - firefox
+    extra_keys:
+      domain: The resolved domain.
+      trr: The TRR provider used.
+      time: The network time for the resolution.
+      status: The DNS status code.
+      retryCount: The number of lookup attempts before success.
+      networkUnstable: Whether there was network fluctuation while gathering the results.
+      captivePortal: Whether there a captive portal was detected during the run.
+  trrselect:
+    objects: ["dryrunresult"]
+    bug_numbers:
+      - 1631822
+    description: >
+      The URL of the DoH provider chosen by the TRR selection dry-run
+    expiry_version: never
+    record_in_processes:
+      - main
+    release_channel_collection: opt-out
+    notification_emails:
+      - nhnt11@mozilla.com
+      - ddamjanovic@mozilla.com
+      - seceng-telemetry@mozilla.com
+    products:
+      - firefox
+
+security.doh.neterror:
+  load:
+    objects: ["dohwarning"]
+    bug_numbers:
+      - 1829342
+    description: >
+      The DoH warning page is loaded.
+    expiry_version: never
+    notification_emails:
+      - necko@mozilla.com
+      - kershaw@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["content"]
+    extra_keys:
+      mode: Current TRR mode
+      provider_key: TRR provider
+      skip_reason: The reason why DoH request is failed
+  click:
+    objects: [
+      "try_again_button",
+      "add_exception_button",
+      "settings_button",
+      "continue_button",
+      "disable_warning",
+      "learn_more_link",
+    ]
+    bug_numbers:
+      - 1829342
+    description: >
+      User interaction by click buttons on the DoH warning page.
+    expiry_version: never
+    notification_emails:
+      - necko@mozilla.com
+      - kershaw@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["content"]
+    extra_keys:
+      mode: Current TRR mode
+      provider_key: TRR provider
+      skip_reason: The reason why DoH request is failed
+
+security.doh.settings:
+  mode_changed:
+    objects: ["button"]
+    bug_numbers:
+      - 1829905
+    description: >
+      User changed the TRR mode in about:preferences#privacy settings
+      Value is id of the clicked button.
+    expiry_version: never
+    record_in_processes:
+      - main
+    release_channel_collection: opt-out
+    notification_emails:
+      - vgosu@mozilla.com
+      - necko@mozilla.com
+    products:
+      - firefox
+  warn_checkbox:
+    objects: ["checkbox"]
+    bug_numbers:
+      - 1829905
+    description: >
+      User clicked the Warn if a third party actively prevents secure DNS
+      checkbox in about:preferences#privacy.
+      Value is true or false, reflecting if box is checked or unchecked.
+    expiry_version: never
+    record_in_processes:
+      - main
+    release_channel_collection: opt-out
+    notification_emails:
+      - vgosu@mozilla.com
+      - necko@mozilla.com
+    products:
+      - firefox
+  provider_choice:
+    objects: ["value"]
+    bug_numbers:
+      - 1829905
+    description: >
+      User changed their DoH provider. Recorded value is URL of one of the
+      existing providers or "custom".
+    expiry_version: never
+    record_in_processes:
+      - main
+    release_channel_collection: opt-out
+    notification_emails:
+      - vgosu@mozilla.com
+      - necko@mozilla.com
+    products:
+      - firefox
+
+security.ui.certerror:
+  load:
+    objects: ["aboutcerterror"]
+    bug_numbers:
+      - 1484255
+      - 1505310
+      - 1553181
+      - 1629826
+    description: >
+      The about:certerror page is loaded, keyed by error code, see https://searchfox.org/mozilla-central/source/security/nss/lib/mozpkix/include/pkix/Result.h
+    expiry_version: never
+    notification_emails:
+      - jhofmann@mozilla.com
+      - rtestard@mozilla.com
+      - seceng-telemetry@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["content"]
+    extra_keys:
+      is_frame: If the error page is loaded in an iframe.
+      has_sts: If the error page is for a site with HSTS headers or with a pinned key.
+  click:
+    objects: [
+      "advanced_button",
+      "exception_button",
+      "return_button_top",
+      "return_button_adv",
+      "learn_more_link",
+      "auto_report_cb",
+      "error_code_link",
+      "clipboard_button_top",
+      "clipboard_button_bot",
+    ]
+    bug_numbers:
+      - 1484255
+      - 1505310
+      - 1553181
+      - 1629826
+    description: >
+      User interaction by click events on the cert error page. Keyed by error code, see https://searchfox.org/mozilla-central/source/security/nss/lib/mozpkix/include/pkix/Result.h
+    expiry_version: never
+    notification_emails:
+      - jhofmann@mozilla.com
+      - rtestard@mozilla.com
+      - seceng-telemetry@mozilla.com
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["content"]
+    extra_keys:
+      is_frame: If the error page is loaded in an iframe.
+      has_sts: If the error page is for a site with HSTS headers or with a pinned key.
+      panel_open: If the advanced panel was open at the time of the interaction.
+
+slow_script_warning:
+  shown:
+    bug_numbers:
+      - 1652613
+      - 1667245
+      - 1672572
+    description: >
+      Recorded when a slow script hang is resolved.
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    release_channel_collection: opt-out
+    expiry_version: "never"
+    notification_emails:
+      - dothayer@mozilla.com
+      - esmyth@mozilla.com
+      - gkruitbosch@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    # Whether the hung script was for a content or browser process.
+    objects: [
+      "browser",
+      "content",
+    ]
+    extra_keys:
+      end_reason: Why the warning was hidden (user action, the process becoming responsive again, the browser quitting, etc.)
+      wait_count: How many times the user elected to wait.
+      hang_duration: How long we believe the hang continued (ms).
+      n_tab_deselect: How many times the user switched away from a tab affected by this hang.
+      uri_type: The kind of script URL that hung.
+      uptime: How long the notification was up (ms).
+
+webrtc.ui:
+  share_display:
+    objects:
+      - screen
+      - window
+      - browser_window
+    description: >
+      Recorded when a display is shared. The value for this event is a unique
+      ID that differentiates different sharing sessions. A new sharing session
+      is created when the user transitions from not sharing a display to
+      sharing at least one display.
+    extra_keys:
+      silence_notifs: True if the user opted in to silencing DOM notifications.
+    notification_emails:
+      - mconley@mozilla.com
+      - vchin@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1639283
+    expiry_version: "88"
+    release_channel_collection: opt-out
+
+ysod:
+  shown:
+    bug_numbers:
+      - 1657242
+    description: >-
+      This event is recorded only for Firefox UI documents (chrome).
+      Recorded when a Yellow Screen of Death is shown. The `value` is a url on which the error happened.
+      Yellow Screen of Death happens when XML or XHTML document encounters a parsing error. It is commonly a result
+      of the document being malformed or missing DTD entity.
+      Mozilla has a number of documents that rely on DTD entities for localization, and in some error scenarios those
+      entities may be missing or malformed themselves, in which case the user will see a broken UI.
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    release_channel_collection: opt-out
+    expiry_version: "never"
+    notification_emails:
+      - zbraniecki@mozilla.com
+      - vchin@mozilla.com
+    objects:
+      - "ysod"
+    extra_keys:
+      error_code: Code of the XML Error (See `XML_Error` enum in expat.h for the list of errors where XML_ERROR_NONE is 0).
+      location: Location as Row:Column of where the error happened.
+      last_line: The content of the last line that led to the error.
+      last_line_len: The length of the last line that led to the error.
+      hidden: The document is hidden.
+      destroyed: The container of this document is destroyed.
+
+dom.quota.try:
+  error:
+    objects: [
+      "step",
+    ]
+    bug_numbers:
+      - 1665088
+    description: >
+      An event recorded on an error of the quota manager or its clients. Since errors are usually
+      propagated up the call chain, all such propagation steps are recorded for an error. This
+      is only active during specific contexts, in particular during storage initialization.
+      No dynamic data is included in the event beyond the error code which will be added through
+      Bug 1670555.
+    notification_emails:
+      - jvarga@mozilla.com
+      - sgiesecke@mozilla.com
+      - storage-telemetry@mozilla.com
+    products:
+      - firefox
+    expiry_version: "never"
+    record_in_processes: ["main", "content"]
+    extra_keys:
+      context: The context in which the error occurred, e.g. during a storage initialization. Telemetry events are only emitted for selected contexts.
+      frame_id: Optionally, the frame within stack_id.
+      process_id: Optionally, the process in which the error occured.
+      result: Optionally, the name of the error that occurred.
+      seq: Sequence number.
+      severity: One of WARNING or ERROR.
+      source_file: The name of the source code file where the error occurred.
+      source_line: The line within source_file where the error occurred.
+      stack_id: Optionally, the stack within process_id.
+
+zero_byte_load:
+  load:
+    bug_numbers:
+      - 1675823
+    description: >-
+        Collection of zero_byte_load events as part of the Yellow Screen of Death analysis.
+        When a file is loaded synchronously, this event gets recorded in nsJARChannel::Open if the content length is zero.
+        For asynchronous loads, this event gets recorded in onStopRequest.
+        Note that when the load has been cancelled, the consumer could already receive some data, so this event also captures non-zero-byte loads.
+    products:
+      - "firefox"
+    record_in_processes: ["main", "content"]
+    release_channel_collection: opt-out
+    expiry_version: "never"
+    notification_emails:
+      - zbraniecki@mozilla.com
+      - vchin@mozilla.com
+      - kershaw@mozilla.com
+    objects:
+      - "ftl"
+      - "dtd"
+      - "properties"
+      - "js"
+      - "xml"
+      - "xhtml"
+      - "css"
+      - "json"
+      - "html"
+      - "png"
+      - "svg"
+      - "others"
+    extra_keys:
+      sync: Was the load synchronous
+      file_name: The name of the file being loaded.
+      status: The channel status code.
+      cancelled: Whether this load has been cancelled.
+
+avif:
+  dav1d_get_picture:
+    objects: ["return_value"]
+    bug_numbers: [1690406]
+    description: Return value from dav1d_get_picture
+    products:
+      - firefox # event telemetry is not supported on fenix
+    record_in_processes: ["all"]
+    release_channel_collection: opt-out
+    expiry_version: never
+    notification_emails:
+      - media-alerts@mozilla.com
+
+installation:
+  first_seen:
+    description: >
+      Recorded after the application has been installed or reinstalled, the first time that
+      a profile sees that there was a new installation. This includes information about how
+      the installer was run.
+    objects:
+      - full # if the full installer was run directly
+      - stub # if the stub installer was used
+      - msix # if the installation was done through an MSIX package
+    release_channel_collection: opt-out
+    record_in_processes: ["main"]
+    products: ["firefox"]
+    operating_systems: ["windows"]
+    extra_keys:
+      version: The application version installed by the installer (not necessarily the current version)
+      build_id: The build ID of the application installed by the installer (not necessarily the current version)
+      admin_user: Whether the installer is running from an elevated admin user
+      install_existed: Whether there was already an install in this location
+      other_inst: Whether there was already any non-MSIX install on this system
+      other_msix_inst: Whether there was already any MSIX install on this system
+      profdir_existed: Whether the top-level profile directory existed
+      silent: '(optional, present if object is "full") Whether this was a silent install'
+      from_msi: '(optional, present if object is "full") Whether this was an MSI install'
+      default_path: '(optional, present if object is "full") Whether the default path was used'
+    bug_numbers: [1660198, 1725295, 1743465, 1754638]
+    notification_emails:
+      - application-update-telemetry-alerts@mozilla.com
+      - rtestard@mozilla.com
+    expiry_version: never
+  first_seen_prov_ext:
+    description: >
+      This is an extension of the `installation.first_seen` event. It will always be recorded at
+      the same time as that event, so an event ping that contains one will generally contain the
+      other (the exception being if the event ping splits between the two and one of the two pings
+      fails to be received properly, which should be exceedingly rare). The reason for this event
+      to exist is that we want to include more than 10 `extra_keys`, but the limit is 10. The
+      specific extra keys that we want to include are related to provenance data (see Bug 1814968).
+    objects:
+      - full # if the full installer was run directly
+      - stub # if the stub installer was used
+      - msix # if the installation was done through an MSIX package
+    release_channel_collection: opt-out
+    record_in_processes: ["main"]
+    products: ["firefox"]
+    operating_systems: ["windows"]
+    extra_keys:
+      data_exists: >
+        Will be "true" if the "zoneIdProvenanceData" file is present in the installation directory
+        and we were able to successfully read it. This key is only present on platforms that
+        support provenance data.
+      file_system: >
+        The file system that the installer resided on at installation time. Possible values are:
+        "NTFS", "FAT32", "other". In error cases, it can also be "missing", "error" or
+        "readIniError". This key is only present if `data_exists` is "true".
+      ads_exists: >
+        Will always be false if `data_exists` is false. Will be "true" if the provenance data
+        indicates that the :Zone.Identifier Alternate Data Stream existed on the installer.
+      security_zone: >
+        The zone identifier in the installer's :Zone.Identifier ADS. Possible values are integers
+        between 0 and 4, inclusive (encoded as strings). In error cases, it can also be
+        "unexpected", "missing", "error", or "readIniError". This key is only present if
+        `ads_exists` is "true".
+      refer_url_exist: >
+        Will be "true" if the zone identifier ADS contained a referrer URL. Will be false if a
+        referrer URL is specified, but it isn't a valid URL. Only sent if `ads_exists` is "true".
+      refer_url_moz: >
+        Will be "true" if the referrer URL from the zone identifier ADS appeared to be a Mozilla
+        URL. Only sent if `refer_url_exist` is "true".
+      host_url_exist: >
+        Will be "true" if the zone identifier ADS contained a host URL. Will be false if a host URL
+        is specified, but it isn't a valid URL. Only sent if `ads_exists` is "true".
+      host_url_moz: >
+        Will be "true" if the host URL from the zone identifier ADS appeared to be a Mozilla URL.
+        Only sent if `host_url_exists` is "true".
+    bug_numbers: [1814968, 1821189]
+    notification_emails:
+      - application-update-telemetry-alerts@mozilla.com
+    expiry_version: "121"
+
+contextservices.quicksuggest:
+  data_collect_toggled:
+    objects: ["enabled", "disabled"]
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    description: >
+      This is recorded when the
+      `browser.urlbar.quicksuggest.dataCollection.enabled` boolean pref is
+      toggled.
+    bug_numbers: [1735976]
+    notification_emails:
+      - fx-search-telemetry@mozilla.com
+      - adw@mozilla.com
+    expiry_version: never
+  enable_toggled:
+    objects: ["enabled", "disabled"]
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    description: >
+      This is recorded when the
+      `browser.urlbar.suggest.quicksuggest.nonsponsored` boolean pref is
+      toggled.
+    bug_numbers: [1693126]
+    notification_emails:
+      - fx-search-telemetry@mozilla.com
+      - adw@mozilla.com
+    expiry_version: never
+  sponsored_toggled:
+    objects: ["enabled", "disabled"]
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    description: >
+      This is recorded when the `browser.urlbar.suggest.quicksuggest.sponsored`
+      boolean pref is toggled.
+    bug_numbers: [1728430, 1733687]
+    notification_emails:
+      - fx-search-telemetry@mozilla.com
+      - adw@mozilla.com
+    expiry_version: never
+  opt_in_dialog:
+    objects: ["accept_2", "reject_2", "learn_more_1", "learn_more_2", "close_1", "not_now_2", "dismiss_1", "dismiss_2"]
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    description: >
+      This is recorded when the user responds to the Firefox Suggest opt-in
+      onboarding dialog. 'accept_2' is recorded when the user accepts the dialog
+      and opts in, 'reject_2' is recorded when the user rejects the dialog and
+      opts out, 'learn_more_1' is recorded when the user clicks "Learn more"
+      on the introduction section (the user remains opted out), 'learn_more_2' is
+      recorded when the user clicks "Learn more" on the main section (the user
+      remains opted out), 'close_1' is recorded when the user clicks close button
+      on the introduction section (the user remains opted out), 'not_now_2' is
+      recorded when the user clicks "Not now" link on main section (the user
+      remains opted out), 'dismiss_1' recorded when the user dismisses the dialog
+      on the introduction section (the user remains opted out), 'dismiss_2'
+      recorded when the user dismisses the dialog on main (the user remains opted
+      out),
+    bug_numbers: [1723860, 1745026, 1761171]
+    notification_emails:
+      - fx-search-telemetry@mozilla.com
+      - adw@mozilla.com
+    expiry_version: never
+  impression_cap:
+    description: >
+      This is recorded when an event related to an impression cap occurs. "hit"
+      is recorded when an impression cap is hit. "reset" is recorded when a
+      cap's counter is reset because its interval period has elapsed.
+    objects: ["hit", "reset"]
+    extra_keys:
+      type: >
+        The type of cap, one of: "sponsored", "nonsponsored"
+      intervalSeconds: >
+        The number of seconds in the cap's interval period. For lifetime caps,
+        this value will be "Infinity".
+      maxCount: >
+        The maximum number of impressions allowed in the cap's interval period.
+      startDate: >
+        The timestamp at which the cap's interval period started, in number of
+        seconds since Unix epoch.
+      count: >
+        The number of impressions in the cap's interval period.
+      impressionDate: >
+        The timestamp of the cap's most recent impression, in number of
+        milliseconds since Unix epoch.
+      eventDate: >
+        The event's timestamp, in number of milliseconds since Unix epoch. For
+        "reset" events, this is the timestamp at which the cap's interval period
+        ended. If eventCount is greater than 1, it's the timestamp at which the
+        last interval period ended. For "hit" events, this is the timestamp at
+        which the cap was hit.
+      eventCount: >
+        The number of impression cap events reported in the telemetry event.
+        This is necessary because the implementation may batch multiple
+        consecutive "reset" events for a cap in a single telemetry event. When
+        that occurs, this value will be greater than 1, startDate will be the
+        timestamp at which the first event's interval period started, eventDate
+        will be the timestamp at which the last event's interval period ended,
+        and count will be the number of impressions during the first event's
+        interval period. (The implementation guarantees that reset events are
+        batched only when the number of impressions for all subsequent interval
+        periods is zero.) For "hit" events, eventCount will always be 1.
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    bug_numbers: [1761058]
+    notification_emails:
+      - fx-search-telemetry@mozilla.com
+      - adw@mozilla.com
+    expiry_version: never
+  engagement:
+    description: >
+      This event is recorded when an engagement occurs in the address bar while
+      a Firefox Suggest suggestion is present. The event's objects are the
+      following possible values:
+      "block": The user dismissed ("blocked") the suggestion.
+      "click": The user picked the suggestion.
+      "help": The user picked the suggestion's help button.
+      "impression_only": The user picked some other row.
+      "other": The user engaged with the suggestion in some other way, for
+        example by picking a command in the result menu. This is a catch-all
+        category and going forward Glean telemetry should be preferred.
+    objects: ["block", "click", "help", "impression_only", "other"]
+    extra_keys:
+      match_type: >
+        "best-match" if the suggestion was a best match or "firefox-suggest" if
+        it was a non-best-match suggestion.
+      position: >
+        The index of the suggestion in the list of results (1-based).
+      suggestion_type: >
+        The type of suggestion, one of: "sponsored", "nonsponsored",
+        "dynamic-wikipedia", "weather", "navigational"
+      source: >
+        Where the suggestion came from, one of: "remote-settings", "merino"
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    bug_numbers: [1761059]
+    notification_emails:
+      - fx-search-telemetry@mozilla.com
+      - adw@mozilla.com
+    expiry_version: never
+
+close_tab_warning:
+  shown:
+    description: >
+      Recorded whenever we show the 'Close Tabs' dialog, with details about
+      the reason it is shown and what choices the user makes (close or not).
+    objects: ["window", "application", "tabs"]
+    release_channel_collection: opt-out
+    expiry_version: "99"
+    record_in_processes: ["main"]
+    products: ["firefox"]
+    bug_numbers: [1712306, 1725296]
+    notification_emails:
+      - gkruitbosch@mozilla.com
+      - rtestard@mozilla.com
+    extra_keys:
+      source: The way in which the tabs were closed (shortcut, close button, menuitem, appmenu, etc.)
+      button: Which button the user clicked (Close tabs or Cancel)
+      warn_checkbox: Whether the checkbox to display the warning again was checked or not.
+      closing_wins: The number of windows being closed.
+      closing_tabs: The number of tabs being closed.
+      will_restore: Whether the session will be restored if closed now.
+
+memory_watcher:
+  on_high_memory:
+    description: >
+      This event is recorded when the memory situation is no longer low.
+      The "stats" object consists of three numbers comma-delimited:
+      1) how many times a tab was unloaded
+      2) how many memory-pressure events were dispatched
+      3) how long we were in the low-memory situation in seconds
+    objects: ["stats"]
+    release_channel_collection: opt-out
+    expiry_version: never
+    record_in_processes: ["main"]
+    products: ["firefox"]
+    bug_numbers: [1715858]
+    notification_emails:
+      - tkikuchi@mozilla.com
+
+service_request:
+  bypass:
+    description: >
+      This event is recorded by a small set of services when a proxy failure
+      causes a service to re-request with a proxy bypass.  It records some
+      basic information such as the type of proxy configuration, and the source
+      of the proxy configuration.  The value of the event is the name of the
+      service that triggers the event (e.g. telemetry, remote-settings).
+    methods: ["bypass"]
+    objects: ["proxy_info"]
+    release_channel_collection: opt-out
+    expiry_version: never
+    record_in_processes: ["main"]
+    products: ["firefox"]
+    bug_numbers: [1732792, 1732793, 1733481, 1733994, 1732388]
+    notification_emails:
+      - scaraveo@mozilla.com
+    extra_keys:
+      source: the source of the proxy configuration.  e.g. policy, prefs or extension_id
+      type: the type for the proxy configuration source.  e.g. api or string version of nsIProtocolProxyService.proxyConfigType
+
+synced_tabs:
+  click:
+    objects: [
+      "fxa_avatar_menu",
+      "fxa_app_menu",
+      "synced_tabs_sidebar",
+      ]
+    methods: ["click"]
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    description: Record how users access and use synced tabs component
+    bug_numbers: [1756252]
+    notification_emails: ["sync-dev@mozilla.org"]
+    expiry_version: "never"
+    extra_keys:
+      tab_pos: position of the tab clicked
+      filter: was there a filter enabled
+
+firefoxview:
+  entered:
+    objects: ["firefoxview"]
+    description: >
+      Recorded when the Firefox View is selected
+    notification_emails:
+      - firefoxview@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1779642
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  synced_tabs:
+    objects: ["tabs"]
+    description: >
+      Recorded when the tabs list is updated
+    extra_keys:
+      count: The number of synbced tabs
+    notification_emails:
+      - firefoxview@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1779642
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  tab_pickup_open:
+    objects: ["tabs"]
+    description: >
+      Recorded when the tab pickup list is collasped or opened. True if the section is now open, false otherwise
+    notification_emails:
+      - firefoxview@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1779642
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  tab_pickup:
+    objects: ["tabs"]
+    description: >
+      Recorded when a tab pickup tab is clicked
+    extra_keys:
+      position: The position of the tab in the tab pickup list (starting at 1.)
+      deviceType: The type of device the tab came from. Will be "desktop", "phone", or "tablet"
+    notification_emails:
+      - firefoxview@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1779642
+      - 1789641
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  synced_tabs_empty:
+    objects: ["since_device_added"]
+    description: >
+      Records the time elapsed in seconds that the Tab Pickup empty message is displayed after a new device was added
+    notification_emails:
+      - firefox-view-engineers@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1809661
+    expiry_version: "120"
+    release_channel_collection: opt-out
+  closed_tabs_open:
+    objects: ["tabs"]
+    description: >
+      Recorded when the recently closed tabs list is collapsed or opened. True if the section is now open, false otherwise
+    notification_emails:
+      - firefoxview@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1779642
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  recently_closed:
+    objects: ["tabs"]
+    description: >
+      Recorded when a recently closed tab is clicked
+    extra_keys:
+      delta: Time since the tab was closed
+      position: The position of the tab in the recently closed tab list (starting at 1.)
+    notification_emails:
+      - firefoxview@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1779642
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  dismiss_closed_tab:
+    objects: ["tabs"]
+    description: >
+      Recorded when a recently closed tab is dismissed
+    extra_keys:
+      delta: Time since the tab was closed to when dismissed
+    notification_emails:
+      - firefoxview@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1804099
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  fxa_continue:
+    objects: ["sync"]
+    description: >
+      Recorded when continue button to sign in is clicked
+    notification_emails:
+      - firefoxview@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1779642
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  fxa_mobile:
+    objects: ["sync"]
+    description: >
+      Recorded when get Firefox for mobile is clicked
+    extra_keys:
+      has_devices: True if user has other devices signed into sync
+    notification_emails:
+      - firefoxview@mozilla.com
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1779642
+    expiry_version: "never"
+    release_channel_collection: opt-out
+
+search:
+  engine:
+    objects: ["change_default", "change_private"]
+    release_channel_collection: opt-out
+    products:
+      - "firefox"
+    record_in_processes: ["main"]
+    description: >
+      Recorded when the default search engine is changed, the value field
+      records the action used to trigger the change of default. For possible
+      values, see `REASON_CHANGE_MAP` in
+      https://searchfox.org/mozilla-central/source/toolkit/components/search/SearchService.sys.mjs
+    bug_numbers: [1634555]
+    notification_emails:
+      - fx-search-telemetry@mozilla.com
+      - rev-data@mozilla.com
+    expiry_version: never
+    extra_keys:
+      prev_id: The id of the previous default engine.
+      new_id: The id of the new default engine.
+      new_name: The display name of the new default engine.
+      new_load_path: The path relating to where the new default engine was installed/loaded from.
+      new_sub_url: The new submission URL of the new default engine.
+
+cookie_banner:
+  reload:
+    objects: ["browser"]
+    description: >
+      Recorded when the top-level page is reloaded. We use this event metric to
+      know whether or not the reloading domain has cookie banner rule.
+    record_in_processes: ["main"]
+    products:
+      - "firefox"
+      - "fennec"
+    release_channel_collection: opt-out
+    notification_emails:
+      - pbz@mozilla.com
+      - tihuang@mozilla.com
+    bug_numbers:
+      - 1797079
+    expiry_version: "115"
+    extra_keys:
+      no_rule: There is no cookie banner rule for the reloading domain.
+      has_cookie_rule: There is a matching cookie rule for the reloading domain.
+      has_click_rule: There is a matching click rule for the reloading domain.
+
+screenshots:
+  download:
+    objects: ["overlay_download", "preview_download"]
+    description: >
+      Recorded when a user downloads a screenshot from the overlay or the preview.
+    notification_emails:
+      - screenshots-dev@mozilla.org
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1801019
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  copy:
+    objects: ["overlay_copy", "preview_copy"]
+    description: >
+      Recorded when a user copies a screenshot from the overlay or the preview.
+    notification_emails:
+      - screenshots-dev@mozilla.org
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1801019
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  selected:
+    objects: ["element", "region_selection", "visible", "full_page"]
+    description: >
+      Recorded when a user selects a region by hand, selects an element, selects the save visible, or selects save full page.
+      Note that this is recorded independent of whether or not the screenshot is saved.
+    notification_emails:
+      - screenshots-dev@mozilla.org
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+      - content
+    bug_numbers:
+      - 1801019
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  started:
+    objects: ["toolbar_button", "shortcut", "context_menu", "quick_actions", "preview_retry", "overlay_retry"]
+    description: >
+      Recorded when a user opens the screenshots ui.
+    notification_emails:
+      - screenshots-dev@mozilla.org
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+      - content
+    bug_numbers:
+      - 1801019
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  canceled:
+    objects: ["toolbar_button", "shortcut", "context_menu", "quick_actions", "preview_cancel", "overlay_cancel", "escape", "navigation"]
+    description: >
+      Recorded when a user closes the screenshots ui. The screenshots ui is closed after
+      copying/downloading but we do not record that as canceling the screenshots ui.
+    notification_emails:
+      - screenshots-dev@mozilla.org
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1801019
+    expiry_version: "never"
+    release_channel_collection: opt-out
+  failed:
+    objects: ["screenshot_too_large"]
+    description: >
+      Recorded when a screenshot is too big to capture and we have to crop the screenshot.
+    notification_emails:
+      - screenshots-dev@mozilla.org
+    products:
+      - "firefox"
+    record_in_processes:
+      - main
+    bug_numbers:
+      - 1801019
+    expiry_version: "never"
+    release_channel_collection: opt-out