# 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:
  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
    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
    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
    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
    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
    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
    record_in_processes:
      - 'main'

  total_uri_count:
    bug_numbers:
      - 1271313
    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
    release_channel_collection: opt-out
    record_in_processes:
      - 'main'

  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
    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
    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
    record_in_processes:
      - 'main'

  active_ticks:
    bug_numbers:
      - 1376942
    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
    release_channel_collection: opt-out
    record_in_processes:
      - 'main'

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

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
    record_in_processes:
      - main

# This section is for probes used to measure use of the Webextensions storage.sync API.
storage.sync.api.usage:
  extensions_using:
    bug_numbers:
      - 1328974
    description: >
      The count of webextensions that have data stored in the chrome.storage.sync API.
      This includes extensions that have not used the storage.sync API this session.
      This includes items that were not stored this session.
      This scalar is collected after every sync.
    expires: "64"
    kind: uint
    keyed: false
    notification_emails:
      - eglassercamp@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
  items_stored:
    bug_numbers:
      - 1328974
    description: >
      The count of items in storage.sync storage, broken down by extension ID.
      This includes extensions that have not used the storage.sync API this session.
      This includes items that were not stored this session.
      This scalar is collected after every sync.
    expires: "64"
    kind: uint
    keyed: true
    notification_emails:
      - eglassercamp@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
  storage_consumed:
    bug_numbers:
      - 1328974
    description: >
      The count of bytes used in storage.sync, broken down by extension ID.
      This includes extensions that have not used the storage.sync API this session.
      This includes items that were not stored this session.
      This scalar is collected after every sync.
    expires: "64"
    kind: uint
    keyed: true
    notification_emails:
      - eglassercamp@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main

services.sync:
  sync_login_state_transitions:
    bug_numbers:
      - 1375635
      - 1523644
    description: >
      Records transitions between login states of "success", "unverified"
      and "rejected.
    expires: "72"
    kind: boolean
    keyed: true
    notification_emails:
      - sync-staff@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main

identity.fxaccounts:
  missed_commands_fetched:
    bug_numbers:
      - 1496638
    description: >
      The number of missed FxA commands we have recovered.
    expires: "68"
    kind: uint
    keyed: false
    notification_emails:
      - fxa-staff@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main

security:
  pkcs11_modules_loaded:
    bug_numbers:
      - 1369911
      - 1445961
    description: >
      A keyed boolean indicating the library names of the PKCS#11 modules that
      have been loaded by the browser.
    expires: "69"
    kind: boolean
    keyed: true
    notification_emails:
      - seceng-telemetry@mozilla.com
      - dkeeler@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
  webauthn_used:
    bug_numbers:
      - 1265472
    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: "70"
    kind: uint
    keyed: true
    notification_emails:
      - seceng-telemetry@mozilla.com
      - jjones@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
  intermediate_preloading_num_preloaded:
    bug_numbers:
      - 1519273
    description: >
      Number of intermediate certificates pre-loaded.
    expires: "70"
    kind: uint
    notification_emails:
      - seceng-telemetry@mozilla.com
      - jjones@mozilla.com
    record_in_processes:
      - main
  intermediate_preloading_num_pending:
    bug_numbers:
      - 1519273
    description: >
      Number of intermediate certificates pending pre-load.
    expires: "70"
    kind: uint
    notification_emails:
      - seceng-telemetry@mozilla.com
      - jjones@mozilla.com
    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
    record_in_processes:
      - main

contentblocking:
  exceptions:
    bug_numbers:
      - 1484251
    description: >
      How many tracking protection/content blocking exceptions a user has at startup.
    expires: "70"
    kind: uint
    notification_emails:
      - jhofmann@mozilla.com
      - pdol@mozilla.com
      - seceng-telemetry@mozilla.com
    release_channel_collection: opt-out
    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
    record_in_processes:
      - main
    operating_systems:
      - "windows"

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
    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
    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
    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
    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
    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
    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
    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
    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
    record_in_processes:
      - 'main'

# The following section contains WebRTC JS API scalars
# For more information on WebRTC, see https://www.w3.org/TR/webrtc/
# For more info on ICE, see https://tools.ietf.org/html/rfc5245
webrtc.peerconnection:
  connected:
    bug_numbers:
      - 1455724
    description: >
      The number of RTCPeerConnection objects that established connections.
      This is incremented the first time a RTCPeerConnection object's
      iceConnectionState becomes "connected" or "complete".
      For more information on WebRTC, see https://www.w3.org/TR/webrtc/
    expires: "65"
    kind: uint
    notification_emails:
      - ngrunbaum@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

  legacy_callback_stats_used:
    bug_numbers:
      - 1455724
    description: >
      The number of RTCPeerConnections in which the current statistics
      API is called. Recorded the first time getStats is called using the
      deprecated callback based API on a RTCPeerConnection that has an
      iceConnectionState of "complete" or "connected".
    expires: "65"
    kind: uint
    notification_emails:
      - ngrunbaum@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

  promise_stats_used:
    bug_numbers:
      - 1455724
    description: >
      The number of RTCPeerConnection objects in which the current statistics
      API is called. This is recorded the first time getStats is called using
      the promise based API on a RTCPeerConnection that has an
      iceConnectionState of "complete" or "connected".
    expires: "65"
    kind: uint
    notification_emails:
      - ngrunbaum@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

  promise_and_callback_stats_used:
    bug_numbers:
      - 1455724
    description: >
      The number of RTCPeerConnection objects in which both the legacy callback
      statistics API and the modern promise statistics API are used. This is
      recorded once for each RTCPeerConnection after the callback and promise
      getStats API has been called on a RTCPeerConnection that has an
      iceConnectionState of "complete" or "connected".
    expires: "65"
    kind: uint
    notification_emails:
      - ngrunbaum@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

# The following section contains WebRTC nICEr scalars
# For more info on ICE, see https://tools.ietf.org/html/rfc5245
# For more info on STUN, see https://tools.ietf.org/html/rfc5389
# For more info on TURN, see https://tools.ietf.org/html/rfc5766
webrtc.nicer:
  stun_retransmits:
    bug_numbers:
      - 1325536
    description: >
      The count of STUN message retransmissions during a WebRTC call.
      When sending STUN request messages over UDP, messages may be
      dropped by the network. Retransmissions are the mechanism used to
      accomplish reliability of the STUN request/response transaction.
      This can happen during both successful and unsuccessful WebRTC
      calls.
      For more info on ICE, see https://tools.ietf.org/html/rfc5245
      For more info on STUN, see https://tools.ietf.org/html/rfc5389
      For more info on TURN, see https://tools.ietf.org/html/rfc5766
    expires: "62"
    kind: uint
    notification_emails:
      - webrtc-ice-telemetry-alerts@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

  turn_401s:
    bug_numbers:
      - 1325536
    description: >
      The count of TURN 401 (Unauthorized) responses to allocation
      requests. Only 401 responses beyond the first, expected 401 are
      counted. More than one 401 repsonse indicates the client is
      experiencing difficulty authenticating with the TURN server. This
      can happen during both successful and unsuccessful WebRTC calls.
      For more info on ICE, see https://tools.ietf.org/html/rfc5245
      For more info on STUN, see https://tools.ietf.org/html/rfc5389
      For more info on TURN, see https://tools.ietf.org/html/rfc5766
    expires: "62"
    kind: uint
    notification_emails:
      - webrtc-ice-telemetry-alerts@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

  turn_403s:
    bug_numbers:
      - 1325536
    description: >
      The count of TURN 403 (Forbidden) responses to CreatePermission or
      ChannelBind requests.  This indicates that the TURN server is
      refusing the request for an IP address or IP address/port
      combination, likely due to administrative restrictions.
      For more info on ICE, see https://tools.ietf.org/html/rfc5245
      For more info on STUN, see https://tools.ietf.org/html/rfc5389
      For more info on TURN, see https://tools.ietf.org/html/rfc5766
    expires: "62"
    kind: uint
    notification_emails:
      - webrtc-ice-telemetry-alerts@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

  turn_438s:
    bug_numbers:
      - 1325536
    description: >
      The count of TURN 438 (Stale Nonce) responses to allocation
      requests. This can happen during both successful and unsuccessful
      WebRTC calls.
      For more info on ICE, see https://tools.ietf.org/html/rfc5245
      For more info on STUN, see https://tools.ietf.org/html/rfc5389
      For more info on TURN, see https://tools.ietf.org/html/rfc5766
    expires: "62"
    kind: uint
    notification_emails:
      - webrtc-ice-telemetry-alerts@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

webrtc.sdp:
  parser_diff:
    bug_numbers:
      - 1432955
    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: "64"
    kind: uint
    keyed: true
    notification_emails:
      - nohlmeier@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'content'

mathml:
  doc_count:
    bug_numbers:
      - 1362187
    description: >
      The number of documents that contained enabled MathML elements.
    expires: "63"
    kind: uint
    notification_emails:
      - gsquelart@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'content'

mediarecorder:
  recording_count:
    bug_numbers:
      - 1400757
    description: >
      The number of times a MediaRecorder has been started. Recorded when a MediaRecorder starts
    expires: "68"
    kind: uint
    notification_emails:
      - bvandyk@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - main
      - content

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

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

  page_had_play_revoked_count:
    bug_numbers:
      - 1476456
      - 1499803
    description: >
      The number of times a document hierarchy contained at least one muted playing HTMLMediaElement that was paused due to becoming unmuted while not being allowed to autoplay.
    expires: "68"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
      - content

  autoplay_would_not_be_allowed_count:
    bug_numbers:
      - 1476456
      - 1499803
    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: "68"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
      - content

  allowed_autoplay_no_audio_track_count:
    bug_numbers:
      - 1480484
      - 1499803
    description: >
      The number of HTMLMediaElement autoplays on HTMLMediaElements without an audio track which would be allowed to play.
    expires: "68"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
      - content

  autoplay_would_be_allowed_count:
    bug_numbers:
      - 1476456
      - 1499803
    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: "68"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
      - content

  blocked_no_metadata:
    bug_numbers:
      - 1483703
      - 1499803
    description: >
      The number of HTMLMediaElements which we blocked because they hadn't loaded metadata yet.
    expires: "68"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
      - content

  blocked_no_metadata_endup_no_audio_track:
    bug_numbers:
      - 1483703
      - 1499803
    description: >
      The number of HTMLMediaElements which were blocked because they hadn't loaded metadata yet, but ended up having no audio track.
    expires: "68"
    kind: uint
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
      - content

  autoplay_default_blocked:
    bug_numbers:
      - 1521947
    description: >
      Whether the user blocked autoplay by default. Recorded when the preference is toggled.
    expires: "72"
    kind: boolean
    notification_emails:
      - cpearce@mozilla.com
      - alwu@mozilla.com
      - nohlmeier@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - main
      - 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
    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
    record_in_processes:
      - 'main'

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

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

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

devtools.copy.xpath:
  opened:
    bug_numbers:
      - 987877
    description: Number of times the DevTools copy XPath has been used.
    expires: "59"
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
    release_channel_collection: opt-out
    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
    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
    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
    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
    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
    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
    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
    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
    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
    record_in_processes:
      - 'main'

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

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

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

  reveal_link_clicked:
    bug_numbers:
      - 1470128
    description: >
      Whether the user clicked on any "reveal" link. "reveal" links are displayed in
      shadow dom trees in the markup view.
    expires: "66"
    kind: boolean
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jdescottes@mozilla.com
    release_channel_collection: opt-out
    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
    record_in_processes:
      - 'main'

devtools.aboutdevtools:
  opened:
    bug_numbers:
      - 1412029
    description: >
      Number of times about:devtools was opened.
    expires: "63"
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jdescottes@mozilla.com
    record_in_processes:
      - 'main'
  installed:
    bug_numbers:
      - 1412029
    description: >
      Number of times devtools were enabled/installed in about:devtools.
    expires: "63"
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jdescottes@mozilla.com
    record_in_processes:
      - 'main'
  noinstall_exits:
    bug_numbers:
      - 1412029
    description: >
      Number of times the user left about:devtools without enabling devtools.
    expires: "63"
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jdescottes@mozilla.com
    record_in_processes:
      - 'main'

devtools.onboarding:
  is_devtools_user:
    bug_numbers:
      - 1408339
    description: >
      How many users are flagged as existing devtools users.
    expires: "66"
    kind: boolean
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - jdescottes@mozilla.com
    record_in_processes:
      - 'main'
    release_channel_collection: opt-out

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
    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
    record_in_processes:
      - main
    release_channel_collection: opt-out

devtools.tool:
  registered:
    bug_numbers:
      - 1447302
      - 1503568
    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: "70"
    kind: boolean
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - 'main'

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

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

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

  select_accessible_for_node:
    bug_numbers:
      - 1447302
      - 1503568
    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: "70"
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - 'main'

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

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

  accessible_context_menu_item_activated:
    bug_numbers:
      - 1507870
    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: "70"
    kind: uint
    keyed: true
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - yzenevich@mozilla.com
    release_channel_collection: opt-out
    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
    record_in_processes:
      - 'main'

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

devtools.webreplay:
  new_recording:
    bug_numbers:
     - 1495910
    description: >
      Number of times a blank recording tab was created.
    expires: never
    kind: uint
    notification_emails:
     - bhackett@mozilla.com
    record_in_processes:
     - 'main'

  reload_recording:
    bug_numbers:
     - 1495910
    description: >
      Number of times a non-recording tab was reloaded to create a recording tab.
    expires: never
    kind: uint
    notification_emails:
     - bhackett@mozilla.com
    record_in_processes:
     - 'main'

  stop_recording:
    bug_numbers:
     - 1495910
    description: >
      Number of times a recording tab was reloaded to create a non-recording tab.
    expires: never
    kind: uint
    notification_emails:
     - bhackett@mozilla.com
    record_in_processes:
     - 'main'

  save_recording:
    bug_numbers:
     - 1495910
    description: >
      Number of times a recording was saved.
    expires: never
    kind: uint
    notification_emails:
     - bhackett@mozilla.com
    record_in_processes:
     - 'main'

  load_recording:
    bug_numbers:
     - 1495910
    description: >
      Number of times a recording was loaded.
    expires: never
    kind: uint
    notification_emails:
     - bhackett@mozilla.com
    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
    record_in_processes:
      - 'main'

  copy:
    bug_numbers:
      - 1522843
    description: >
      Number of times any text content from the Changes panel is copied to the clipboard.
    expires: "69"
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - mbalfanz@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - 'main'

  contextmenu:
    bug_numbers:
      - 1522843
    description: >
      Number of times the Changes panel context menu is shown.
    expires: "69"
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - mbalfanz@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - 'main'

  contextmenu_copy:
    bug_numbers:
      - 1522843
    description: >
      Number of times the Copy option is picked from the Changes panel context menu.
    expires: "69"
    kind: uint
    notification_emails:
      - dev-developer-tools@lists.mozilla.org
      - mbalfanz@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - 'main'

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
    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
    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
    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
    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
    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
    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
    record_in_processes:
      - 'main'

  # While the following probe could be restricted to GeckoView, we can't
  # turn the product filter on as we don't run GeckoView test coverage on
  # GeckoView.
  persistence_timer_hit_count:
    bug_numbers:
      - 1463152
    description: >
      How many times the GeckoView Telemetry persistence timer was hit during
      the current subsession.
    expires: "70"
    kind: uint
    notification_emails:
      - telemetry-client-dev@mozilla.com
      - aplacitelli@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - 'main'

  pending_operations_highwatermark_reached:
    bug_numbers:
      - 1465052
    description: >
      The number of times the pending operations list reached the
      high-water mark, leading to operations being applied immediately.
    expires: "70"
    kind: uint
    keyed: false
    notification_emails:
      - jrediger@mozilla.com
      - telemetry-client-dev@mozilla.com
    release_channel_collection: opt-out
    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
    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
    record_in_processes:
      - 'main'

  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
    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
    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
    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
    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
    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
    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
    record_in_processes:
      - 'all_childs'

# 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
    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
    record_in_processes:
      - 'content'

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
    record_in_processes:
      - 'main'

# 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
    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
    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
    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
    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
    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
    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
    record_in_processes:
      - 'main'

# 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
    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
    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
    record_in_processes:
      - 'main'

idb.type:
  persistent_count:
    bug_numbers:
      - 1360567
    description: >
      Number of times indexeddb.open(name, {storage: "persistent"}) has been used.
    expires: "62"
    kind: uint
    notification_emails:
      - shuang@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

  temporary_count:
    bug_numbers:
      - 1360567
    description: >
      Number of times indexeddb.open(name, {storage: "temporary"}) has been used.
    expires: "62"
    kind: uint
    notification_emails:
      - shuang@mozilla.com
    release_channel_collection: opt-in
    record_in_processes:
      - 'main'
      - 'content'

# 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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    record_in_processes:
      - 'content'

resistfingerprinting:
  content_window_size:
    bug_numbers:
      - 1489493
    description: >
      The size (in pixels) of the content windows for innerWidth and innerHeight.
    expires: "66"
    kind: uint
    keyed: true
    notification_emails:
      - tihuang@mozilla.com
      - tom@mozilla.com
      - ettseng@mozilla.com
    release_channel_collection: opt-out
    record_in_processes:
      - 'main'

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
    record_in_processes:
      - main

# 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
    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
    record_in_processes:
      - main

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

startup:
  profile_selection_reason:
    bug_numbers:
      - 1522934
    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.
        firstrun-created-default:
          A first run of the application created a new profile to use.
        default:
          The default profile was selected as normal.
    expires: "72"
    keyed: false
    kind: string
    notification_emails:
      - dtownsend@mozilla.com
      - rtestard@mozilla.com
    release_channel_collection: opt-out
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    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

  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

  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
      - geckoview

  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
      - geckoview

  geckoview_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:
      - geckoview

  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
      - geckoview

  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
    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
    record_in_processes:
      - 'main'
    record_into_store:
      - 'sync'

  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
    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
    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
    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
    record_in_processes:
      - 'main'
    record_into_store:
      - 'main'
      - 'sync'

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