toolkit/components/telemetry/Scalars.yaml
author Emilio Cobos Álvarez <emilio@crisal.io>
Sat, 08 Aug 2020 16:21:35 +0000
changeset 544015 b579c12907dc3bb210177454a696ccc181c1ded0
parent 543983 5fe3de70b098fa4f829a983ba60c4a0bf72c7344
permissions -rw-r--r--
Bug 1657437 - Don't treat lone CRs as segment breaks. r=jfkthame That prevents preceding whitespace from getting collapsed. When there's a single lone CR (so `a\rb`) our behavior here diverges from Chrome's but matches Safari's. We treat it as ZWSP. That matches the initial resolution of [1], but then there have been various doing and undoings of that resolution, so it's not totally clear to me what the correct behavior per spec should be. I think "treat it as other control character"? But I haven't dug into what that implies, so for now I've just kept behavior there as-is. [1]: https://github.com/w3c/csswg-drafts/issues/855 Differential Revision: https://phabricator.services.mozilla.com/D86188

# 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/.

# This file contains a definition of the scalar probes that are recorded in Telemetry.
# They are submitted with the "main" pings and can be inspected in about:telemetry.

# The following section contains the accessibility scalars.
a11y:
  backplate:
    bug_numbers:
      - 1539212
    description: >
      Boolean tracking if the user has the backplate preference enabled or disabled.
    expires: never
    kind: boolean
    notification_emails:
      - accessibility@mozilla.com
      - mreschenberg@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
    keyed: false

  instantiators:
    bug_numbers:
      - 1323069
      - 1462238
    description: >
      The leaf name and version number of the binary for the process responsible
      for remotely instantiating a11y.
    expires: never
    kind: string
    notification_emails:
      - accessibility@mozilla.com
      - jteh@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
    keyed: false

  indicator_acted_on:
    bug_numbers:
      - 1412358
    description: >
      Recorded on click or SPACE/ENTER keypress event. Boolean stating if the
      accessibility indicactor button was acted on.
    expires: "62"
    kind: boolean
    notification_emails:
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  theme:
    bug_numbers:
      - 1022528
    description: >
      OS high contrast or other accessibility theme is enabled.
      The result is split into keys which represent the values of
      browser.display.document_color_use: "default", "always", or "never".
    keyed: true
    expires: never
    kind: boolean
    notification_emails:
      - accessibility@mozilla.com
      - eisaacson@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

# The following section contains the browser engagement scalars.
browser.engagement:
  max_concurrent_tab_count:
    bug_numbers:
      - 1271304
    description: >
      The count of maximum number of tabs open during a subsession,
      across all windows, including tabs in private windows and restored
      at startup.
    expires: never
    kind: uint
    notification_emails:
      - rweiss@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  tab_open_event_count:
    bug_numbers:
      - 1271304
    description: >
      The count of tab open events per subsession, across all windows, after the
      session has been restored. This includes tab open events from private windows
      and from manual session restorations (i.e. after crashes and from about:home).
    expires: never
    kind: uint
    notification_emails:
      - rweiss@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  max_concurrent_window_count:
    bug_numbers:
      - 1271304
    description: >
      The count of maximum number of browser windows open during a subsession. This
      includes private windows and the ones opened when starting the browser.
    expires: never
    kind: uint
    notification_emails:
      - rweiss@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  window_open_event_count:
    bug_numbers:
      - 1271304
    description: >
      The count of browser window open events per subsession, after the session
      has been restored. The count includes private windows and the ones from manual
      session restorations (i.e. after crashes and from about:home).
    expires: never
    kind: uint
    notification_emails:
      - rweiss@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  max_concurrent_tab_pinned_count:
    bug_numbers:
      - 1505535
    description: >
      The count of maximum number of pinned tabs open during a subsession. This
      includes private windows and the ones opened when starting the browser.
    expires: never
    kind: uint
    notification_emails:
      - bmiroglio@mozilla.com
      - aoprea@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  tab_pinned_event_count:
    bug_numbers:
      - 1505535
    description: >
      The count of tab pinned events per subsession, across all windows, after the
      session has been restored. This includes tab pinned events from private windows.
    expires: never
    kind: uint
    notification_emails:
      - bmiroglio@mozilla.com
      - aoprea@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  total_uri_count:
    bug_numbers:
      - 1271313
      - 1529232
    description: >
      The count of the total non-unique http(s) URIs visited in a subsession, including
      page reloads, after the session has been restored. This does not include background
      page requests and URIs from embedded pages or private browsing.
    expires: never
    kind: uint
    notification_emails:
      - rweiss@mozilla.com
      - loines@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'main'
      - 'account-ecosystem'

  unfiltered_uri_count:
    bug_numbers:
      - 1304647
    description: >
      The count of the total non-unique URIs visited in a subsession, not restricted to
      a specific protocol, including page reloads and about:* pages (other than initial
      pages such as about:blank, ...), after the session has been restored. This does
      not include background page requests and URIs from embedded pages or private browsing.
    expires: never
    kind: uint
    notification_emails:
      - bcolloran@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  unique_domains_count:
    bug_numbers:
      - 1271310
    description: >
      The count of the unique domains visited in a subsession, after the session
      has been restored. Subdomains under eTLD are aggregated after the first level
      (i.e. test.example.com and other.example.com are only counted once).
      This does not include background page requests and domains from embedded pages
      or private browsing. The count is limited to 100 unique domains.
    expires: never
    kind: uint
    notification_emails:
      - rweiss@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  restored_pinned_tabs_count:
    bug_numbers:
      - 1373728
      - 1451475
    description: >
      The count of the number of pinned tabs that were restored.
    expires: '67'
    kind: uint
    notification_emails:
      - chutten@mozilla.com
      - jrediger@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  active_ticks:
    bug_numbers:
      - 1376942
      - 1545172
    description: >
      The count of the number of five-second intervals ('ticks') the user
      was considered 'active' in a subsession. Session activity involves keyboard or mouse
      interaction with the application. It does not take into account whether or not the window
      has focus or is in the foreground, only if it is receiving these interaction events.
    expires: never
    kind: uint
    notification_emails:
      - bcolloran@mozilla.com
      - loines@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'main'
      - 'account-ecosystem'

# The following section contains the browser engagement scalars.
browser.engagement.navigation:
  urlbar:
    bug_numbers:
      - 1271313
    description: >
      The count URI loads triggered in a subsession from the urlbar (awesomebar),
      broken down by the originating action.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - bcolloran@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  searchbar:
    bug_numbers:
      - 1271313
    description: >
      The count URI loads triggered in a subsession from the searchbar,
      broken down by the originating action.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - bcolloran@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  about_home:
    bug_numbers:
      - 1271313
    description: >
      The count URI loads triggered in a subsession from about:home,
      broken down by the originating action.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - bcolloran@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  about_newtab:
    bug_numbers:
      - 1271313
    description: >
      The count URI loads triggered in a subsession from about:newtab,
      broken down by the originating action.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - bcolloran@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  contextmenu:
    bug_numbers:
      - 1271313
    description: >
      The count URI loads triggered in a subsession from the contextmenu,
      broken down by the originating action.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - bcolloran@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  webextension:
    bug_numbers:
      - 1492233
    description: >
      The count URI loads triggered in a subsession from a webextension.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - mkaply@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

browser.startup:
  slow_startup_notification_disabled:
    bug_numbers:
      - 1601993
      - 1634224
    description:
      Whether the slow startup notification bar is disabled for the user.
    expires: "85"
    kind: boolean
    notification_emails:
      - mconley@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  too_new_for_notification:
    bug_numbers:
      - 1601993
      - 1634224
    description:
      Whether the slow startup notification bar was suppressed because the profile is too new.
    expires: "85"
    kind: boolean
    notification_emails:
      - mconley@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  slow_startup_notified:
    bug_numbers:
      - 1601993
      - 1634224
    description:
      Whether the slow startup notification bar was shown to the user during this session.
    expires: "85"
    kind: boolean
    notification_emails:
      - mconley@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  recorded_time:
    bug_numbers:
      - 1601993
      - 1634224
    description: >
      The startup time computed by the slow startup notification bar in milliseconds.
    expires: "85"
    kind: uint
    notification_emails:
      - mconley@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  average_time:
    bug_numbers:
      - 1601993
      - 1634224
    description: >
      The average startup time computed by the slow startup notification bar in milliseconds.
    expires: "85"
    kind: uint
    notification_emails:
      - mconley@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  action:
    bug_numbers:
      - 1601993
      - 1634224
    description: >
      The action that the user took with the slow startup notification bar.
      0: No action (default)
      1: User chose to open SUMO document on slow startup
      2: User chose to never show the notification bar again
      3: User dismissed the notification bar
    expires: "85"
    kind: uint
    notification_emails:
      - mconley@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  abouthome_cache_result:
    bug_numbers:
      - 1622263
      - 1614351
    description: >
      How the about:home startup cache functioned on startup.

      0: Result value was never set (error case)
      1: Cache did not exist
      2: Cache page stream was corrupt / inaccessible
      3: Cache script stream was corrupt / inaccessible
      4: Cache was invalidated by a version bump
      5: Cache was valid, but read too late to be useful.
      6: Cache was valid and used.
      7: Cache is disabled.
      8: User did not load about:home on its own by default.
      9: Cache is disabled because about:newtab preloading is disabled.

    expires: "87"
    kind: uint
    notification_emails:
      - mconley@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  abouthome_cache_shutdownwrite:
    bug_numbers:
      - 1622263
      - 1614351
    description: >
      True if the about:home startup cache was written via the AsyncShutdown
      blocker.

    expires: "87"
    kind: boolean
    notification_emails:
      - mconley@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

# The following section contains the browser usage scalars.
browser.usage:
  graphite:
    bug_numbers:
      - 1331915
    description: >
      The number of times a graphite2 font has been loaded.
    expires: "65"
    kind: uint
    notification_emails:
      - tom@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'all'

  plugin_instantiated:
    bug_numbers:
      - 1381591
    description: >-
      The number of plugin instances that were created.
    expires: never  # Jan-2021 but we don't have a version number for that
    kind: uint
    notification_emails:
      - bsmedberg@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
      - 'content'

browser.input:
  touch_event_count:
    bug_numbers:
      - 1626099
    description: >-
      Windows only.
      Counts occurrences of touch events,
      measured when user starts a touch event.
    expires: "90"
    kind: uint
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
      - 'content'

browser.ui:
  toolbar_widgets:
    bug_numbers:
      - 1620358
    description: >
      The widgets in the toolbars.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: boolean
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  customized_widgets:
    bug_numbers:
      - 1620358
    description: >
      Records when widgets are added, removed or moved in the UI.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

browser.ui.interaction:
  keyboard:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with keyboard shortcuts.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  menu_bar:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with items in the menu bar.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  tabs_bar:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with items in the tab bar.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  nav_bar:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with items in the nav bar.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  bookmarks_bar:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with items in the bookmarks bar.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  app_menu:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with items in the app menu.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  tabs_context:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with items in the tab context menu.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  content_context:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with items in the content context menu.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  overflow_menu:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with items in the overflow menu.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  pinned_overflow_menu:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with items in the pinned area of the
      overflow menu.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  pageaction_urlbar:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with page action items in the url bar.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  pageaction_panel:
    bug_numbers:
      - 1620358
    description: >
      Records a count of interactions with page action items in the panel.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preferences_paneHome:
    bug_numbers:
      - 1620358
    description: >
      Records the items interacted with in the Home section of preferences.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preferences_paneGeneral:
    bug_numbers:
      - 1620358
    description: >
      Records the items interacted with in the General section of preferences.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preferences_panePrivacy:
    bug_numbers:
      - 1620358
    description: >
      Records the items interacted with in the Privacy section of preferences.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preferences_paneSearch:
    bug_numbers:
      - 1620358
    description: >
      Records the items interacted with in the Search section of preferences.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preferences_paneSearchResults:
    bug_numbers:
      - 1620358
    description: >
      Records the items interacted with in the Search results section of
      preferences.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preferences_paneSync:
    bug_numbers:
      - 1620358
    description: >
      Records the items interacted with in the Sync section of preferences.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preferences_paneContainers:
    bug_numbers:
      - 1620358
    description: >
      Records the items interacted with in the Containers section of
      preferences.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preferences_paneExperimental:
    bug_numbers:
      - 1620358
      - 1651986
    description: >
      Records the items interacted with in the Experimental section of
      preferences.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preferences_paneUnknown:
    bug_numbers:
      - 1620358
      - 1651986
    description: >
      Records the items interacted with in any other section of preferences.
      See https://firefox-source-docs.mozilla.org/browser/BrowserUsageTelemetry.html
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - shong@mozilla.com
      - dtownsend@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

gecko:
  version:
    bug_numbers:
      - 1611240
    description: >
      The version of the Gecko engine, example: '74.0a1'.
      It consists of the major and minor version, followed by the release life cycle phase.
      'a' stands for alpha or nightly, 'b' stands for beta.
      The number behind the release life cycle phase indicates minor releases within the phase.
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  build_id:
    bug_numbers:
      - 1611240
    description: >
      The build id of the Gecko engine, example: '20200205124310'.
      It contains the time the build was created and is used as a unique id for the build.
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out

extensions.updates:
  rdf:
    bug_numbers:
      - 1460336
    description: >
      The number of RDF update requsts for a given extension ID.
    expires: "66"
    kind: uint
    keyed: true
    notification_emails:
      - addons-dev-internal@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main

identity.fxaccounts:
  missed_commands_fetched:
    bug_numbers:
      - 1644598
    description: >
      The number of missed FxA commands we have recovered.
    expires: "85"
    kind: uint
    keyed: false
    notification_emails:
      - sync-team@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main
  push_state_command_target:
    bug_numbers:
      - 1644598
    description: >
      The push state of the device we are sending a command to.
    expires: "85"
    kind: uint
    keyed: true
    keys: ["ok", "expiredCallback", "noCallback"]
    notification_emails:
      - sync-team@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main
  push_state_this_device:
    bug_numbers:
      - 1644598
    description: >
      The reason why the push state for this device is in a bad shape.
    expires: "85"
    kind: uint
    keyed: true
    keys: ["expiredCallback", "noCallback"]
    notification_emails:
      - sync-team@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main

security:
  webauthn_used:
    bug_numbers:
      - 1265472
      - 1558870
      - 1630155
    description: >
      Counts of how often Web Authentication was used in this session, keyed
      by authenticator protocol, method and result. Currently: U2FRegisterFinish,
      U2FRegisterAbort, U2FSignFinish, U2FSignAbort.
    expires: "88"
    kind: uint
    keyed: true
    notification_emails:
      - seceng-telemetry@mozilla.com
      - jjones@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  intermediate_preloading_num_preloaded:
    bug_numbers:
      - 1519273
      - 1553550
    description: >
      Number of intermediate certificates pre-loaded.
    expires: "86"
    kind: uint
    notification_emails:
      - seceng-telemetry@mozilla.com
      - jjones@mozilla.com
      - dkeeler@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - main
  intermediate_preloading_num_pending:
    bug_numbers:
      - 1519273
      - 1553550
    description: >
      Number of intermediate certificates pending pre-load.
    expires: "86"
    kind: uint
    notification_emails:
      - seceng-telemetry@mozilla.com
      - jjones@mozilla.com
      - dkeeler@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - main
  client_cert:
    bug_numbers:
      - 1255120
    description: >
      Counts of events related to client certificates this session. Currently:
      "requested" (a server requested a client certificate), "sent" (a client
      certificate was sent), "compat" (a compatibility workaround was required).
    expires: "66"
    kind: uint
    keyed: true
    notification_emails:
      - seceng-telemetry@mozilla.com
      - dkeeler@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  tls_delegated_credentials_txn:
    bug_numbers:
      - 1564179
      - 1645082
    description: >-
      Count of how many transactions used delegated credentials (ietf-draft-tls-subcerts)
    expires: "86"
    kind: uint
    notification_emails:
      - seceng-telemetry@mozilla.com
      - kjacobs@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main
  https_only_mode_enabled:
    bug_numbers:
      - 1620244
    description: >
      Measures user retention of the HTTPS-Only Mode.
      0 = never enabled, 1 = enabled, 2 = disabled (but was enabled)
    expires: never
    kind: uint
    notification_emails:
      - julianwels@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
  https_only_mode_enabled_pbm:
    bug_numbers:
      - 1647719
    description: >
      Measures user retention of the HTTPS-Only Mode in Private Browsing.
      0 = https-only never enabled in PBM,
      1 = https-only enabled in PBM,
      2 = https-only disabled in PBM (but was enabled)
    expires: never
    kind: uint
    notification_emails:
      - julianwels@mozilla.com
      - ckerschb@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

pwmgr:
  potentially_breached_passwords:
    bug_numbers:
      - 1577808
    description: >
      The number of potentially breached passwords, as determined by
      LoginBreaches.getPotentialBreachesByLoginGUID.
    expires: never
    kind: uint
    notification_emails:
      - seceng-telemetry@mozilla.com
      - passwords-dev@mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main

contentblocking:
  cryptomining_blocking_enabled:
    bug_numbers:
      - 1522919
    description: >
      True if cryptominer blocking is enabled globally at startup.
    expires: never
    kind: boolean
    notification_emails:
      - aedelstein@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  fingerprinting_blocking_enabled:
    bug_numbers:
      - 1522919
    description: >
      True if fingerprinter blocking is enabled globally at startup.
    expires: never
    kind: boolean
    notification_emails:
      - aedelstein@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  category:
    bug_numbers:
      - 1529425
    description: >
      This scalar reports the value of the content blocking category pref (0 = "standard", 1 = "strict", 2 = "custom", 3 = some other value, this is not supported).
    expires: never
    kind: uint
    notification_emails:
      - aedelstein@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  trackers_blocked_count:
    bug_numbers:
      - 1577030
      - 1610894
      - 1645088
    description: >
      A count of the number of tracking events blocked.
    expires: "86"
    kind: uint
    notification_emails:
      - ewright@mozilla.com
      - chsiang@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main

datasanitization:
  network_cookie_lifetimePolicy:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      This scalar reports the value of the network.cookie.lifetimePolicy pref.
    expires: "86"
    kind: uint
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_sanitize_sanitizeOnShutdown:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.sanitize.sanitizeOnShutdown pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_clearOnShutdown_cookies:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.clearOnShutdown.cookies pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_clearOnShutdown_history:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.clearOnShutdown.history pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_clearOnShutdown_formdata:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.clearOnShutdown.formdata pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_clearOnShutdown_downloads:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.clearOnShutdown.downloads pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_clearOnShutdown_cache:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.clearOnShutdown.cache pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_clearOnShutdown_sessions:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.clearOnShutdown.sessions pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_clearOnShutdown_offlineApps:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.clearOnShutdown.offlineApps pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_clearOnShutdown_siteSettings:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.clearOnShutdown.siteSettings pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  privacy_clearOnShutdown_openWindows:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A boolean reporting the value of the privacy.clearOnShutdown.openWindows pref.
    expires: "86"
    kind: boolean
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main
  session_permission_exceptions:
    bug_numbers:
      - 1589753
      - 1617241
      - 1645089
    description: >
      A count of how many "session" cookie exceptions a user has set.
    expires: "86"
    kind: uint
    notification_emails:
      - ewright@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - main

downloads:
  panel_shown:
    bug_numbers:
      - 1627676
    description: >
      The count of how many times the downloads panel was shown per session.
    expires: never
    kind: uint
    notification_emails:
      - rtestard@mozilla.com
      - emalysz@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
  file_opened:
    bug_numbers:
      - 1627676
    description: >
      The count of how many times files were opened from the download panel.
    expires: never
    kind: uint
    notification_emails:
      - rtestard@mozilla.com
      - emalysz@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

sandbox:
  no_job:
    bug_numbers:
      - 1392570
    description: >
      Indicates that we can't use a job object for sandboxed child processes.
      Keyed by whether we are in a remote session or not from ::GetSystemMetrics(SM_REMOTESESSION).
    expires: "62"
    kind: boolean
    keyed: true
    notification_emails:
      - bowen@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
    operating_systems:
      - "windows"

findbar:
  shown:
    bug_numbers:
      - 1627688
    description: >
      The count of how many times the "Find toolbar" was shown per session.
    expires: never
    kind: uint
    notification_emails:
      - rtestard@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  find_prev:
    bug_numbers:
      - 1627688
    description: >
      The count of how many times the find previous button was used per session.
    expires: never
    kind: uint
    notification_emails:
      - rtestard@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  find_next:
    bug_numbers:
      - 1627688
    description: >
      The count of how many times the find next button was used per session.
    expires: never
    kind: uint
    notification_emails:
      - rtestard@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  highlight_all:
    bug_numbers:
      - 1627688
    description: >
      The count of how many times the "Highlight All" button was used in find toolbar.
    expires: never
    kind: uint
    notification_emails:
      - rtestard@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  match_case:
    bug_numbers:
      - 1627688
    description: >
      The count of how many times the "Match Case" button was used in find toolbar.
    expires: never
    kind: uint
    notification_emails:
      - rtestard@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  match_diacritics:
    bug_numbers:
      - 1627688
    description: >
      The count of how many times the "Match Diacritics" button was used in find toolbar.
    expires: never
    kind: uint
    notification_emails:
      - rtestard@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  whole_words:
    bug_numbers:
      - 1627688
    description: >
      The count of how many times the "Whole Words" button was used in find toolbar.
    expires: never
    kind: uint
    notification_emails:
      - rtestard@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

sidebar:
  search:
    bug_numbers:
      - 1648524
    description: >
      The number of searches from the sidebar, per view (e.g.: bookmarks, history).
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - emalysz@mozilla.com
      - rtestard@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

os.environment:
  is_admin_without_uac:
    bug_numbers:
      - 1567219
    description: >
      Indicates that the process is lauched with Admin privileges but without
      UAC.
    expires: never
    kind: boolean
    notification_emails:
      - tkikuchi@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main
    operating_systems:
      - "windows"

pictureinpicture:
  opened_method:
    bug_numbers:
      - 1560590
      - 1616045
    description: >
      The number of times a Picture-in-Picture window was opened, per trigger
      mechanism (e.g.: the video toggle, the context menu).
    expires: "82"
    kind: uint
    keyed: true
    notification_emails:
      - mconley@mozilla.com
      - astevenson@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - content
  closed_method:
    bug_numbers:
      - 1560590
      - 1616045
    description: >
      The number of times a Picture-in-Picture window was closed, per trigger
      mechanism (e.g.: the close button, the unpip button, originating tab going away,
      process shutdown, etc).
    expires: "82"
    kind: uint
    keyed: true
    notification_emails:
      - mconley@mozilla.com
      - astevenson@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main
  saw_toggle:
    bug_numbers:
      - 1657155
    description: >
      The number of times a Picture-in-Picture toggle was presented to the user when
      they hovered the video with the mouse pointer.
    expires: "87"
    kind: uint
    notification_emails:
      - mconley@mozilla.com
      - astevenson@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - content

preferences:
  created_new_user_prefs_file:
    bug_numbers:
      - 1367813
    description: >-
      A boolean indicating that profile/prefs.js was not found and it is being
      created for the first time in this session.
    expires: "62"
    kind: boolean
    notification_emails:
      - bsmedberg@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  prefs_file_was_invalid:
    bug_numbers:
      - 1367813
    description: >-
      Set to true if a failure occurred reading profile/prefs.js.
    expires: "62"
    kind: boolean
    notification_emails:
      - bsmedberg@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  read_user_js:
    bug_numbers:
      - 1367813
    description: >-
      Set to true if user.js exists and was read.
    expires: "62"
    kind: boolean
    notification_emails:
      - bsmedberg@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  search_query:
    bug_numbers:
      - 1359306
    description: >-
      Each key is a search query string when user performs a search action within
      about:preferences, and each value is the number of times that key is recorded.
      The telemetry data will be recorded if there is a successful search result highlighted.
    expires: "62"
    kind: uint
    keyed: true
    notification_emails:
      - chsiang@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  browser_home_page_change:
    bug_numbers:
      - 1392951
    description: >-
      The number of times the home page has been changed.
      Recorded when a user changes his/her home page successfully.
    expires: "62"
    kind: uint
    keyed: true
    notification_emails:
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  browser_home_page_count:
    bug_numbers:
      - 1392951
    description: >-
      Each key is the number of home page urls when users change their home page,
      multiple home pages can be set (delineated with a "|"),
      and each value is the number of times that key is recorded.
      The telemetry data will be recorded if a user changes his/her home page successfully.
    expires: "62"
    kind: uint
    keyed: true
    notification_emails:
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  use_current_page:
    bug_numbers:
      - 1392951
    description: >-
      The number of times the Use Current Page button has been clicked.
      Recorded when a a user clicks the "Use Current Page" button.
    expires: "62"
    kind: uint
    keyed: true
    notification_emails:
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  use_bookmark:
    bug_numbers:
      - 1392951
    description: >-
      The number of times the "Use Bookmark..." button has been clicked.
      Recorded when a a user clicks the "Use Bookmark..." button.
    expires: "62"
    kind: uint
    keyed: true
    notification_emails:
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
  prevent_accessibility_services:
    bug_numbers:
      - 1412358
    description: >
      Recorded on command event. Boolean stating if the preference checkbox for
      preventing accessibility from accessing the browser (Privacy & Security)
      was checked.
    expires: "62"
    kind: boolean
    notification_emails:
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

webrtc.video:
  recv_codec_used:
    bug_numbers:
      - 1556766
    description: >
      The video codec used for receiving video on a WebRTC call.
    expires: "never"
    kind: uint
    keyed: true
    notification_emails:
      - dminor@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'content'

  send_codec_used:
    bug_numbers:
      - 1556766
    description: >
      The video codec used for sending video on a WebRTC call.
    expires: "never"
    kind: uint
    keyed: true
    notification_emails:
      - dminor@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'content'

webrtc.sdp:
  parser_diff:
    bug_numbers:
      - 1432955
      - 1529787
      - 1588571
    description: >
      The number of differences between the C based sipcc SDP parser and
      the new rust based rsdparsa SDP parser keyed by predefined
      names of attributes and values that do not match between
      the sipcc parsing result and the rsdparsa parsing result or
      between the rsdparsa parsing result and the original sdp.
      This should help to improve the new rsdparsa to replace
      the sipcc parser.
    expires: "77"
    kind: uint
    keyed: true
    notification_emails:
      - nohlmeier@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'content'

mathml:
  doc_count:
    bug_numbers:
      - 1362187
      - 1538985
      - 1590350
    description: >
      The number of documents that contained enabled MathML elements.
    expires: never
    kind: uint
    notification_emails:
      - emilio@mozilla.com
      - fred.wang@free.fr
      - dev-tech-layout@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'content'

mediarecorder:
  recording_count:
    bug_numbers:
      - 1400757
      - 1429765
      - 1480589
      - 1532391
    description: >
      The number of times a MediaRecorder has been started. Recorded when a MediaRecorder starts
    expires: "72"
    kind: uint
    notification_emails:
      - bvandyk@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
      - content

media:
  page_count:
    bug_numbers:
      - 1476456
      - 1499803
      - 1570634
    description: >
      The number of times a top level document is loaded.
    expires: "74"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - content

  page_had_media_count:
    bug_numbers:
      - 1476456
      - 1499803
      - 1570634
    description: >
      The number of times a document hierarchy contained at least one audible HTMLMediaElement that had play() called upon it.
    expires: "74"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - content

  autoplay_would_not_be_allowed_count:
    bug_numbers:
      - 1476456
      - 1499803
      - 1570634
    description: >
      The number of HTMLMediaElement autoplays on audible HTMLMediaElements which would not be allowed to play if block autoplay was enabled; we'd either prompt for permission to play or block outright depending on user preferences.
    expires: "74"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - content

  autoplay_would_be_allowed_count:
    bug_numbers:
      - 1476456
      - 1499803
      - 1570634
    description: >
      The number of HTMLMediaElement autoplays on audible HTMLMediaElements that would have been allowed (not blocked) by the autoplay policy if block autoplay was enabled.
    expires: "74"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - content

# The following section contains content process base counters.
dom.contentprocess:
  buildID_mismatch:
    bug_numbers:
      - 1366808
    description: >
      The number of times the about:restartrequired page appeared due to a
      buildID mismatch between the parent and the content processes.
    expires: never
    kind: uint
    notification_emails:
      - spohl@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  os_priority_lowered:
    bug_numbers:
      - 1538987
    description: >
      The number of times a content process has had its OS priority lowered
      due to only containing background tabs without audible media playing.
    expires: never
    kind: uint
    notification_emails:
      - mconley@mozilla.com
      - gsvelto@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  os_priority_raised:
    bug_numbers:
      - 1538987
    description: >
      The number of times a content process has had its OS priority raised
      due to containing at least one foregrounded tab, or a tab with audible
      media has started playing in it.
    expires: never
    kind: uint
    notification_emails:
      - mconley@mozilla.com
      - gsvelto@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  os_priority_change_considered:
    bug_numbers:
      - 1538987
    description: >
      The number of times we've had the opportunity to change content process
      priority due to a tab switch or a tab being opened.
    expires: never
    kind: uint
    notification_emails:
      - mconley@mozilla.com
      - gsvelto@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

# The following section contains parent process base counters.
dom.parentprocess:
  private_window_used:
    bug_numbers:
      - 1491047
    description: >
      Whether a private browsing window has been used in the session.
    expires: never
    kind: boolean
    notification_emails:
      - seceng-telemetry@mozilla.com
      - ehsan+telemetry@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

# The following section contains scalars related to DOM IPC messages.
dom.ipc:
  rejected_window_actor_message:
    bug_numbers:
      - 1604609
    description: Each key is the window actor name followed by the message name, with digits removed, that was rejected for being over approximately 256MB, recorded in the sending process at the time of sending.
    expires: "83"
    kind: uint
    notification_emails:
      - amccreight@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
      - 'content'
    keyed: true

devtools.toolbar.eyedropper:
  opened:
    bug_numbers:
      - 1247985
      - 1352115
    description: Number of times the DevTools Eyedropper has been opened via the inspector toolbar.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.copy.unique.css.selector:
  opened:
    bug_numbers:
      - 1323700
      - 1352115
      - 1566395
    description: Number of times the DevTools copy unique CSS selector has been used.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - mbalfanz@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.copy.full.css.selector:
  opened:
    bug_numbers:
      - 1323700
      - 1352115
      - 1566395
    description: Number of times the DevTools copy full CSS selector has been used.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - mbalfanz@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.copy.xpath:
  opened:
    bug_numbers:
      - 987877
      - 1566395
    description: Number of times the DevTools copy XPath has been used.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - mbalfanz@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.layout.flexboxhighlighter:
  opened:
    bug_numbers:
      - 1509907
    description: >
      Number of times the DevTools flexbox highlighter was activated from the layout view.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.markup.flexboxhighlighter:
  opened:
    bug_numbers:
      - 1509907
    description: >
      Number of times the DevTools flexbox highlighter was activated from the markup view.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.rules.flexboxhighlighter:
  opened:
    bug_numbers:
      - 1509907
    description: >
      Number of times the DevTools flexbox highlighter was activated from the rules view.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.markup.gridinspector:
  opened:
    bug_numbers:
      - 1509907
    description: >
      Number of times the DevTools grid inspector was opened from the markup view.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.rules.gridinspector:
  opened:
    bug_numbers:
      - 1373483
    description: >
      Number of times the DevTools grid inspector was opened from the rules view.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.grid.gridinspector:
  opened:
    bug_numbers:
      - 1373483
    description: >
      Number of times the DevTools grid inspector was opened from the grid view.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.grid.showGridAreasOverlay:
  checked:
    bug_numbers:
      - 1373483
    description: >
      Number of times the DevTools grid inspector's "Display grid areas" was checked.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.grid.showGridLineNumbers:
  checked:
    bug_numbers:
      - 1373483
    description: >
      Number of times the DevTools grid inspector's "Display grid numbers" was checked.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.grid.showInfiniteLines:
  checked:
    bug_numbers:
      - 1373483
    description: >
      Number of times the DevTools grid inspector's "Extend grid lines infinitely" was checked.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.inspector:
  three_pane_enabled:
    bug_numbers:
      - 1437881
      - 1566395
    description: >
      Number of times the DevTools inspector was opened with the 3 pane inspector enabled,
      keyed by true/false.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - gl@mozilla.com
      - mbalfanz@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  node_selection_count:
    bug_numbers:
      - 1550794
    description: >
      Number of times a different node is marked as selected in the Inspector regardless
      of the cause: context menu, manual selection in markup view, etc.
    expires: "never"
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - mbalfanz@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.shadowdom:
  shadow_root_displayed:
    bug_numbers:
      - 1470128
      - 1566393
    description: >
      Whether the markup view displayed any #shadow-root element in the UI.
    expires: "never"
    kind: boolean
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jdescottes@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  shadow_root_expanded:
    bug_numbers:
      - 1470128
      - 1566393
    description: >
      Whether the user expanded any #shadow-root element.
    expires: "never"
    kind: boolean
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jdescottes@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  reveal_link_clicked:
    bug_numbers:
      - 1470128
      - 1566393
    description: >
      Whether the user clicked on any "reveal" link. "reveal" links are displayed in
      shadow dom trees in the markup view.
    expires: "never"
    kind: boolean
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jdescottes@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools:
  current_theme:
    bug_numbers:
      - 1396811
    description: >
      Number of times DevTools was opened, keyed by theme.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.tooltip:
  shown:
    bug_numbers:
      - 1553471
    description: >
      Number of times a tooltip was shown, keyed by tooltip type. Currently supported types are "image", "font-family", "inactive-css" and "variable."
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.responsive:
  toolbox_opened_first:
    bug_numbers:
      - 1444497
    description: >
      Number of Responsive Design Mode opens with a toolbox already open.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jryans@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
    release_channel_collection: opt-out
  open_trigger:
    bug_numbers:
      - 1444497
    description: >
      Number of Responsive Design Mode opens keyed by the UI entry point used.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jryans@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
    release_channel_collection: opt-out

devtools.tool:
  registered:
    bug_numbers:
      - 1447302
      - 1503568
      - 1587985
    description: >
      Recorded on enable tool checkbox check/uncheck in Developer Tools options
      panel. Boolean stating if the tool was enabled or disabled by the user.
      Keyed by tool id. Current default tools with their id's are defined in
      https://dxr.mozilla.org/mozilla-central/source/devtools/client/definitions.js
    expires: never
    kind: boolean
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.accessibility:
  node_inspected_count:
    bug_numbers:
      - 1447302
      - 1503568
      - 1587985
    description: >
      Number of times a DOM node was inspected from within the Accessibility
      tool.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  opened_count:
    bug_numbers:
      - 1447302
      - 1503568
      - 1587985
    description: >
      Number of times the DevTools Accessibility tool has been opened.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  picker_used_count:
    bug_numbers:
      - 1447302
      - 1503568
      - 1587985
    description: >
      Number of times the picker tool has been used in DevTools Accessibility
      panel.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  select_accessible_for_node:
    bug_numbers:
      - 1447302
      - 1503568
      - 1587985
    description: >
      Number of times an accessible object was inspected from outside the
      Accessibility tool (navigation to Accessibility panel). Keyed by the
      source of user action (inspector context menu, browser context menu, etc).
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  service_enabled_count:
    bug_numbers:
      - 1447302
      - 1503568
      - 1587985
    description: >
      Number of times platform accessibility has been enabled in DevTools
      Accessibility panel.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  accessible_context_menu_opened:
    bug_numbers:
      - 1507870
      - 1587985
    description: >
      Number of times a context menu was opened for an accessible object in the
      accessibility tree.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  accessible_context_menu_item_activated:
    bug_numbers:
      - 1507870
      - 1587985
    description: >
      Number of times a context menu item for an accessible object was activated (with
      mouse or keyboard) from the context menu opened in the accessibility tree. Keyed by
      the id of the context menu item.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  audit_activated:
    bug_numbers:
      - 1548241
      - 1587985
    description: >
      Number of times accessibility audit was activated (with mouse or keyboard)
      from the accessibility panel's toolbar. Keyed by the audit filter type
      (e.g. "CONTRAST").
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  simulation_activated:
    bug_numbers:
      - 1567200
      - 1587985
    description: >
      Number of times accessibility simulation was activated (with mouse or keyboard)
      from the accessibility panel's toolbar. Keyed by the simulation type
      (e.g. "DEUTERANOPIA").
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
      - mislam@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.application:
  opened_count:
    bug_numbers:
      - 1451734
    description: >
      Number of times the DevTools Application panel has been opened.
    expires: "66"
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jdescottes@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.toolbox:
  tabs_reordered:
    bug_numbers:
      - 1456551
      - 1566362
    description: >
      Number of times the DevTools tab was reordered.
      Keyed by tab's id.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - daisuke@mozilla.com
      - hkirschner@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

devtools.changesview:
  opened_count:
    bug_numbers:
      - 1509890
    description: >
      Number of times the Changes panel has been opened.
    expires: never
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - mbalfanz@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

dom.event:
  confluence_load_count:
    bug_numbers:
      - 1514940
    description: >
      Number of times Confluence instances are loaded, and whether they are
      compatible with conflated keypress event model or not, using "new"/"old".
      I.e., collecting percentage of too old Confluence instance use count in
      all Confluence instance use count.
    expires: "71"
    keyed: true
    kind: uint
    notification_emails:
      - mnakano@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'content'

  office_online_load_count:
    bug_numbers:
      - 1545410
    description: >
      Number of times Office Online Server instances are loaded, and whether
      they are compatible with conflated keypress event model or not, using
      "new"/"old".  I.e., collecting percentage of too old Confluence instance
      use count in all Office Online Server instance use count.
    expires: "71"
    keyed: true
    kind: uint
    notification_emails:
      - mnakano@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'content'

navigator.storage:
  estimate_count:
    bug_numbers:
      - 1359708
    description: >
      Number of times navigator.storage.estimate has been used.
    expires: "60"
    kind: uint
    notification_emails:
      - shuang@mozilla.com
      - ttung@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
      - 'content'

  persist_count:
    bug_numbers:
      - 1359708
    description: >
      Number of times navigator.storage.persist has been used.
    expires: "60"
    kind: uint
    notification_emails:
      - shuang@mozilla.com
      - ttung@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
      - 'content'

telemetry:
  accumulate_unknown_histogram_keys:
    bug_numbers:
      - 1343855
    description: >
      The count of attempted accumulations to unknown histogram keys for
      histograms that restrict the set of allowed keys ('keys' property).
      The names of the offending histograms are used as keys in this probe.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - all

  accumulate_clamped_values:
    bug_numbers:
      - 1438335
    description: >
      The count of accumulations that had to be clamped down to not overflow,
      keyed to the histogram name of the overflowing accumulation.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
      - chutten@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  event_counts:
    bug_numbers:
      - 1440673
    description: >
      The counts of events recorded in the process, category, method, and
      object of the key, even if event recording for the category was not
      enabled.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
      - chutten@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'all'

  profile_directory_scans:
    bug_numbers:
      - 1458574
    description: >
      The number of times a profile directory scan was initiated in ProfileAge.jsm
    expires: "65"
    kind: uint
    notification_emails:
      - jrediger@mozilla.com
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'all'

  profile_directory_scan_date:
    bug_numbers:
      - 1466518
    description: >
      The date of the profile scan to determine the profile creation date from the oldest file, in days since UNIX epoch.
    expires: "65"
    kind: uint
    notification_emails:
      - jrediger@mozilla.com
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  data_upload_optin:
    bug_numbers:
      - 1445921
    description: >
      User opted into sending Telemetry data again.
    expires: "never"
    kind: boolean
    notification_emails:
      - jrediger@mozilla.com
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  keyed_scalars_exceed_limit:
    bug_numbers:
      - 1451813
    description: >
      The number of times keyed scalars exceeded the number of keys limit, keyed by scalar name.
    expires: "never"
    kind: uint
    keyed: true
    notification_emails:
      - chutten@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  keyed_scalars_unknown_keys:
    bug_numbers:
      - 1365529
    description: >
      The count of attempted accumulations to unknown scalar keys for
      scalars that restrict the set of allowed keys ('keys' property).
      The names of the offending scalars are used as keys in this probe.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
      - brizental@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - all

  about_telemetry_pageload:
    bug_numbers:
      - 1512503
    description: >
      The number of times about:telemetry was loaded.
    expires: "70"
    kind: uint
    notification_emails:
      - chutten@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  process_creation_timestamp_inconsistent:
    bug_numbers:
      - 1514392
    description: >
      The number of times ProcessCreation saw an inconsistent value.
    expires: "72"
    kind: uint
    notification_emails:
      - jrediger@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
      - 'content'

telemetry.discarded:
  accumulations:
    bug_numbers:
      - 1369041
    description: >
      Number of discarded accumulations to histograms in child processes
    expires: "never"
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'all_childs'
  keyed_accumulations:
    bug_numbers:
      - 1369041
    description: >
      Number of discarded accumulations to keyed histograms in child processes
    expires: "never"
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'all_childs'
  scalar_actions:
    bug_numbers:
      - 1369041
    description: >
      Number of discarded actions on scalars in child processes
    expires: "never"
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'all_childs'
  keyed_scalar_actions:
    bug_numbers:
      - 1369041
    description: >
      Number of discarded actions on keyed scalars in child processes
    expires: "never"
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'all_childs'
  child_events:
    bug_numbers:
      - 1369041
    description: >
      Number of discarded events in child processes
    expires: "never"
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'all_childs'

normandy:
  recipe_freshness:
    bug_numbers:
      - 1530508
    description: >
      For each recipe ID seen by the Normandy client, its last_modified.
    expires: "never"
    keyed: true
    kind: uint
    notification_emails:
      - product-delivery@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main

# The following section contains graphics-related scalars.
gfx.advanced.layers:
  failure_id:
    bug_numbers:
      - 1365879
    description: >
      Each key is a failure for initializing Advanced Layers, and each value
      is the number of times that failure was recorded. The failure codes
      are unique strings present in MLGDeviceD3D11::Initialize, such that
      a failure can be traced back to a specific Direct3D API call.
    keyed: true
    kind: uint
    expires: "70"
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - rhunt@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

gfx.omtp:
  paint_wait_ratio:
    bug_numbers:
      - 1386968
      - 1518669
    description: >
      Ratio (in units of 1/100th of a percent) of how many times OMTP waited
      for a paint for more than 200us, versus the total number of paints.
    keyed: false
    kind: uint
    expires: "never"
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - rhunt@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'content'

gfx.canvas.remote:
  activated:
    bug_numbers:
      - 1641722
    description: >
      Number of times remote canvas 2D has been activated.
    kind: uint
    expires: "85"
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - bowen@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'gpu'

  deactivated_no_device:
    bug_numbers:
      - 1641722
    description: >
      Number of times remote canvas 2D has been deactivated due to device creation failure.
    kind: uint
    expires: "85"
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - bowen@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'gpu'

  deactivated_bad_stream:
    bug_numbers:
      - 1641722
    description: >
      Number of times remote canvas 2D has been deactivated due to a stream read failure.
    kind: uint
    expires: "85"
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - bowen@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'gpu'

gfx.hdr:
  windows_display_colorspace_bitfield:
    bug_numbers:
      - 1514840
    description: >
      A bitfield representation of the available DXGI color spaces of the connected displays on Windows.
      See (https://docs.microsoft.com/en-us/windows/desktop/api/dxgicommon/ne-dxgicommon-dxgi_color_space_type)
      for definitions of color spaces. Each N'th bit of this scalar indicates whether the DXGI color space with
      index 'N' is available on at least one connected monitor.
    keyed: false
    kind: uint
    expires: "70"
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - rhunt@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'


gfx.display:
  count:
    bug_numbers:
      - 1594145
    description: >
      Number of displays connected to the device
    expires: never
    kind: uint
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  primary_width:
    bug_numbers:
      - 1594145
    description: >
      Width of the primary display, takes device rotation into account.
    expires: never
    kind: uint
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  primary_height:
    bug_numbers:
      - 1594145
    description: >
      Height of the primary display, takes device rotation into account.
    expires: never
    kind: uint
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
gfx.adapter:
  description:
    bug_numbers:
      - 1594145
    description: >
      Long form description of the Graphics adapter
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  vendor_id:
    bug_numbers:
      - 1594145
    description: >
      Graphics adapter vendor identification
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  device_id:
    bug_numbers:
      - 1594145
    description: >
      Graphics adapter device identification
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  subsystem_id:
    bug_numbers:
      - 1594145
    description: >
      Graphics adapter subsystem identification
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  ram:
    bug_numbers:
      - 1594145
    description: >
      Graphics adapter dedicated memory
    expires: never
    kind: uint
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  driver_files:
    bug_numbers:
      - 1594145
    description: >
      List of graphics adapter driver files
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  driver_vendor:
    bug_numbers:
      - 1594145
    description: >
      Graphics adapter driver vendor identification
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  driver_version:
    bug_numbers:
      - 1594145
    description: >
      Graphics adapter driver version
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  driver_date:
    bug_numbers:
      - 1594145
    description: >
      Graphics adapter driver date
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
gfx:
  compositor:
    bug_numbers:
      - 1594145
    description: >
      Name of the graphics compositor in use. possible values are "opengl, d3d11, client, webrender or basic"
    expires: never
    kind: string
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  headless:
    bug_numbers:
      - 1594145
    description: >
      Boolean indicated whether graphics is running in headless (no display) mode
    expires: never
    kind: boolean
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - ktaeleman@mozilla.com
    products:
      - 'geckoview_streaming'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out
  os_compositor:
    bug_numbers:
      - 1623492
    description: >
      Boolean indicating whether the os compositor is being used by WebRender.
      Only collected in the first subsession.
    expires: never
    kind: boolean
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - jmuizelaar@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out

# The following section contains the form autofill related scalars.
formautofill:
  availability:
    bug_numbers:
      - 1386959
    description: A boolean sent once per session to represent whether the formautofill is available in the build
    expires: never
    kind: boolean
    notification_emails:
      - autofill@lists.mozilla.org
      - jcheng@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

formautofill.addresses:
  fill_type_manual:
    bug_numbers:
      - 990200
    description: Count at submission time whether the submitted form was filled manually.
    expires: never
    kind: uint
    notification_emails:
      - autofill@lists.mozilla.org
      - jcheng@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  fill_type_autofill:
    bug_numbers:
      - 990200
    description: Count at submission time whether the submitted form was autofilled.
    expires: never
    kind: uint
    notification_emails:
      - autofill@lists.mozilla.org
      - jcheng@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  fill_type_autofill_update:
    bug_numbers:
      - 990200
    description: >
      Count at submission time whether the submitted form was autofilled, but
      the data in form is changed and can not be merged to orginal address profile.
    expires: never
    kind: uint
    notification_emails:
      - autofill@lists.mozilla.org
      - jcheng@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

formautofill.creditCards:
  fill_type_manual:
    bug_numbers:
      - 1371232
    description: Count at submission time whether the submitted credit card form was filled manually.
    expires: never
    kind: uint
    notification_emails:
      - autofill@lists.mozilla.org
      - jcheng@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  fill_type_autofill:
    bug_numbers:
      - 1371232
    description: Count at submission time whether the submitted credit card form was autofilled.
    expires: never
    kind: uint
    notification_emails:
      - autofill@lists.mozilla.org
      - jcheng@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  fill_type_autofill_modified:
    bug_numbers:
      - 1371232
    description: >
      Count at submission time whether the submitted credit card form was autofilled but
      the data in form is changed.
    expires: never
    kind: uint
    notification_emails:
      - autofill@lists.mozilla.org
      - jcheng@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
  autofill_profiles_count:
    bug_numbers:
      - 990203
    description: >
      Count at store time how many credit card autofill profiles user has.
    expires: never
    kind: uint
    notification_emails:
      - autofill@lists.mozilla.org
      - jmathies@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
  detected_sections_count:
    bug_numbers:
      - 1656344
    description: >
      Count at detection time number of credit card form sections.
      A single form can contain more than one credit card form section.
    expires: never
    kind: uint
    notification_emails:
      - autofill@lists.mozilla.org
      - jmathies@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'content'
  submitted_sections_count:
    bug_numbers:
      - 1656344
    description: >
      Count at submission time number of credit card form sections submitted.
    expires: never
    kind: uint
    notification_emails:
      - autofill@lists.mozilla.org
      - jmathies@mozilla.com
      - chsiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'content'

# The following section contains scalars for Screenshots.
screenshots:
  download:
    bug_numbers:
      - 1412411
    description: >
      The count of new screenshots created, then downloaded per session
      via the Firefox Screenshots feature. Excludes failed attempts due
      to any error.
    expires: never
    kind: uint
    notification_emails:
      - jhirsch@mozilla.com
      - ibicking@mozilla.com
      - clouserw@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  upload:
    bug_numbers:
      - 1412411
    description: >
      The count of new screenshots created, then uploaded per session
      via the Firefox Screenshots feature. Excludes attempts to create
      and upload the screenshot that may have failed.
    expires: never
    kind: uint
    notification_emails:
      - jhirsch@mozilla.com
      - ibicking@mozilla.com
      - clouserw@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  copy:
    bug_numbers:
      - 1412411
    description: >
      The count of new screenshots created, then copied directly to the
      clipboard per session via the Firefox Screenshots feature.
    expires: never
    kind: uint
    notification_emails:
      - jhirsch@mozilla.com
      - ibicking@mozilla.com
      - clouserw@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

# The following section is for tracking the number of failure for indexedDB.
idb.failure:
  fileinfo_error:
    bug_numbers:
      - 1432133
    description: >
      Tracking the number of failure due to missing fileInfo while doing
      structured clone.
    expires: "70"
    kind: uint
    notification_emails:
      - ttung@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

# The following section contains scalars for the PDF viewer.
pdf.viewer:
  used:
    bug_numbers:
      - 1566882
    description: >
      How many times PDF Viewer was used.
    expires: never
    kind: uint
    notification_emails:
      - bdahl@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
      - 'content'
  fallback_shown:
    bug_numbers:
      - 1566882
    description: >
      How many times PDF Viewer fallback bar was shown.
    expires: "84"
    kind: uint
    notification_emails:
      - bdahl@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
      - 'content'
  print:
    bug_numbers:
      - 1566882
    description: >
      How many times PDF Viewer print functionality was used.
    expires: "84"
    kind: uint
    notification_emails:
      - bdahl@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
      - 'content'

# The following section contains scalars for the Unknown Content Type (Helper App) dialog.
unknowncontenttype:
  pdf_action:
    bug_numbers:
      - 773942
    description: >
      A counter incremented every time a user uses the Unknown Content Type dialog
      for PDF files, with counts grouped by action chosen (see keys). Some external
      applications that have very high adoption are counted specifically.
      Note: 'OPEN_WITH_SYSTEM_DEFAULT' may eventually resolve to one of Acrobat, Foxit, MsEdge, Chromium, etc.
    keyed: true
    keys:
      - 'OPEN_WITH_INTERNAL_HANDLER'
      - 'OPEN_WITH_SYSTEM_DEFAULT'
      - 'OPEN_WITH_ACROBAT'
      - 'OPEN_WITH_FOXIT'
      - 'OPEN_WITH_MSEDGE'
      - 'OPEN_WITH_CHROMIUM'
      - 'OPEN_WITH_PREVIEW'
      - 'OPEN_WITH_OTHER'
      - 'SAVE'
      - 'CANCEL'
    expires: "85"
    kind: uint
    notification_emails:
      - jaws@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

# The following section contains scalars for printing.
printing:
  dialog_opened_without_preview:
    bug_numbers:
      - 1600623
    description: >
      A counter incremented every time the print dialog is opened without
      opening print preview.
    expires: never
    kind: uint
    notification_emails:
      - jwatt@jwatt.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'content'

  dialog_without_preview_cancelled:
    bug_numbers:
      - 1600623
    description: >
      A counter incremented every time a print dialog that was opened without
      print preview is cancelled.
    expires: never
    kind: uint
    notification_emails:
      - jwatt@jwatt.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'content'

  dialog_opened_via_preview:
    bug_numbers:
      - 1600623
    description: >
      A counter incremented every time the print dialog is opened from print
      preview.
    expires: never
    kind: uint
    notification_emails:
      - jwatt@jwatt.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'content'

  dialog_via_preview_cancelled:
    bug_numbers:
      - 1600623
    description: >
      A counter incremented every time a print dialog opened from print preview
      is cancelled.
    expires: never
    kind: uint
    notification_emails:
      - jwatt@jwatt.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'content'

  error:
    bug_numbers:
      - 1630105
    description: >
      A counter incremented every time the user encounters an error printing.
      The result is split into keys which represent the values of
      error codes related to printing. Possible values are listed in 'keys'.
      "FAILURE" is a catch-all code for an error we don't recognize.
    keyed: true
    keys:
      - 'GFX_PRINTER_NO_PRINTER_AVAILABLE'
      - 'GFX_PRINTER_NAME_NOT_FOUND'
      - 'GFX_PRINTER_COULD_NOT_OPEN_FILE'
      - 'GFX_PRINTER_STARTDOC'
      - 'GFX_PRINTER_ENDDOC'
      - 'GFX_PRINTER_STARTPAGE'
      - 'GFX_PRINTER_DOC_IS_BUSY'
      - 'ABORT'
      - 'NOT_AVAILABLE'
      - 'NOT_IMPLEMENTED'
      - 'OUT_OF_MEMORY'
      - 'UNEXPECTED'
      - 'FAILURE'
    expires: never
    kind: uint
    notification_emails:
      - jaws@mozilla.com
      - jwatt@jwatt.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  preview_opened:
    bug_numbers:
      - 1600623
    description: >
      A counter incremented every time the user initiates print preview.
    expires: never
    kind: uint
    notification_emails:
      - jwatt@jwatt.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'content'

  preview_cancelled:
    bug_numbers:
      - 1600623
    description: >
      A counter incremented every time a print preview session exits without
      printing.
    expires: never
    kind: uint
    notification_emails:
      - jwatt@jwatt.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'content'

  silent_print:
    bug_numbers:
      - 1600623
    description: >
      A counter incremented every time a silent print (a print without a
      print settings dialog being opened) is initiated.  This happens when
      extensions invoke ExtensionAPI.tabs.saveAsPDF, for example, or when the
      print.always_print_silent pref is set.
    expires: never
    kind: uint
    notification_emails:
      - jwatt@jwatt.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'content'

  target_type:
    bug_numbers:
      - 1600623
    description: >
      A counter incremented every time the user prints to a certain target
      type.  The 'pdf_unknown' count is for printers with names that we don't
      know about/check for, but that have 'pdf' in their name, and is mainly a
      sanity check that we're not missing significant counts in 'pdf_file'.
      For the most part, the 'unknown' count will be prints to a physical
      printer, but we can't know for sure since third party drivers could also
      be print to file drivers that we don't otherwise catch in the other
      counts.
    keyed: true
    keys:
      - 'pdf_file'
      - 'pdf_unknown'
      - 'xps_file'
      - 'unknown'
    expires: never
    kind: uint
    notification_emails:
      - jwatt@jwatt.org
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

# The following section contains probes that record timestamps.
timestamps:
  first_paint:
    bug_numbers:
      - 1386186
    description: >
     Record the timestamp of the first content window paint, in milliseconds since process start.
    expires: never
    kind: uint
    notification_emails:
      - hkirschner@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main

  first_paint_two:
    bug_numbers:
      - 1556568
    description: >
     Record the timestamp of the first main window paint, in milliseconds since process start.
     Intended to replace first_paint since first_paint is broken.
    expires: never
    kind: uint
    notification_emails:
      - hkirschner@mozilla.com
      - gfx-telemetry-alerts@mozilla.com
    release_channel_collection: opt-out
    products:
      - firefox
      - fennec
    record_in_processes:
      - main

  about_home_topsites_first_paint:
    bug_numbers:
      - 1518521
    description: >
      Record the timestamp of when the first about:home's Topsites are painted. Only records if
      about:home is set as the default homepage, and if sessions are not being restored by default.
    expires: never
    kind: uint
    notification_emails:
      - mconley@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main

browser.timings:
  last_shutdown:
    bug_numbers:
      - 1429510
    description: >
      The time, in milliseconds, it took to complete the last shutdown.
      On successful shutdown, Telemetry saves this to disk into Telemetry.ShutdownTime.txt.
      On the next startup this is loaded and recorded.
    expires: never
    kind: uint
    notification_emails:
      - florian@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

# The following section contains the service worker scalars.
sw:
  synthesized_res_count:
    bug_numbers:
      - 1416629
      - 1433916
    description: >
      The count of number of synthesize response made by service workers.
    expires: "68"
    kind: uint
    notification_emails:
      - sw-telemetry@mozilla.com
      - ttung@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
      - 'content'

  cors_res_for_so_req_count:
    bug_numbers:
      - 1416629
    description: >
      The count of number of synthesize response made by service workers and
      it's a cors type resposne for a same-origin mode request.
    expires: "61"
    kind: uint
    notification_emails:
      - sw-telemetry@mozilla.com
      - ttung@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
      - 'content'

  alternative_body_used_count:
    bug_numbers:
      - 1423623
      - 1433916
    description: >
      The count of number of synthesize response using alternative body.
    expires: "68"
    kind: uint
    notification_emails:
      - sw-telemetry@mozilla.com
      - echuang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
      - 'content'

widget:
  ime_name_on_windows:
    bug_numbers:
      - 1215818
    description: >
      Locale ID and name of IME which was selected by users on Windows.  This
      does NOT collect legacy IMM-IME names since we cannot get readable names
      and we do not support IMM-IME so aggressively because IME vendors
      should've already released TIP for TSF for supporting Windows 8 or later
      completely.
    keyed: true
    expires: never
    kind: boolean
    notification_emails:
      - mnakano@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  dark_mode:
    bug_numbers:
      - 1601846
    description: >
      Whether the OS theme is dark.
    expires: never
    kind: boolean
    notification_emails:
      - layout-telemetry-alerts@mozilla.com
      - cmccormack@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  ime_name_on_mac:
    bug_numbers:
      - 1215818
    description: >
      Name of IME which was selected by users on macOS.  The value is Input
      Source ID if non-Japanese IME was open.  Otherwise, if Japanese IME was
      open, the value is Bundle ID.  Input Source ID includes input mode, but
      Bundle ID does not include input mode.
    keyed: true
    expires: never
    kind: boolean
    notification_emails:
      - mnakano@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  ime_name_on_linux:
    bug_numbers:
      - 1215818
    description: >
      Name of active IM (e.g., xim, fcitx, ibus, etc) which was actually set by
      env on Linux.  Different from Windows and macOS, this value includes
      non-IME users even though this is recoded when first compositionstart
      event because dead key is also implemented by IME on Linux.
    keyed: true
    expires: never
    kind: boolean
    notification_emails:
      - mnakano@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

# The following section contains memory reporter counters.
memoryreporter:
  max_ghost_windows:
    bug_numbers:
      - 1454724
    description: >
      The maximum number of leaked ghost windows seen.
    expires: "66"
    kind: uint
    notification_emails:
      - memshrink-telemetry-alerts@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'content'

update:
  binarytransparencyresult:
    bug_numbers:
      - 1501889
    description: >
      If the binary transparency information for an update does not verify
      successfully, this probe will contain an error code from
      toolkit/mozapps/update/common/updatererrors.h indicating why.
    expires: "73"
    kind: uint
    keyed: true
    notification_emails:
      - application-update-telemetry-alerts@mozilla.com
      - seceng-telemetry@mozilla.com
      - dkeeler@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main

  bitshresult:
    bug_numbers:
      - 1343669
      - 1540193
      - 1520321
    description: >
      If a BITS download fails on the Windows side (that is to say, BITS
      ecounters an error rather than Firefox failing to interact with BITS),
      it will likely give an hresult error indicating what happened. This probe
      reports those error codes to allow us to see if BITS is commonly failing
      on some systems. This probe is keyed on the type of update download,
      either "PARTIAL" or "COMPLETE".
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - application-update-telemetry-alerts@mozilla.com
      - bytesized@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
    operating_systems:
      - windows

  fix_permissions_attempted:
    bug_numbers:
      - 1577317
      - 1615065
    description: Set when we attempt to fix update directory permissions.
    expires: "84"
    kind: boolean
    notification_emails:
      - application-update-telemetry-alerts@mozilla.com
      - agashlin@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main
    operating_systems:
      - windows

# The following section contains search counters.
browser.search:
  with_ads:
    bug_numbers:
      - 1495548
      - 1505411
    description: >
      Records counts of SERP pages with adverts displayed. The key format is ‘<engine-name>’.
    expires: never
    keyed: true
    kind: uint
    notification_emails:
      - fx-search@mozilla.com
      - adw@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main

  ad_clicks:
    bug_numbers:
      - 1495548
      - 1505411
    description: >
      Records clicks of adverts on SERP pages. The key format is ‘<engine-name>’.
    expires: never
    keyed: true
    kind: uint
    notification_emails:
      - fx-search@mozilla.com
      - adw@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main

  data_transferred:
    bug_numbers:
      - 1614777
      - 1619954
    description: >
      Records bytes that have been transferred for search requests, including
      top-level documents, sub-resources, iframes and search suggestions.
      The key format could be one of:
        <search-provider-name>
        <search-provider-name>-pb
        sggt-<search-engine-id>
        sggt-<search-engine-id>-pb
    expires: "82"
    keyed: true
    kind: uint
    notification_emails:
      - gachen@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out

browser.searchinit:
  engines_cache_corrupted:
    bug_numbers:
      - 1578807
      - 1621610
    description: >-
          Whether the list of engines in the search cache was found to be corrupt during initialization.
    expires: "85"
    kind: boolean
    notification_emails:
      - fx-search@mozilla.com
      - mbanner@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main
  init_result_status_code:
    bug_numbers:
      - 1651194
    description: >-
          Status code (nsresult) for the search service initialization routine.
          Stored as a string due to issues with large uint scalars when the scalar was created.
    expires: "87"
    kind: string
    notification_emails:
      - fx-search@mozilla.com
      - mbanner@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main

encoding:
  override_used:
    bug_numbers:
      - 840476
      - 1513473
      - 1554592
      - 1603047
    description: >-
      Whether the Text Encoding menu was used to override an encoding in this subsession.
    expires: "79"
    kind: boolean
    notification_emails:
      - hsivonen@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main
      - content

startup:
  profile_selection_reason:
    bug_numbers:
      - 1522934
      - 1570652
      - 1623406
    description: >
      How the profile was selected during startup. One of the following reasons:
        unknown:
          Generally should not happen, set as a default in case no other reason
          occured.
        profile-manager:
          The profile was selected by the profile manager.
        profile-reset:
          The profile was selected for reset, normally this would mean a restart.
        restart:
          The user restarted the application, the same profile as previous will
          be used.
        argument-profile:
          The profile was selected by the --profile command line argument.
        argument-p:
          The profile was selected by the -p command line argument.
        firstrun-claimed-default:
          A first run of a dedicated profiles build chose the old default
          profile to be the default for this install.
        firstrun-skipped-default:
          A first run of a dedicated profiles build skipped over the old default
          profile and created a new profile.
        restart-claimed-default:
          A first run of a dedicated profiles build after a restart chose the
          old default profile to be the default for this install.
        restart-skipped-default:
          A first run of a dedicated profiles build after a restart skipped over
          the old default profile and created a new profile.
        firstrun-created-default:
          A first run of the application created a new profile to use.
        default:
          The default profile was selected as normal.
    expires: "88"
    keyed: false
    kind: string
    notification_emails:
      - dtownsend@mozilla.com
      - rtestard@mozilla.com
      - gkaberere@mozilla.com
      - jhollek@mozilla.com
      - echo@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - main
    record_into_store:
      - main
      - new-profile

  is_cold:
    bug_numbers:
      - 1542833
    description: >
      Whether or not this startup is the first startup since OS reboot (according to our
      best guess.)
    expires: never
    kind: boolean
    notification_emails:
      - dothayer@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  seconds_since_last_os_restart:
    bug_numbers:
      - 1654063
    description: >
      The time in seconds between the first browser window loading, and the
      time the OS started. This can give us an indication of whether starting
      the browser may have been the first thing the user did after starting
      their computer.
    expires: never
    kind: uint
    notification_emails:
      - dothayer@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

script.preloader:
  mainthread_recompile:
    bug_numbers:
      - 1364235
    description:
      How many times we ended up recompiling a script from the script preloader
      on the main thread.
    expires: "88"
    keyed: false
    kind: uint
    notification_emails:
      - dothayer@mozilla.com
      - plawless@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
      - 'content'

wasm:
  compile_time_baseline_us:
    bug_numbers:
      - 1656638
    description:
      How many microseconds we spent in the baseline WebAssembly compiler.
    expires: "88"
    keyed: false
    kind: uint
    notification_emails:
      - cfallin@mozilla.com
      - bbouvier@mozilla.com
      - jseward@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
      - 'content'

  compile_time_cranelift_us:
    bug_numbers:
      - 1656638
    description:
      How many microseconds we spent in the Cranelift WebAssembly compiler.
    expires: "88"
    keyed: false
    kind: uint
    notification_emails:
      - cfallin@mozilla.com
      - bbouvier@mozilla.com
      - jseward@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  compile_time_ion_us:
    bug_numbers:
      - 1656638
    description:
      How many microseconds we spent in the IonMonkey WebAssembly compiler.
    expires: "88"
    keyed: false
    kind: uint
    notification_emails:
      - cfallin@mozilla.com
      - bbouvier@mozilla.com
      - jseward@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
      - 'content'

js:
  run_time_us:
    bug_numbers:
      - 1656638
    description:
      How many microseconds we spent in running user code in SpiderMonkey,
      including JavaScript code and WebAssembly code.
    expires: "88"
    keyed: false
    kind: uint
    notification_emails:
      - cfallin@mozilla.com
      - bbouvier@mozilla.com
      - jseward@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
      - 'content'

networking:
  nss_initialization:
    bug_numbers:
      - 1628734
    description:
      The time in milliseconds to initialize the NSS component in the
      parent process.
    expires: "never"
    keyed: false
    kind: uint
    notification_emails:
      - mconley@mozilla.com
      - dkeeler@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  loading_certs_task:
    bug_numbers:
      - 1628734
    description:
      The time in milliseconds to load any external certificates. This occurs
      off of the main-thread, but can block main-thread operations.
    expires: "never"
    keyed: false
    kind: uint
    notification_emails:
      - mconley@mozilla.com
      - dkeeler@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  data_transferred_v3_kb:
    bug_numbers:
      - 1533363
      - 1546903
      - 1546796
      - 1546906
      - 1550756
      - 1572666
      - 1590124
      - 1621800
    description: >
      How many KB of HTTP data transferred by type, there are some categories
      separated by keys based on 5 parameters:
        1. normal browsing or private browsing
        2. system principal or not
        3. first party or third party
        4. class of service (Leader/Background/Others)
        5. tracking classification (Basic/Content/FingerprintingContent)

      Available keys are:
        "Y0_N1Sys",
        "Y1_N1",
        "Y2_N3Oth",
        "Y3_N3BasicLead",
        "Y4_N3BasicBg",
        "Y5_N3BasicOth",
        "Y6_N3ContentLead",
        "Y7_N3ContentBg",
        "Y8_N3ContentOth",
        "Y9_N3FpLead",
        "Y10_N3FpBg",
        "Y11_N3FpOth",
        "Y12_P1Sys",
        "Y13_P1",
        "Y14_P3Oth",
        "Y15_P3BasicLead",
        "Y16_P3BasicBg",
        "Y17_P3BasicOth",
        "Y18_P3ContentLead",
        "Y19_P3ContentBg",
        "Y20_P3ContentOth",
        "Y21_P3FpLead",
        "Y22_P3FpBg",
        "Y23_P3FpOth"
    expires: "84"
    keyed: true
    kind: uint
    notification_emails:
      - gachen@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out

  data_transferred_captive_portal:
    bug_numbers:
      - 1543005
    description: >
      Hom many KB has been transfer over a captive portal during a subsession.
    expires: "73"
    keyed: false
    kind: uint
    notification_emails:
      - ddamjanovic@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  http_transactions_captive_portal:
    bug_numbers:
      - 1543005
    description: >
      Number of http transactions transfer over a captive portal during a subsession.
    expires: "73"
    keyed: false
    kind: uint
    notification_emails:
      - ddamjanovic@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  http_connections_captive_portal:
    bug_numbers:
      - 1543005
    description: >
      Number of http connections transfer over a captive portal during a subsession.
    expires: "73"
    keyed: false
    kind: uint
    notification_emails:
      - ddamjanovic@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'

  ftp_opened_channels_listings:
    bug_numbers:
      - 1579507
    description: >
      Number of FTP channels opened for directory listings.
    expires: "77"
    keyed: false
    kind: uint
    notification_emails:
      - mnovotny@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out

  ftp_opened_channels_files:
    bug_numbers:
      - 1579507
    description: >
      Number of FTP channels opened for files.
    expires: "77"
    keyed: false
    kind: uint
    notification_emails:
      - mnovotny@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out

  http3_enabled:
    bug_numbers:
      - 1652104
    description: >
      True if HTTP3 is enabled at the start of a session.
    expires: never
    kind: boolean
    keyed: false
    notification_emails:
      - necko@mozilla.com
      - ddamjanovic@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
      - 'content'

blocklist:
  lastModified_rs_addons:
    bug_numbers:
      - 1572711
      - 1607744
      - 1649960
    description: >
      Keep track of the last time the "addons" remotesetting blocklist has been successfully
      updated (as a datetime string in UTC format), set to "Missing Date" when the timestamp
      couldn't be retrieved.
    expires: "88"
    kind: string
    release_channel_collection: opt-out
    notification_emails:
      - addons-dev-internal@mozilla.com
      - lgreco@mozilla.com
      - awagner@mozilla.com
      - rwu@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - main

  lastModified_rs_addons_mlbf:
    bug_numbers:
      - 1633466
      - 1649960
    description: >
      Keep track of the last time the "addons-bloomfilters" remotesetting blocklist has been successfully
      updated (as a datetime string in UTC format), set to "Missing Date" when the timestamp
      couldn't be retrieved.
    expires: "88"
    kind: string
    release_channel_collection: opt-out
    notification_emails:
      - addons-dev-internal@mozilla.com
      - lgreco@mozilla.com
      - awagner@mozilla.com
      - rwu@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - main

  lastModified_rs_plugins:
    bug_numbers:
      - 1572711
      - 1607744
      - 1649960
    description: >
      Keep track of the last time the "plugins" remotesetting blocklist has been successfully
      updated (as a datetime string in UTC format), set to "Missing Date" when the timestamp
      couldn't be retrieved.
    expires: "88"
    kind: string
    release_channel_collection: opt-out
    notification_emails:
      - addons-dev-internal@mozilla.com
      - lgreco@mozilla.com
      - awagner@mozilla.com
      - rwu@mozilla.com
    products:
      - 'firefox'
      - 'thunderbird'
    record_in_processes:
      - main

  mlbf_enabled:
    bug_numbers:
      - 1633466
      - 1649960
    description: >
      Keep track of whether the addons blocklist engine uses bloom filters (blocklist v3).
      If false, the blocklist v2 is used instead.
    expires: "88"
    kind: boolean
    release_channel_collection: opt-out
    notification_emails:
      - addons-dev-internal@mozilla.com
      - lgreco@mozilla.com
      - awagner@mozilla.com
      - rwu@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - main

  mlbf_stashes:
    bug_numbers:
      - 1633466
      - 1649960
    description: >
      Keep track of whether the bloomfilter-based blocklist engine uses stashes from the
      addons-bloomfilters collection, together with an infrequently updated base bloomfilter.
      If false, the latest (full) bloom filter is downloaded on every update of the addon blocklist.
      This metric is only meaningful if mlbf_enabled is true.
    expires: "88"
    kind: boolean
    release_channel_collection: opt-out
    notification_emails:
      - addons-dev-internal@mozilla.com
      - lgreco@mozilla.com
      - awagner@mozilla.com
      - rwu@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - main

  mlbf_generation_time:
    bug_numbers:
      - 1633466
      - 1649960
    description: >
      Keep track of the generation time of the addon blocklist's bloom filter. This marks the
      point in time until which signed add-ons are recognized by the selected bloom filter from the
      addons-bloomfilters collection.
      The value is a datetime string in UTC format, or  "Missing Date" when unavailable.
    expires: "88"
    kind: string
    release_channel_collection: opt-out
    notification_emails:
      - addons-dev-internal@mozilla.com
      - lgreco@mozilla.com
      - awagner@mozilla.com
      - rwu@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - main

  mlbf_stash_time_oldest:
    bug_numbers:
      - 1633466
      - 1649960
    description: >
      Keep track of the timestamp of the oldest stash of the addons blocklist.
      Only meaningful when mlbf_enabled and mlbf_stashes are true.
      The value is a datetime string in UTC format, or "Missing Date" when unavailable.
    expires: "88"
    kind: string
    release_channel_collection: opt-out
    notification_emails:
      - addons-dev-internal@mozilla.com
      - lgreco@mozilla.com
      - awagner@mozilla.com
      - rwu@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - main

  mlbf_stash_time_newest:
    bug_numbers:
      - 1633466
      - 1649960
    description: >
      Keep track of the timestamp of the most recent stash of the addons blocklist.
      Only meaningful when mlbf_enabled and mlbf_stashes are true.
      The value is a datetime string in UTC format, or "Missing Date" when unavailable.
    expires: "88"
    kind: string
    release_channel_collection: opt-out
    notification_emails:
      - addons-dev-internal@mozilla.com
      - lgreco@mozilla.com
      - awagner@mozilla.com
      - rwu@mozilla.com
    products:
      - 'firefox'
    record_in_processes:
      - main

firstStartup:
  statusCode:
    bug_numbers:
      - 1582608
    description: >-
      Status of the FirstRun service, which runs post-install/early-startup in Firefox.
    expires: "90"
    kind: uint
    notification_emails:
      - rhelmer@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'thunderbird'
    record_in_processes:
      - main
  elapsed:
    bug_numbers:
      - 1582608
    description: >-
      Number of milliseconds the FirstRun service took to run.
    expires: "90"
    kind: uint
    notification_emails:
      - rhelmer@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'thunderbird'
    record_in_processes:
      - main

fullscreen:
    used:
      bug_numbers:
        - 1201374
        - 1645460
      description: >
        The number of times that a session enters browser fullscreen (f11-fullscreen).
      expires: "86"
      kind: uint
      notification_emails:
        - emalysz@mozilla.com
        - rtestard@mozilla.com
      release_channel_collection: opt-out
      products:
        - 'firefox'
      record_in_processes:
        - main

# The following section is for the "deletion-request" ping (bug 1585410). All the
# extra identifiers other than `client_id` could be added here.
deletion.request:
  impression_id:
    bug_numbers:
      - 1602064
    description: >
      An identifier used by user interaction pings in Pocket/newtab and Messaging System.
    expires: never
    kind: string
    notification_emails:
      - najiang@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'deletion-request'

  sync_device_id:
    bug_numbers:
      - 1604844
    description: >
      An identifier used by sync ping, to identify the current Firefox profile for a specific Account.
    expires: never
    kind: string
    notification_emails:
      - rfkelly@mozilla.com
      - sync-team@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'deletion-request'

  ecosystem_client_id:
    bug_numbers:
      - 1635662
    description: >
      An identifier used by the ecosystem ping, to delete all ecosystem
      metrics collected from this profile if the user opts out of telemetry.
    expires: never
    kind: string
    notification_emails:
      - lina@mozilla.com
      - sync-team@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'deletion-request'

policies:
  count:
    bug_numbers:
      - 1432897
    description: >-
      A uint with the number of active enterprise policies, collected once at
      startup.
    expires: never
    kind: uint
    notification_emails:
      - mkaply@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main

urlbar:
  tips:
    bug_numbers:
      - 1608461
    description: >
      A keyed uint recording how many times particular tips are shown in the
      Urlbar and how often their confirm and help buttons are pressed.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - fx-search@mozilla.com
      - tbrooks@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main

migration:
  uninstaller_profile_refresh:
    bug_numbers:
      - 1634115
    description: >
      Set when a profile refresh is initiated from the uninstaller.
    expires: "85"
    kind: boolean
    notification_emails:
      - agashlin@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - main
    operating_systems:
      - windows

fog.eval:
  user_active:
    bug_numbers:
      - 1647876
    description: >
      Whether the user is presently actively interacting with Firefox.
      For use in evaluating baseline engagement for Project FOG.
    expires: '85'
    kind: 'boolean'
    notification_emails:
      - 'chutten@mozilla.com'
    release_channel_collection: 'opt-out'
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  window_raised:
    bug_numbers:
      - 1647876
    description: >
      Whether a Firefox window is presently raised.
      For use in evaluating baseline engagement for Project FOG.
    expires: '85'
    kind: 'boolean'
    notification_emails:
      - 'chutten@mozilla.com'
    release_channel_collection: 'opt-out'
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  user_active_error:
    bug_numbers:
      - 1647876
    description: >
      How many Telemetry stopwatch errors did we have while trying to measure user activity?
      These could be attempts to start a started timer or finish an unstarted timer or so forth.
      See Stopwatch::Start and Stopwatch::Finish for details.
      For use in evaluating baseline engagement for Project FOG.
    expires: '85'
    kind: 'uint'
    notification_emails:
      - 'chutten@mozilla.com'
    release_channel_collection: 'opt-out'
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

  window_raised_error:
    bug_numbers:
      - 1647876
    description: >
      How many Telemetry stopwatch errors did we have while trying to measure window raising?
      These could be attempts to start a started timer or finish an unstarted timer or so forth.
      See Stopwatch::Start and Stopwatch::Finish for details.
      For use in evaluating baseline engagement for Project FOG.
    expires: '85'
    kind: 'uint'
    notification_emails:
      - 'chutten@mozilla.com'
    release_channel_collection: 'opt-out'
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

# The following section is for probes testing the Telemetry system. They will not be
# submitted in pings and are only used for testing.
telemetry.test:
  unsigned_int_kind:
    bug_numbers:
      - 1276190
    description: >
      This is a test uint type with a really long description, maybe spanning even multiple
      lines, to just prove a point: everything works just fine.
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'geckoview_streaming'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  string_kind:
    bug_numbers:
      - 1276190
    description: A string test type with a one line comment that works just fine!
    expires: never
    kind: string
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'geckoview_streaming'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  boolean_kind:
    bug_numbers:
      - 1281214
    description: A boolean test type with a one line comment that works just fine!
    expires: never
    kind: boolean
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'geckoview_streaming'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  expired:
    bug_numbers:
      - 1276190
    description: This is an expired testing scalar; not meant to be touched.
    expires: "4"
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  unexpired:
    bug_numbers:
      - 1276190
    description: This is an unexpired testing scalar; not meant to be touched.
    expires: "375"
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  release_optin:
    bug_numbers:
      - 1276190
    description: A testing scalar; not meant to be touched.
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  release_optout:
    bug_numbers:
      - 1276190
    description: A testing scalar; not meant to be touched.
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  keyed_release_optin:
    bug_numbers:
      - 1277806
    description: A testing scalar; not meant to be touched.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-in
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  keyed_release_optout:
    bug_numbers:
      - 1277806
    description: A testing scalar; not meant to be touched.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  keyed_expired:
    bug_numbers:
      - 1277806
    description: This is an expired testing scalar; not meant to be touched.
    expires: "4"
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  keyed_unsigned_int:
    bug_numbers:
      - 1277806
    description: A testing keyed uint scalar; not meant to be touched.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  keyed_with_keys:
    bug_numbers:
      - 1277806
    description: A testing keyed scalar with defined keys; not meant to be touched.
    expires: never
    kind: uint
    keyed: true
    keys:
      - 'only'
      - 'meant'
      - 'for'
      - 'testing'
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'

  child_keyed_unsigned_int:
    bug_numbers:
      - 1466490
    description: A testing keyed uint scalar; not meant to be touched.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'content'

  keyed_boolean_kind:
    bug_numbers:
      - 1277806
    description: A testing keyed boolean scalar; not meant to be touched.
    expires: never
    kind: boolean
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'
      - 'content'

  content_only_uint:
    bug_numbers:
      - 1278556
    description: A testing uint scalar; not meant to be touched.
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'content'

  socket_only_uint:
    bug_numbers:
      - 1486033
    description: A testing uint scalar; not meant to be touched.
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'socket'

  all_processes_uint:
    bug_numbers:
      - 1278556
    description: A testing uint scalar; not meant to be touched.
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'all'

  all_child_processes_string:
    bug_numbers:
      - 1278556
    description: A testing string scalar; not meant to be touched.
    expires: never
    kind: string
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'all_childs'

  default_products:
    bug_numbers:
      - 1452552
    description: A testing uint scalar; not meant to be touched
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'all'

  desktop_only:
    bug_numbers:
      - 1452552
    description: A testing uint scalar; not meant to be touched
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    record_in_processes:
      - 'all'
    products:
      - firefox
      - thunderbird

  keyed_desktop_only:
    bug_numbers:
      - 1452552
    description: A keyed testing uint scalar; not meant to be touched
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    record_in_processes:
      - 'all'
    products:
      - firefox
      - thunderbird

  multiproduct:
    bug_numbers:
      - 1452552
    description: A testing uint scalar; not meant to be touched
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    record_in_processes:
      - 'all'
    products:
      - firefox
      - fennec
      - thunderbird

  mobile_only:
    bug_numbers:
      - 1452552
    description: A testing uint scalar; not meant to be touched
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    record_in_processes:
      - 'all'
    products:
      - fennec

  keyed_mobile_only:
    bug_numbers:
      - 1452552
    description: A keyed testing uint scalar; not meant to be touched
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    record_in_processes:
      - 'all'
    products:
      - fennec

  main_only:
    bug_numbers:
      - 1498164
    description: >
      This is a test uint type with only the main store.
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'main'

  sync_only:
    bug_numbers:
      - 1498164
    description: >
      This is a test uint type with only the sync store.
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'sync'

  impression_id_only:
    bug_numbers:
      - 1602064
    description: >
      This is a test uint type with only the deletion-request store.
    expires: never
    kind: string
    notification_emails:
      - telemetry-client-dev@mozilla.com
      - najiang@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'deletion-request'

  multiple_stores:
    bug_numbers:
      - 1498164
    description: >
      This is a test uint type with multiple stores.
    expires: never
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'main'
      - 'sync'

  multiple_stores_string:
    bug_numbers:
      - 1498164
    description: >
      This is a test string type with multiple stores.
    expires: never
    kind: string
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'main'
      - 'sync'

  multiple_stores_bool:
    bug_numbers:
      - 1498164
    description: >
      This is a test bool type with multiple stores.
    expires: never
    kind: boolean
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'main'
      - 'sync'

  multiple_stores_keyed:
    bug_numbers:
      - 1498164
    description: >
      This is a test keyed uint type with multiple stores.
    expires: never
    kind: uint
    keyed: true
    notification_emails:
      - telemetry-client-dev@mozilla.com
    products:
      - 'firefox'
      - 'fennec'
      - 'thunderbird'
    record_in_processes:
      - 'main'
    record_into_store:
      - 'main'
      - 'sync'

# The following section contains counters for corruption of internal omni jar files.
corroborate:
  omnijar_corrupted:
    bug_numbers:
      - 1515712
    description: >-
          Whether the omni jar (omni.ja) was found to be missing or corrupt when checked during startup.
    expires: "80"
    kind: boolean
    notification_emails:
      - rhelmer@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main

  omnijar_mismatch:
    bug_numbers:
      - 1608308
    description: >-
          Whether the build IDs of the omni jar (omni.ja) and libxul do not match.
    expires: "80"
    kind: boolean
    notification_emails:
      - rhelmer@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
      - 'fennec'
    record_in_processes:
      - main

privacy.feature:
  first_party_isolation_enabled:
    bug_numbers:
      - 1631676
    description: >
      The value of preference "privacy.firstparty.isolate"
    expires: "never"
    kind: boolean
    notification_emails:
      - gachen@mozilla.com
    release_channel_collection: opt-out
    products:
      - 'firefox'
    record_in_processes:
      - 'main'

# NOTE: Please don't add new definitions below this point. Consider adding
# them earlier in the file and leave the telemetry.test category as the last
# one for readability.