# 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 defines the metrics that are recorded by the Glean SDK. They are
# automatically converted to platform-specific code at build time using the
# `glean_parser` PyPI package.

# Adding a new metric? Please don't!
# (At least not without the permission of a Telemetry Module Peer)

---
$schema: moz://mozilla.org/schemas/glean/metrics/2-0-0

geckoview:
  version:
    description: >
      The version of the Gecko engine, example: 74.0a1
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gecko.version
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240#c2
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

  build_id:
    description: >
      The Buildid of the Gecko engine, example: 20200205124310
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gecko.build_id
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240#c2
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

  content_process_lifetime:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GV_CONTENT_PROCESS_LIFETIME_MS
    description: >
      The uptime of content processes in ms
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1625325
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1625325#c2
    notification_emails:
      - android-probes@mozilla.com
    expires: never

  page_load_progress_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GV_PAGE_LOAD_PROGRESS_MS
    description: >
      Time between page load progress starts (0) and completion (100).
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1499418
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - android-probes@mozilla.com
    expires: never

  page_load_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GV_PAGE_LOAD_MS
    description: >
      The time taken to load a page. This includes all static contents, no
      dynamic content.
      Loading of about: pages is not counted.
      Back back navigation (sometimes via BFCache) is included which is a
      source of bimodality due to the <50ms load times.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1499418
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - android-probes@mozilla.com
    expires: never

  page_reload_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GV_PAGE_RELOAD_MS
    description: >
      Time taken to reload a page.
      This includes all static contents, no dynamic content.
      Loading of about: pages is not counted.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1549519
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - android-probes@mozilla.com
      - sefeng@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  startup_runtime:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GV_STARTUP_RUNTIME_MS
    description: >
      The time taken to initialize GeckoRuntime.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1499418
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - android-probes@mozilla.com
    expires: never

  document_site_origins:
    type: custom_distribution
    description: >
      When a document is loaded, report the
      number of [site origins](https://searchfox.org/
      mozilla-central/rev/
      3300072e993ae05d50d5c63d815260367eaf9179/
      caps/nsIPrincipal.idl#264) of the entire browser
      if it has been at least 5 minutes since last
      time we collect this data.
    range_min: 0
    range_max: 100
    bucket_count: 50
    histogram_type: exponential
    unit: number of site_origin
    gecko_datapoint: FX_NUMBER_OF_UNIQUE_SITE_ORIGINS_ALL_TABS
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1589700
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1589700#c5
    notification_emails:
      - sefeng@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  per_document_site_origins:
    type: custom_distribution
    description: >
      When a document is unloaded, report the highest number of
      [site origins](https://searchfox.org/
      mozilla-central/rev/
      3300072e993ae05d50d5c63d815260367eaf9179/
      caps/nsIPrincipal.idl#264) loaded simultaneously in that
      document.
    range_min: 0
    range_max: 100
    bucket_count: 50
    histogram_type: exponential
    unit: number of site origins per document
    gecko_datapoint: FX_NUMBER_OF_UNIQUE_SITE_ORIGINS_PER_DOCUMENT
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1603185
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1603185#c13
    notification_emails:
      - barret@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

gfx:
  composite_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: COMPOSITE_TIME
    description: >
      The time taken to composite a frame.
      On non-webrender this is the time taken in
      `CompositorBridgeParent::CompositeToTarget()`.
      On webrender, this is the time taken from the start of
      `WebRenderBridgeParent::CompositeToTarget()`,
      until the render thread has rendered the frame (in
      `RenderThread::HandleFrameOneDoc()`).
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1080160
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1529352
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580129
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580129#c7
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - jnicol@mozilla.com
    expires: never

  scroll_present_latency:
    type: timing_distribution
    time_unit: millisecond
    description: >
      Time between receiving a scroll
      event on the event loop and compositing
      its result onto the screen (ms).
    gecko_datapoint: SCROLL_PRESENT_LATENCY
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1604818
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1604818#c4
    notification_emails:
      - sefeng@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

gfx.checkerboard:
  duration:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: CHECKERBOARD_DURATION
    description: >
      The duration of a checkerboard event.
      Checkerboarding is when painting has not kept up with asynchronous
      panning and zooming so the compositor has to display a "checkerboard
      pattern" (or in practice, the background color) rather than the actual
      page content.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - botond@mozilla.com
    expires: never

  peak_pixel_count:
    type: custom_distribution
    range_max: 66355200
    bucket_count: 50
    histogram_type: exponential
    unit: Pixels
    gecko_datapoint: CHECKERBOARD_PEAK
    description: >
      The peak number of CSS pixels that checkerboarded during a checkerboard
      event. The minimum value of the largest histogram bucket is the size of
      a 4k display with maximum APZ zooming.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - botond@mozilla.com
    expires: never

  potential_duration:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: CHECKERBOARD_POTENTIAL_DURATION
    description: >
      The total amount of time that we could reasonably be checkerboarding.
      This is the union of two possibly-intersecting sets of time periods:
      The first set is that in which checkerboarding was actually happening,
      since by definition it could potentially be happening.
      The second set is that in which the APZC is actively transforming content
      in the compositor, since it could potentially transform it so as to
      display checkerboarding to the user. Combined with other information,
      this allows us to meaningfully say how frequently users actually
      enncounters checkerboarding.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - botond@mozilla.com
    expires: never

  severity:
    type: custom_distribution
    range_max: 1073741824
    bucket_count: 50
    histogram_type: exponential
    unit: Opaque unit
    gecko_datapoint: CHECKERBOARD_SEVERITY
    description: >
      An opaque measurement of the severity of a checkerboard event.
      This doesn't have units, it's just useful for comparing two checkerboard
      events to see which one is worse, for some implementation-specific
      definition of "worse". The larger the value, the worse the
      checkerboarding.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - botond@mozilla.com
    expires: never

gfx.content:
  paint_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: CONTENT_PAINT_TIME
    description: >
      Time spent in the main-thread paint pipeline for content.
      For non-webrender, this includes display list building, layer building,
      and when OMTP is disabled, rasterization.
      For webrender, this includes display list building, and webrender display
      list building.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1309442
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

  full_paint_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: CONTENT_FULL_PAINT_TIME
    description: >
      Time spent in the full paint pipeline for content until it's ready for
      composition.
      For non-webrender this includes `paint_time`, plus rasterization if OMTP
      is enabled.
      For webrender, this includes `paint_time`, plus scene building time.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1505858
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - jmuizelaar@mozilla.com
    expires: never

gfx.content.frame_time:
  from_paint:
    type: custom_distribution
    range_max: 5000
    bucket_count: 50
    histogram_type: exponential
    unit: Percentage of vsync interval
    gecko_datapoint: CONTENT_FRAME_TIME
    description: >
      The time, in percentage of a vsync interval, spent from beginning a paint
      in the content process until that frame is presented in the compositor.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470528
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1509536
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - jnicol@mozilla.com
    expires: never

  from_vsync:
    type: custom_distribution
    range_min: 8
    range_max: 792
    bucket_count: 100
    histogram_type: linear
    unit: Percentage of vsync interval
    gecko_datapoint: CONTENT_FRAME_TIME_VSYNC
    description: >
      The time, in percentage of a vsync interval, spent from the vsync that
      started a paint in the content process until that frame is presented in
      the compositor.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1517355
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

  with_svg:
    type: custom_distribution
    range_max: 5000
    bucket_count: 50
    histogram_type: exponential
    unit: Percentage of vsync interval
    gecko_datapoint: CONTENT_FRAME_TIME_WITH_SVG
    description: >
      The time, in percentage of a vsync interval, spent from beginning a paint
      in the content process until that frame is presented in the compositor,
      for frames that contained an SVG to be drawn by webrender.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1483549
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1509536
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

  without_resource_upload:
    type: custom_distribution
    range_max: 5000
    bucket_count: 50
    histogram_type: exponential
    unit: Percentage of vsync interval
    gecko_datapoint: CONTENT_FRAME_TIME_WITHOUT_RESOURCE_UPLOAD
    description: >
      The time, in percentage of a vsync interval, spent from beginning a paint
      in the content process until that frame is presented in the compositor by
      webrender, excluding time spent uploading resources.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1503405
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

  without_upload:
    type: custom_distribution
    range_max: 5000
    bucket_count: 50
    histogram_type: exponential
    unit: Percentage of vsync interval
    gecko_datapoint: CONTENT_FRAME_TIME_WITHOUT_UPLOAD
    description: >
      The time, in percentage of a vsync interval, spent from beginning a paint
      in the content process until that frame is presented in the compositor by
      webrender, excluding time spent uploading any content.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1503405
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

  reason:
    type: labeled_counter
    labels:
      - on_time
      - no_vsync
      - missed_composite
      - slow_composite
      - missed_composite_mid
      - missed_composite_long
      - missed_composite_low
      - no_vsync_no_id
    gecko_datapoint: CONTENT_FRAME_TIME_REASON
    description: >
      The reason that `gfx.content.frame_time.from_paint` recorded a slow
      (>200ms) result, if any.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1510853
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

gfx.webrender:
  scenebuild_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: WR_SCENEBUILD_TIME
    description: >
      The time taken to build a webrender scene.
      This occurs each time webrender receives a new display list.
      This additionally includes blob rasterization time.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - jmuizelaar@mozilla.com
    expires: never
  sceneswap_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: WR_SCENESWAP_TIME
    description: >
      The time taken to do a webrender scene swap. This is book-keeping that
      APZ must perform once webrender has built a new scene.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - jmuizelaar@mozilla.com
    expires: never
  framebuild_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: WR_FRAMEBUILD_TIME
    description: >
      The time taken to build a webrender frame.
      This involves calculating the visibility of primitives, requesting
      resources, and building the render passes which will be used to render
      the frame.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - jmuizelaar@mozilla.com
    expires: never

gfx.display:
  count:
    description: >
      Amount of displays connected to the device
    type: quantity
    unit: Display count
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.display.count
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  primary_width:
    description: >
      Width of the primary display, takes device rotation into account.
    type: quantity
    unit: Pixels
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.display.primary_width
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  primary_height:
    description: >
      Height of the primary display, takes device rotation into account.
    type: quantity
    unit: Pixels
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.display.primary_height
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
gfx.adapter.primary:
  description:
    description: >
      Long form description of the Graphics adapter
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.adapter.description
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  vendor_id:
    description: >
      Graphics adapter vendor identification
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.adapter.vendor_id
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  device_id:
    description: >
      Graphics adapter device identification
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.adapter.device_id
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  subsystem_id:
    description: >
      Graphics adapter subsystem identification
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.adapter.subsystem_id
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  ram:
    description: >
      Graphics adapter dedicated memory
    type: quantity
    unit: Megabytes
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.adapter.ram
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  driver_files:
    description: >
      List of graphics adapter driver files
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.adapter.driver_files
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  driver_vendor:
    description: >
      Graphics adapter driver vendor identification
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.adapter.driver_vendor
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  driver_version:
    description: >
      Graphics adapter driver version
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.adapter.driver_version
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  driver_date:
    description: >
      Graphics adapter driver date
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.adapter.driver_date
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

gfx.status:
  compositor:
    description: >
      Name of the graphics compositor in use.
      Possible values are "opengl, d3d11, client, webrender or basic"
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.compositor
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  last_compositor_gecko_version:
    description: >
      The gecko version at the last time a compositor was initialized, and
      therefore when gfx_status_compositor was last updated. Due to
      gfx_status_compositor's user lifetime we see lots of unexpected values for
      the current gecko version. We believe this is because the user has not
      opened a tab since they were updated to a version where webrender should
      be enabled on their device. This can be used to verify that theory.
    type: string
    # Temporary misuse of the user lifetime approved by Glean team
    # in order to match gfx_status_compositor's lifetime.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.last_compositor_gecko_version
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1704842
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1704842#c8
    notification_emails:
      - jnicol@mozilla.com
      - gfx-telemetry-alerts@mozilla.com
    expires: never
  headless:
    description: >
      Boolean indicated whether graphics is running in
      headless (no display) mode
    type: boolean
    # Temporary misuse of the user lifetime approved by Glean team
    # due to limitations in Geckoview streaming telemetry.
    # DO NOT DUPLICATE unless approved by Glean team.
    lifetime: user
    gecko_datapoint: gfx.headless
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
    expires: never

gfx.feature:
  webrender:
    type: string
    description: Whether webrender is enabled or disabled, and why.
    lifetime: application
    gecko_datapoint: gfx.feature.webrender
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687312
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687312#c5
    notification_emails:
      - gfx-telemetry-alerts@mozilla.com
      - jnicol@mozilla.com
    expires: never

avif:
  decode_result:
    type: labeled_counter
    labels:
      - success
      - parse_error
      - no_primary_item
      - decode_error
      - size_overflow
      - out_of_memory
      - pipe_init_error
      - write_buffer_error
      - alpha_y_sz_mismatch
      - alpha_y_bpc_mismatch
      - ispe_mismatch
      - render_size_mismatch
      - frame_size_changed
      - invalid_cicp
      - invalid_parse_status
      - missing_brand
      - ftyp_not_first
      - no_image
      - multiple_moov
      - no_moov
      - lsel_no_essential
      - a1op_no_essential
      - a1lx_essential
      - txform_no_essential
      - image_item_type
      - item_type_missing
      - construction_method
      - item_loc_not_found
      - no_item_data_box
    gecko_datapoint: AVIF_DECODE_RESULT
    description: >
      Decode result of AVIF image.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  decoder:
    type: labeled_counter
    labels:
      - dav1d
      - aom
    gecko_datapoint: AVIF_DECODER
    description: >
      Decoder of AVIF image.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  aom_decode_error:
    type: labeled_counter
    labels:
      - error
      - mem_error
      - abi_mismatch
      - incapable
      - unsup_bitstream
      - unsup_feature
      - corrupt_frame
      - invalid_param
    gecko_datapoint: AVIF_AOM_DECODE_ERROR
    description: >
      Image-decode Error from AOM decoder
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1690406
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1690406#c3
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  # dav1d_decode_error is replaced by avif.dav1d_get_picture in Events.yaml
  # Unfortunately, events are not currently supported for geckoview

  yuv_color_space:
    type: labeled_counter
    labels:
      - bt601
      - bt709
      - bt2020
      - identity
      - unknown
    gecko_datapoint: AVIF_YUV_COLOR_SPACE
    description: >
      YUV color space of AVIF image.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  bit_depth:
    type: labeled_counter
    labels:
      - color_8
      - color_10
      - color_12
      - color_16
      - unknown
    gecko_datapoint: AVIF_BIT_DEPTH
    description: >
      Bits per pixel of AVIF image.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  alpha:
    type: labeled_counter
    labels:
      - absent
      - present
    gecko_datapoint: AVIF_ALPHA
    description: >
      AVIF alpha plane.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  colr:
    type: labeled_counter
    labels:
      - nclx
      - icc
      - absent
      - both
    gecko_datapoint: AVIF_COLR
    description: >
      AVIF colour information type.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1729071
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1729071#c15
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  cicp_cp:
    type: labeled_counter
    labels:
      - reserved
      - bt709
      - unspecified
      - reserved_3
      - bt470m
      - bt470bg
      - bt601
      - smpte240
      - generic_film
      - bt2020
      - xyz
      - smpte431
      - smpte432
      - reserved_13
      - reserved_14
      - reserved_15
      - reserved_16
      - reserved_17
      - reserved_18
      - reserved_19
      - reserved_20
      - reserved_21
      - ebu3213
      - reserved_rest
    gecko_datapoint: AVIF_CICP_CP
    description: >
      AVIF CICP colour primaries.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  cicp_tc:
    type: labeled_counter
    labels:
      - reserved
      - bt709
      - unspecified
      - reserved_3
      - bt470m
      - bt470bg
      - bt601
      - smpte240
      - linear
      - log_100
      - log_100_sqrt10
      - iec61966
      - bt_1361
      - srgb
      - bt2020_10bit
      - bt2020_12bit
      - smpte2084
      - smpte428
      - hlg
      - reserved_rest
    gecko_datapoint: AVIF_CICP_TC
    description: >
      AVIF CICP transfer characteristics.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  cicp_mc:
    type: labeled_counter
    labels:
      - identity
      - bt709
      - unspecified
      - reserved
      - fcc
      - bt470bg
      - bt601
      - smpte240
      - ycgco
      - bt2020_ncl
      - bt2020_cl
      - smpte2085
      - chromat_ncl
      - chromat_cl
      - ictcp
      - reserved_rest
    gecko_datapoint: AVIF_CICP_MC
    description: >
      AVIF CICP transfer characteristics.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  ispe:
    type: labeled_counter
    labels:
      - valid
      - absent
      - bitstream_mismatch
    gecko_datapoint: AVIF_ISPE
    description: >
      AVIF spatial extents (image size).
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  pixi:
    type: labeled_counter
    labels:
      - valid
      - absent
      - bitstream_mismatch
    gecko_datapoint: AVIF_PIXI
    description: >
      AVIF pixel information (bits per channel).
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  pasp:
    type: labeled_counter
    labels:
      - absent
      - square
      - nonsquare
      - invalid
    gecko_datapoint: AVIF_PASP
    description: >
      AVIF pixel aspect ratio.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  major_brand:
    type: labeled_counter
    labels:
      - avif
      - avis
      - other
    description: >
      AVIF major brand.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  sequence:
    type: labeled_counter
    labels:
      - present
      - absent
    description: >
      AVIF image sequence.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  a1lx:
    type: labeled_counter
    labels:
      - present
      - absent
    gecko_datapoint: AVIF_A1LX
    description: >
      AV1LayeredImageIndexingProperty (a1lx).
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  a1op:
    type: labeled_counter
    labels:
      - present
      - absent
    gecko_datapoint: AVIF_A1OP
    description: >
      AVIF OperatingPointSelectorProperty (a1op).
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  clap:
    type: labeled_counter
    labels:
      - present
      - absent
    gecko_datapoint: AVIF_CLAP
    description: >
      AVIF CleanApertureBox (clap).
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  grid:
    type: labeled_counter
    labels:
      - present
      - absent
    gecko_datapoint: AVIF_GRID
    description: >
      AVIF AVIF grid-based image.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  ipro:
    type: labeled_counter
    labels:
      - present
      - absent
    gecko_datapoint: AVIF_IPRO
    description: >
      AVIF ItemProtectionBox (ipro).
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  lsel:
    type: labeled_counter
    labels:
      - present
      - absent
    gecko_datapoint: AVIF_LSEL
    description: >
      AVIF LayerSelectorProperty (lsel).
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

network:
  cache_hit_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: NETWORK_CACHE_V2_HIT_TIME_MS
    description: >
      Time to open existing cache entry file.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - necko@mozilla.com
    expires: never

  tls_handshake:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: HTTP_PAGE_TLS_HANDSHAKE
    description: >
      In the HTTP page channel, time from after the TCP SYN packet is
      received to the secure connection is established and ready for HTTP.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=772589
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - necko@mozilla.com
      - ddamjanovic@mozilla.com
    expires: never

  tcp_connection:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: HTTP_PAGE_TCP_CONNECTION_2
    description: >
      In the HTTP page channel, time from the TCP SYN packet is received to
      the connection is established and ready for HTTP.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=772589
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - necko@mozilla.com
      - ddamjanovic@mozilla.com
    expires: never

  dns_start:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: HTTP_PAGE_DNS_ISSUE_TIME
    description: >
      In the HTTP page channel, time from connection open to the DNS request
      being issued.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - necko@mozilla.com
      - vogosu@mozilla.com
    expires: never

  dns_end:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: HTTP_PAGE_DNS_LOOKUP_TIME
    description: >
      In the HTTP page channel, time from the DNS request being issued to
      the response.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - necko@mozilla.com
      - vogosu@mozilla.com
    expires: never

  font_download_end:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: WEBFONT_DOWNLOAD_TIME_AFTER_START
    description: >
      Time after navigationStart that all webfont downloads are completed.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - perf-telemetry-alerts@mozilla.com
      - necko@mozilla.com
      - bdekoz@mozilla.com
    expires: never

  first_from_cache:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: HTTP_PAGE_OPEN_TO_FIRST_FROM_CACHE_V2
    description: >
      In the HTTP page channel, time from connection open to cache read start.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - necko@mozilla.com
    expires: never

performance.pageload:
  load_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: PERF_PAGE_LOAD_TIME_MS
    description: >
      Time in milliseconds from navigationStart to loadEventStart
      for the foreground http or https root content document.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  load_time_responsestart:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: PERF_PAGE_LOAD_TIME_FROM_RESPONSESTART_MS
    description: >
      Time in milliseconds from responseStart to loadEventStart
      for the foreground http or https root content document.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  dcl:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: PERF_DOM_CONTENT_LOADED_MS
    description: >
      Time in milliseconds from navigationStart to domContentLoaded
      for the foreground http or https root content document.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  dcl_responsestart:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: PERF_DOM_CONTENT_LOADED_FROM_RESPONSESTART_MS
    description: >
      Time in milliseconds from responseStart to domContentLoaded
      for the foreground http or https root content document.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  fcp:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: PERF_FIRST_CONTENTFUL_PAINT_MS
    description: >
      The time between navigationStart and the first contentful paint
      of a foreground http or https root content document, in
      milliseconds. The contentful paint timestamp is taken during
      display list building and does not include rasterization or
      compositing of that paint.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  fcp_responsestart:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: PERF_FIRST_CONTENTFUL_PAINT_FROM_RESPONSESTART_MS
    description: >
      The time between responseStart and the first contentful paint
      of a foreground http or https root content document, in
      milliseconds. The contentful paint timestamp is taken during
      display list building and does not include rasterization or
      compositing of that paint.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  req_anim_frame_callback:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: PERF_REQUEST_ANIMATION_CALLBACK_PAGELOAD_MS
    description: >
      Time spent in milliseconds calling all request animation frame callbacks
      for a document before it has reached readystate complete.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

performance.responsiveness:
  req_anim_frame_callback:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: PERF_REQUEST_ANIMATION_CALLBACK_NON_PAGELOAD_MS
    description: >
      Time spent in milliseconds calling all request animation frame callbacks
      for a document after it has reached readystate complete.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never


performance.time:
  response_start:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: TIME_TO_RESPONSE_START_MS
    description: >
      Time from navigationStart to responseStart as per the W3C
      Performance Timing API.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - vchin@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  dom_interactive:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: TIME_TO_DOM_INTERACTIVE_MS
    description: >
      Time from navigationStart to domInteractive as per the W3C
      Performance Timing API.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?1344893
      - https://bugzilla.mozilla.org/show_bug.cgi?1489524
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - vgosu@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  dom_content_loaded_start:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: TIME_TO_DOM_CONTENT_LOADED_START_MS
    description: >
      Time from navigationStart to domContentLoadedEventStart as per
      the W3C Performance Timing API.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - perf-telemetry-alerts@mozilla.com
      - bdekoz@mozilla.com
    expires: never

  dom_content_loaded_end:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: TIME_TO_DOM_CONTENT_LOADED_END_MS
    description: >
      Time from navigationStart to domContentLoadedEventEnd as per
      the W3C Performance Timing API.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - vchin@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  dom_complete:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: TIME_TO_DOM_COMPLETE_MS
    description: >
      Time from navigationStart to domComplete as per the W3C Performance
      Timing API.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - vgosu@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  load_event_start:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: TIME_TO_LOAD_EVENT_START_MS
    description: >
      Time from navigationStart to loadEventStart as per the W3C Performance
      Timing API.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - perf-telemetry-alerts@mozilla.com
      - bdekoz@mozilla.com
    expires: never

  load_event_end:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: TIME_TO_LOAD_EVENT_END_MS
    description: >
      Time from navigationStart to loadEventEnd as per the W3C Performance
      Timing API.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - vchin@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

performance.page:
  non_blank_paint:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: TIME_TO_NON_BLANK_PAINT_MS
    description: >
      The time between navigationStart and the first non-blank paint of a
      foreground root content document, in milliseconds. This only records
      documents that were in an active docshell throughout the whole time
      between navigation start and non-blank paint. The non-blank paint
      timestamp is taken during display list building and does not include
      rasterization or compositing of that paint.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1307242
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - vchin@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

  total_content_page_load:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: TOTAL_CONTENT_PAGE_LOAD_TIME
    description: >
      Time to load all of a page's resources and render.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - perf-telemetry-alerts@mozilla.com
      - bdekoz@mozilla.com
    expires: never

performance.interaction:
  keypress_present_latency:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: KEYPRESS_PRESENT_LATENCY
    description: >
      Time between receiving a keypress event in the event loop and compositing
      its result onto the screen.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1506537
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - perf-telemetry-alerts@mozilla.com
      - vchin@mozilla.com
    expires: never

  mouseup_click_present_latency:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: MOUSEUP_FOLLOWED_BY_CLICK_PRESENT_LATENCY
    description: >
      Time between receiving a mouseup which follow by a mouseclick
      on the event loop and compositing its result onto the screen.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1698643
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1698643#c3
    notification_emails:
      - perf-telemetry-alerts@mozilla.com
      - sefeng@mozilla.com
    expires: never

  tab_switch_composite:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: FX_TAB_SWITCH_COMPOSITE_E10S_MS
    description: >
      Time between tab selection and first composite of the tab content onto the
      screen.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1481704
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1529352
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
    notification_emails:
      - mconley@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

javascript.pageload:
  execution_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: JS_PAGELOAD_EXECUTION_MS
    description: >
      Time spent during page load executing Javascript in ms.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never
  delazification_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: JS_PAGELOAD_DELAZIFICATION_MS
    description: >
      Time spent during page load delazifying Javascript in ms.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never
  xdr_encode_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: JS_PAGELOAD_XDR_ENCODING_MS
    description: >
      Time spent during page load XDR encoding Javascript in ms.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never
  baseline_compile_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: JS_PAGELOAD_BASELINE_COMPILE_MS
    description: >
      Time spent during page load baseline compiling Javascript in ms.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never
  gc_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: JS_PAGELOAD_GC_MS
    description: >
      Time spent during page load in the GC in ms.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never
  parse_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: JS_PAGELOAD_PARSE_MS
    description: >
      Time spent during page load syntax parsing JS scripts on
      the main thread in ms.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never
  protect_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: JS_PAGELOAD_PROTECT_MS
    description: >
      Time spent during page load protecting JIT executable memory.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
    notification_emails:
      - dpalmeiro@mozilla.com
      - perf-telemetry-alerts@mozilla.com
    expires: never

javascript.gc:
  total_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GC_MS
    description: >
      The total time taken by a major collection.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c8
    notification_emails:
      - dev-telemetry-gc-alerts@mozilla.org
      - jcoppeard@mozilla.com
    expires: never

  minor_time:
    type: timing_distribution
    time_unit: microsecond
    gecko_datapoint: GC_MINOR_US
    description: >
      The time taked by a minor (nursery) collection.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
    notification_emails:
      - dev-telemetry-gc-alerts@mozilla.org
      - jcoppeard@mozilla.com
    expires: never

  prepare_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GC_PREPARE_MS
    description: >
      The time spent in the preparation phase.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
    notification_emails:
      - dev-telemetry-gc-alerts@mozilla.org
      - jcoppeard@mozilla.com
    expires: never

  mark_roots_time:
    type: timing_distribution
    time_unit: microsecond
    gecko_datapoint: GC_MARK_ROOTS_US
    description: >
      The time spent marking GC roots.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
    notification_emails:
      - dev-telemetry-gc-alerts@mozilla.org
      - jcoppeard@mozilla.com
    expires: never

  mark_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GC_MARK_MS
    description: >
      The time spent in the mark phase.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
    notification_emails:
      - dev-telemetry-gc-alerts@mozilla.org
      - jcoppeard@mozilla.com
    expires: never

  sweep_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GC_SWEEP_MS
    description: >
      The time spent in the sweep phase.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
    notification_emails:
      - dev-telemetry-gc-alerts@mozilla.org
      - jcoppeard@mozilla.com
    expires: never

  compact_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GC_COMPACT_MS
    description: >
      The time spent in the compact phase.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
    notification_emails:
      - dev-telemetry-gc-alerts@mozilla.org
      - jcoppeard@mozilla.com
    expires: never

  slice_time:
    type: timing_distribution
    time_unit: millisecond
    gecko_datapoint: GC_SLICE_MS
    description: >
      The time spent running a GC slice.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
    notification_emails:
      - dev-telemetry-gc-alerts@mozilla.org
      - jcoppeard@mozilla.com
    expires: never

performance.clone.deserialize:
  size:
    description: >
      Size of deserialized data, in bytes
    type: memory_distribution
    memory_unit: byte
    gecko_datapoint: DESERIALIZE_BYTES
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631#c4
    notification_emails:
      - sfink@mozilla.com
    expires: never

  items:
    description: >
      Size of deserialized data, in items
    type: custom_distribution
    unit: Serialized items
    histogram_type: exponential
    range_max: 2147483646
    bucket_count: 50
    gecko_datapoint: DESERIALIZE_ITEMS
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631#c4
    notification_emails:
      - sfink@mozilla.com
    expires: never

  time:
    description: >
      Time spent deserializing structured data
    type: timing_distribution
    time_unit: microsecond
    gecko_datapoint: DESERIALIZE_US
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631#c4
    notification_emails:
      - sfink@mozilla.com
    expires: never

media.audio:
  init_failure:
    type: labeled_counter
    labels:
      - first
      - other
    gecko_datapoint: MEDIA_AUDIO_INIT_FAILURE
    description: >
      Failure occurs when initializing the audio stream.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714#c10
    notification_emails:
      - media-alerts@mozilla.com
    expires: never

  backend:
    type: labeled_counter
    labels:
      - unknown
      - audiounit
      - audiounit_rust
      - aaudio
      - opensl
      - wasapi
      - winmm
      - alsa
      - jack
      - oss
      - pulse
      - pulse_rust
      - sndio
      - sun
    gecko_datapoint: MEDIA_AUDIO_BACKEND
    description: >
      The operating system audio backend
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714#c10
    notification_emails:
      - media-alerts@mozilla.com
    expires: never