gfx/metrics.yaml

   1 # This Source Code Form is subject to the terms of the Mozilla Public
   2 # License, v. 2.0. If a copy of the MPL was not distributed with this
   3 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
   4
   5 # Adding a new metric? We have docs for that!
   6 # https://firefox-source-docs.mozilla.org/toolkit/components/glean/user/new_definitions_file.html
   7
   8 ---
   9 $schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
  10 $tags:
  11   - 'Core :: Graphics'
  12
  13 paint:
  14   build_displaylist_time:
  15     type: timing_distribution
  16     description: >
  17       The time to build a Gecko display list.
  18     bugs:
  19       - https://bugzilla.mozilla.org/show_bug.cgi?id=1728423
  20     data_reviews:
  21       - https://bugzilla.mozilla.org/show_bug.cgi?id=1728423
  22     data_sensitivity:
  23       - technical
  24     notification_emails:
  25       - gfx-telemetry-alerts@mozilla.com
  26       - mwoodrow@mozilla.com
  27     expires: never
  28     telemetry_mirror: PAINT_BUILD_DISPLAYLIST_TIME
  29
  30 gpu_process:
  31   feature_status:
  32     type: string
  33     description: >
  34       Current status of the GPU process feature
  35     bugs:
  36       - https://bugzilla.mozilla.org/show_bug.cgi?id=1870021
  37     data_reviews:
  38       - https://bugzilla.mozilla.org/show_bug.cgi?id=1870021
  39     data_sensitivity:
  40       - technical
  41     notification_emails:
  42       - gfx-telemetry-alerts@mozilla.com
  43       - jnicol@mozilla.com
  44     expires: never
  45   crash_fallbacks:
  46     type: labeled_counter
  47     description: >
  48       How often we use different fallbacks when the GPU process crashes
  49     labels:
  50       - none
  51       - decoding_disabled
  52       - disabled
  53     bugs:
  54       - https://bugzilla.mozilla.org/show_bug.cgi?id=1870021
  55     data_reviews:
  56       - https://bugzilla.mozilla.org/show_bug.cgi?id=1870021
  57     data_sensitivity:
  58       - technical
  59     notification_emails:
  60       - gfx-telemetry-alerts@mozilla.com
  61       - jnicol@mozilla.com
  62     expires: never
  63   total_launch_attempts:
  64     type: quantity
  65     description: >
  66       The number of total GPU process launch attempts.
  67     unit: launches
  68     bugs:
  69       - https://bugzilla.mozilla.org/show_bug.cgi?id=1870021
  70     data_reviews:
  71       - https://bugzilla.mozilla.org/show_bug.cgi?id=1870021
  72     data_sensitivity:
  73       - technical
  74     notification_emails:
  75       - gfx-telemetry-alerts@mozilla.com
  76       - jnicol@mozilla.com
  77     expires: never
  78   unstable_launch_attempts:
  79     type: quantity
  80     description: >
  81       The number of consecutive unstable launch attempts.
  82     unit: launches
  83     bugs:
  84       - https://bugzilla.mozilla.org/show_bug.cgi?id=1870021
  85     data_reviews:
  86       - https://bugzilla.mozilla.org/show_bug.cgi?id=1870021
  87     data_sensitivity:
  88       - technical
  89     notification_emails:
  90       - gfx-telemetry-alerts@mozilla.com
  91       - jnicol@mozilla.com
  92     expires: never
  93
  94 wr:
  95   gpu_wait_time:
  96     type: timing_distribution
  97     description: >
  98       The time spent waiting for the GPU to complete previously issued drawing
  99       commands.
 100     time_unit: microsecond
 101     bugs:
 102       - https://bugzilla.mozilla.org/show_bug.cgi?id=1772216
 103     data_reviews:
 104       - https://bugzilla.mozilla.org/show_bug.cgi?id=1772216
 105     data_sensitivity:
 106       - technical
 107     notification_emails:
 108       - gfx-telemetry-alerts@mozilla.com
 109     expires: never
 110     telemetry_mirror: WR_GPU_WAIT_TIME
 111   rasterize_glyphs_time:
 112     type: timing_distribution
 113     description: >
 114       The time to rasterize glyphs for consumption by WebRender.
 115     time_unit: microsecond
 116     bugs:
 117       - https://bugzilla.mozilla.org/show_bug.cgi?id=1728423
 118     data_reviews:
 119       - https://bugzilla.mozilla.org/show_bug.cgi?id=1728423
 120     data_sensitivity:
 121       - technical
 122     notification_emails:
 123       - gfx-telemetry-alerts@mozilla.com
 124     expires: never
 125     telemetry_mirror: WR_RASTERIZE_GLYPHS_TIME
 126   rasterize_blobs_time:
 127     type: timing_distribution
 128     description: >
 129       The time to rasterize blobs for consumption by WebRender.
 130     time_unit: microsecond
 131     bugs:
 132       - https://bugzilla.mozilla.org/show_bug.cgi?id=1770974
 133     data_reviews:
 134       - https://bugzilla.mozilla.org/show_bug.cgi?id=1770974
 135     data_sensitivity:
 136       - technical
 137     notification_emails:
 138       - gfx-telemetry-alerts@mozilla.com
 139     expires: never
 140     telemetry_mirror: WR_RASTERIZE_BLOBS_TIME
 141   renderer_time:
 142     type: timing_distribution
 143     description: >
 144       WebRender renderer time.
 145     time_unit: microsecond
 146     bugs:
 147       - https://bugzilla.mozilla.org/show_bug.cgi?id=1772223
 148     data_reviews:
 149       - https://bugzilla.mozilla.org/show_bug.cgi?id=1772223
 150     data_sensitivity:
 151       - technical
 152     notification_emails:
 153       - gfx-telemetry-alerts@mozilla.com
 154     expires: never
 155     telemetry_mirror: WR_RENDERER_TIME
 156   renderer_time_no_sc:
 157     type: timing_distribution
 158     description: >
 159       WebRender renderer time excluding frames in which shader compilation took
 160       place.
 161     time_unit: microsecond
 162     bugs:
 163       - https://bugzilla.mozilla.org/show_bug.cgi?id=1784286
 164     data_reviews:
 165       - https://bugzilla.mozilla.org/show_bug.cgi?id=1784286
 166     data_sensitivity:
 167       - technical
 168     notification_emails:
 169       - gfx-telemetry-alerts@mozilla.com
 170     expires: never
 171     telemetry_mirror: WR_RENDERER_TIME_NO_SC_MS
 172   framebuild_time:
 173     type: timing_distribution
 174     description: >
 175       The time to rasterize glyphs for consumption by WebRender.
 176     time_unit: microsecond
 177     bugs:
 178       - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
 179       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 180     data_reviews:
 181       - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
 182       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 183     data_sensitivity:
 184       - technical
 185     notification_emails:
 186       - gfx-telemetry-alerts@mozilla.com
 187       - jmuizelaar@mozilla.com
 188     expires: never
 189     telemetry_mirror: WR_FRAMEBUILD_TIME
 190   scenebuild_time:
 191     type: timing_distribution
 192     description: >
 193       WebRender scene build time.
 194     time_unit: microsecond
 195     bugs:
 196       - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
 197     data_reviews:
 198       - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
 199     data_sensitivity:
 200       - technical
 201     notification_emails:
 202       - gfx-telemetry-alerts@mozilla.com
 203       - jmuizelaar@mozilla.com
 204     expires: never
 205     telemetry_mirror: WR_SCENEBUILD_TIME
 206   sceneswap_time:
 207     type: timing_distribution
 208     description: >
 209       WebRender scene swap time.
 210     time_unit: microsecond
 211     bugs:
 212       - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
 213     data_reviews:
 214       - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
 215     data_sensitivity:
 216       - technical
 217     notification_emails:
 218       - gfx-telemetry-alerts@mozilla.com
 219       - jmuizelaar@mozilla.com
 220     expires: never
 221     telemetry_mirror: WR_SCENESWAP_TIME
 222   texture_cache_update_time:
 223     type: timing_distribution
 224     description: >
 225       Time taken by WebRender to update the texture cache.
 226     time_unit: microsecond
 227     bugs:
 228       - https://bugzilla.mozilla.org/show_bug.cgi?id=1772223
 229     data_reviews:
 230       - https://bugzilla.mozilla.org/show_bug.cgi?id=1772223
 231     data_sensitivity:
 232       - technical
 233     notification_emails:
 234       - gfx-telemetry-alerts@mozilla.com
 235     expires: never
 236     telemetry_mirror: WR_TEXTURE_CACHE_UPDATE_TIME
 237   time_to_frame_build:
 238     type: timing_distribution
 239     description: >
 240       Time elapsed between the construction of a transaction and the
 241       associated frame build beginning.
 242     time_unit: microsecond
 243     bugs:
 244       - https://bugzilla.mozilla.org/show_bug.cgi?id=1778395
 245     data_reviews:
 246       - https://bugzilla.mozilla.org/show_bug.cgi?id=1778395
 247     data_sensitivity:
 248       - technical
 249     notification_emails:
 250       - gfx-telemetry-alerts@mozilla.com
 251     expires: never
 252     telemetry_mirror: WR_TIME_TO_FRAME_BUILD_MS
 253   time_to_render_start:
 254     type: timing_distribution
 255     description: >
 256       Time elapsed between the construction of a frame and the start of
 257       rendering.
 258     time_unit: microsecond
 259     bugs:
 260       - https://bugzilla.mozilla.org/show_bug.cgi?id=1778395
 261     data_reviews:
 262       - https://bugzilla.mozilla.org/show_bug.cgi?id=1778395
 263     data_sensitivity:
 264       - technical
 265     notification_emails:
 266       - gfx-telemetry-alerts@mozilla.com
 267     expires: never
 268     telemetry_mirror: WR_TIME_TO_RENDER_START_MS
 269
 270 gfx:
 271   composite_time:
 272     type: timing_distribution
 273     time_unit: millisecond
 274     telemetry_mirror: COMPOSITE_TIME
 275     description: >
 276       The time taken to composite a frame.
 277       On non-webrender this is the time taken in
 278       `CompositorBridgeParent::CompositeToTarget()`.
 279       On webrender, this is the time taken from the start of
 280       `WebRenderBridgeParent::CompositeToTarget()`,
 281       until the render thread has rendered the frame (in
 282       `RenderThread::HandleFrameOneDoc()`).
 283       (Migrated from the geckoview metric of the same name).
 284     bugs:
 285       - https://bugzilla.mozilla.org/show_bug.cgi?id=1080160
 286       - https://bugzilla.mozilla.org/show_bug.cgi?id=1529352
 287       - https://bugzilla.mozilla.org/show_bug.cgi?id=1580129
 288       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 289     data_reviews:
 290       - https://bugzilla.mozilla.org/show_bug.cgi?id=1580129#c7
 291     notification_emails:
 292       - gfx-telemetry-alerts@mozilla.com
 293       - jnicol@mozilla.com
 294     expires: never
 295
 296   scroll_present_latency:
 297     type: timing_distribution
 298     time_unit: millisecond
 299     description: >
 300       Time between receiving a scroll
 301       event on the event loop and compositing
 302       its result onto the screen (ms).
 303       (Migrated from the geckoview metric of the same name).
 304     telemetry_mirror: SCROLL_PRESENT_LATENCY
 305     bugs:
 306       - https://bugzilla.mozilla.org/show_bug.cgi?id=1604818
 307       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 308     data_reviews:
 309       - https://bugzilla.mozilla.org/show_bug.cgi?id=1604818#c4
 310     notification_emails:
 311       - sefeng@mozilla.com
 312       - perf-telemetry-alerts@mozilla.com
 313     expires: never
 314
 315 gfx.display:
 316   count:
 317     description: >
 318       Amount of displays connected to the device
 319       (Migrated from the geckoview metric of the same name).
 320     type: quantity
 321     unit: Display count
 322     # Temporary misuse of the user lifetime approved by Glean team
 323     # due to limitations in Geckoview streaming telemetry.
 324     # DO NOT DUPLICATE unless approved by Glean team.
 325     lifetime: user
 326     bugs:
 327       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 328       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 329       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 330     data_reviews:
 331       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 332     notification_emails:
 333       - gfx-telemetry-alerts@mozilla.com
 334     expires: never
 335   primary_width:
 336     description: >
 337       Width of the primary display, takes device rotation into account.
 338       (Migrated from the geckoview metric of the same name).
 339     type: quantity
 340     unit: Pixels
 341     # Temporary misuse of the user lifetime approved by Glean team
 342     # due to limitations in Geckoview streaming telemetry.
 343     # DO NOT DUPLICATE unless approved by Glean team.
 344     lifetime: user
 345     bugs:
 346       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 347       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 348       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 349     data_reviews:
 350       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 351     notification_emails:
 352       - gfx-telemetry-alerts@mozilla.com
 353     expires: never
 354   primary_height:
 355     description: >
 356       Height of the primary display, takes device rotation into account.
 357       (Migrated from the geckoview metric of the same name).
 358     type: quantity
 359     unit: Pixels
 360     # Temporary misuse of the user lifetime approved by Glean team
 361     # due to limitations in Geckoview streaming telemetry.
 362     # DO NOT DUPLICATE unless approved by Glean team.
 363     lifetime: user
 364     bugs:
 365       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 366       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 367       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 368     data_reviews:
 369       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 370     notification_emails:
 371       - gfx-telemetry-alerts@mozilla.com
 372     expires: never
 373
 374
 375 gfx.checkerboard:
 376   duration:
 377     type: timing_distribution
 378     time_unit: millisecond
 379     telemetry_mirror: CHECKERBOARD_DURATION
 380     description: >
 381       The duration of a checkerboard event.
 382       Checkerboarding is when painting has not kept up with asynchronous
 383       panning and zooming so the compositor has to display a "checkerboard
 384       pattern" (or in practice, the background color) rather than the actual
 385       page content.
 386       (Migrated from the geckoview metric of the same name).
 387     bugs:
 388       - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
 389       - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
 390       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 391       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 392     data_reviews:
 393       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 394     notification_emails:
 395       - gfx-telemetry-alerts@mozilla.com
 396       - botond@mozilla.com
 397     expires: never
 398
 399   peak_pixel_count:
 400     type: custom_distribution
 401     range_max: 66355200
 402     bucket_count: 50
 403     histogram_type: exponential
 404     unit: Pixels
 405     telemetry_mirror: CHECKERBOARD_PEAK
 406     description: >
 407       The peak number of CSS pixels that checkerboarded during a checkerboard
 408       event. The minimum value of the largest histogram bucket is the size of
 409       a 4k display with maximum APZ zooming.
 410       (Migrated from the geckoview metric of the same name).
 411     bugs:
 412       - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
 413       - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
 414       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 415       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 416     data_reviews:
 417       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 418     notification_emails:
 419       - gfx-telemetry-alerts@mozilla.com
 420       - botond@mozilla.com
 421     expires: never
 422
 423   potential_duration:
 424     type: timing_distribution
 425     time_unit: millisecond
 426     telemetry_mirror: CHECKERBOARD_POTENTIAL_DURATION
 427     description: >
 428       The total amount of time that we could reasonably be checkerboarding.
 429       This is the union of two possibly-intersecting sets of time periods:
 430       The first set is that in which checkerboarding was actually happening,
 431       since by definition it could potentially be happening.
 432       The second set is that in which the APZC is actively transforming content
 433       in the compositor, since it could potentially transform it so as to
 434       display checkerboarding to the user. Combined with other information,
 435       this allows us to meaningfully say how frequently users actually
 436       enncounters checkerboarding.
 437       (Migrated from the geckoview metric of the same name).
 438     bugs:
 439       - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
 440       - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
 441       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 442       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 443     data_reviews:
 444       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 445     notification_emails:
 446       - gfx-telemetry-alerts@mozilla.com
 447       - botond@mozilla.com
 448     expires: never
 449
 450   severity:
 451     type: custom_distribution
 452     range_max: 1073741824
 453     bucket_count: 50
 454     histogram_type: exponential
 455     unit: Opaque unit
 456     telemetry_mirror: CHECKERBOARD_SEVERITY
 457     description: >
 458       An opaque measurement of the severity of a checkerboard event.
 459       This doesn't have units, it's just useful for comparing two checkerboard
 460       events to see which one is worse, for some implementation-specific
 461       definition of "worse". The larger the value, the worse the
 462       checkerboarding.
 463       (Migrated from the geckoview metric of the same name).
 464     bugs:
 465       - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
 466       - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
 467       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 468       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 469     data_reviews:
 470       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 471     notification_emails:
 472       - gfx-telemetry-alerts@mozilla.com
 473       - botond@mozilla.com
 474     expires: never
 475
 476 gfx.feature:
 477   webrender:
 478     type: string
 479     description: >
 480       Whether webrender is enabled or disabled, and why.
 481       (Migrated from the geckoview metric of the same name).
 482     lifetime: application
 483     bugs:
 484       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687312
 485       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 486     data_reviews:
 487       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687312#c5
 488     notification_emails:
 489       - gfx-telemetry-alerts@mozilla.com
 490       - jnicol@mozilla.com
 491     expires: never
 492
 493 gfx.status:
 494   compositor:
 495     description: >
 496       Name of the graphics compositor in use.
 497       Possible values are "opengl, d3d11, client, webrender or basic"
 498       (Migrated from the geckoview metric of the same name).
 499     type: string
 500     # Temporary misuse of the user lifetime approved by Glean team
 501     # due to limitations in Geckoview streaming telemetry.
 502     # DO NOT DUPLICATE unless approved by Glean team.
 503     lifetime: user
 504     bugs:
 505       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 506       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 507       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 508     data_reviews:
 509       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 510     notification_emails:
 511       - gfx-telemetry-alerts@mozilla.com
 512     expires: never
 513   last_compositor_gecko_version:
 514     description: >
 515       The gecko version at the last time a compositor was initialized, and
 516       therefore when gfx_status_compositor was last updated. Due to
 517       gfx_status_compositor's user lifetime we see lots of unexpected values for
 518       the current gecko version. We believe this is because the user has not
 519       opened a tab since they were updated to a version where webrender should
 520       be enabled on their device. This can be used to verify that theory.
 521       (Migrated from the geckoview metric of the same name).
 522     type: string
 523     # Temporary misuse of the user lifetime approved by Glean team
 524     # due to limitations in Geckoview streaming telemetry.
 525     # DO NOT DUPLICATE unless approved by Glean team.
 526     lifetime: user
 527     bugs:
 528       - https://bugzilla.mozilla.org/show_bug.cgi?id=1704842
 529       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 530     data_reviews:
 531       - https://bugzilla.mozilla.org/show_bug.cgi?id=1704842#c8
 532     notification_emails:
 533       - jnicol@mozilla.com
 534       - gfx-telemetry-alerts@mozilla.com
 535     expires: never
 536   headless:
 537     description: >
 538       Boolean indicated whether graphics is running in
 539       headless (no display) mode
 540       (Migrated from the geckoview metric of the same name).
 541     type: boolean
 542     # Temporary misuse of the user lifetime approved by Glean team
 543     # due to limitations in Geckoview streaming telemetry.
 544     # DO NOT DUPLICATE unless approved by Glean team.
 545     lifetime: user
 546     bugs:
 547       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 548       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 549       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 550     data_reviews:
 551       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 552     notification_emails:
 553       - gfx-telemetry-alerts@mozilla.com
 554     expires: never
 555
 556 gfx.content.frame_time:
 557   from_paint:
 558     type: custom_distribution
 559     range_max: 5000
 560     bucket_count: 50
 561     histogram_type: exponential
 562     unit: Percentage of vsync interval
 563     telemetry_mirror: CONTENT_FRAME_TIME
 564     description: >
 565       The time, in percentage of a vsync interval, spent from beginning a paint
 566       in the content process until that frame is presented in the compositor.
 567       (Migrated from the geckoview metric of the same name).
 568     bugs:
 569       - https://bugzilla.mozilla.org/show_bug.cgi?id=1470528
 570       - https://bugzilla.mozilla.org/show_bug.cgi?id=1509536
 571       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 572       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 573     data_reviews:
 574       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 575     notification_emails:
 576       - gfx-telemetry-alerts@mozilla.com
 577       - jnicol@mozilla.com
 578     expires: never
 579
 580   from_vsync:
 581     type: custom_distribution
 582     range_min: 8
 583     range_max: 792
 584     bucket_count: 100
 585     histogram_type: linear
 586     unit: Percentage of vsync interval
 587     telemetry_mirror: CONTENT_FRAME_TIME_VSYNC
 588     description: >
 589       The time, in percentage of a vsync interval, spent from the vsync that
 590       started a paint in the content process until that frame is presented in
 591       the compositor.
 592       (Migrated from the geckoview metric of the same name).
 593     bugs:
 594       - https://bugzilla.mozilla.org/show_bug.cgi?id=1517355
 595       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 596       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 597     data_reviews:
 598       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 599     notification_emails:
 600       - gfx-telemetry-alerts@mozilla.com
 601     expires: never
 602
 603   with_svg:
 604     type: custom_distribution
 605     range_max: 5000
 606     bucket_count: 50
 607     histogram_type: exponential
 608     unit: Percentage of vsync interval
 609     telemetry_mirror: CONTENT_FRAME_TIME_WITH_SVG
 610     description: >
 611       The time, in percentage of a vsync interval, spent from beginning a paint
 612       in the content process until that frame is presented in the compositor,
 613       for frames that contained an SVG to be drawn by webrender.
 614       (Migrated from the geckoview metric of the same name).
 615     bugs:
 616       - https://bugzilla.mozilla.org/show_bug.cgi?id=1483549
 617       - https://bugzilla.mozilla.org/show_bug.cgi?id=1509536
 618       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 619       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 620     data_reviews:
 621       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 622     notification_emails:
 623       - gfx-telemetry-alerts@mozilla.com
 624     expires: never
 625
 626   without_resource_upload:
 627     type: custom_distribution
 628     range_max: 5000
 629     bucket_count: 50
 630     histogram_type: exponential
 631     unit: Percentage of vsync interval
 632     telemetry_mirror: CONTENT_FRAME_TIME_WITHOUT_RESOURCE_UPLOAD
 633     description: >
 634       The time, in percentage of a vsync interval, spent from beginning a paint
 635       in the content process until that frame is presented in the compositor by
 636       webrender, excluding time spent uploading resources.
 637       (Migrated from the geckoview metric of the same name).
 638     bugs:
 639       - https://bugzilla.mozilla.org/show_bug.cgi?id=1503405
 640       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 641       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 642     data_reviews:
 643       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 644     notification_emails:
 645       - gfx-telemetry-alerts@mozilla.com
 646     expires: never
 647
 648   without_upload:
 649     type: custom_distribution
 650     range_max: 5000
 651     bucket_count: 50
 652     histogram_type: exponential
 653     unit: Percentage of vsync interval
 654     telemetry_mirror: CONTENT_FRAME_TIME_WITHOUT_UPLOAD
 655     description: >
 656       The time, in percentage of a vsync interval, spent from beginning a paint
 657       in the content process until that frame is presented in the compositor by
 658       webrender, excluding time spent uploading any content.
 659       (Migrated from the geckoview metric of the same name).
 660     bugs:
 661       - https://bugzilla.mozilla.org/show_bug.cgi?id=1503405
 662       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 663       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 664     data_reviews:
 665       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 666     notification_emails:
 667       - gfx-telemetry-alerts@mozilla.com
 668     expires: never
 669
 670   reason:
 671     type: labeled_counter
 672     labels:
 673       - on_time
 674       - no_vsync
 675       - missed_composite
 676       - slow_composite
 677       - missed_composite_mid
 678       - missed_composite_long
 679       - missed_composite_low
 680       - no_vsync_no_id
 681     description: >
 682       The reason that `gfx.content.frame_time.from_paint` recorded a slow
 683       (>200ms) result, if any.
 684       (Migrated from the geckoview metric of the same name).
 685     bugs:
 686       - https://bugzilla.mozilla.org/show_bug.cgi?id=1510853
 687       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 688       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 689     data_reviews:
 690       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 691     notification_emails:
 692       - gfx-telemetry-alerts@mozilla.com
 693     expires: never
 694
 695 gfx.content:
 696   paint_time:
 697     type: timing_distribution
 698     time_unit: millisecond
 699     telemetry_mirror: CONTENT_PAINT_TIME
 700     description: >
 701       Time spent in the main-thread paint pipeline for content.
 702       For non-webrender, this includes display list building, layer building,
 703       and when OMTP is disabled, rasterization.
 704       For webrender, this includes display list building, and webrender display
 705       list building.
 706       (Migrated from the geckoview metric of the same name).
 707     bugs:
 708       - https://bugzilla.mozilla.org/show_bug.cgi?id=1309442
 709       - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
 710       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 711       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 712     data_reviews:
 713       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 714     notification_emails:
 715       - gfx-telemetry-alerts@mozilla.com
 716     expires: never
 717
 718   full_paint_time:
 719     type: timing_distribution
 720     time_unit: millisecond
 721     telemetry_mirror: CONTENT_FULL_PAINT_TIME
 722     description: >
 723       Time spent in the full paint pipeline for content until it's ready for
 724       composition.
 725       For non-webrender this includes `paint_time`, plus rasterization if OMTP
 726       is enabled.
 727       For webrender, this includes `paint_time`, plus scene building time.
 728       (Migrated from the geckoview metric of the same name).
 729     bugs:
 730       - https://bugzilla.mozilla.org/show_bug.cgi?id=1505858
 731       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
 732       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 733     data_reviews:
 734       - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
 735     notification_emails:
 736       - gfx-telemetry-alerts@mozilla.com
 737       - jmuizelaar@mozilla.com
 738     expires: never
 739
 740 gfx.adapter.primary:
 741   description:
 742     description: >
 743       Long form description of the Graphics adapter
 744       (Migrated from the geckoview metric of the same name).
 745     type: string
 746     # Temporary misuse of the user lifetime approved by Glean team
 747     # due to limitations in Geckoview streaming telemetry.
 748     # DO NOT DUPLICATE unless approved by Glean team.
 749     lifetime: user
 750     bugs:
 751       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 752       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 753       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 754     data_reviews:
 755       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 756     notification_emails:
 757       - gfx-telemetry-alerts@mozilla.com
 758     expires: never
 759
 760   vendor_id:
 761     description: >
 762       Graphics adapter vendor identification
 763       (Migrated from the geckoview metric of the same name).
 764     type: string
 765     # Temporary misuse of the user lifetime approved by Glean team
 766     # due to limitations in Geckoview streaming telemetry.
 767     # DO NOT DUPLICATE unless approved by Glean team.
 768     lifetime: user
 769     bugs:
 770       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 771       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 772       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 773     data_reviews:
 774       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 775     notification_emails:
 776       - gfx-telemetry-alerts@mozilla.com
 777     expires: never
 778
 779   device_id:
 780     description: >
 781       Graphics adapter device identification
 782       (Migrated from the geckoview metric of the same name).
 783     type: string
 784     # Temporary misuse of the user lifetime approved by Glean team
 785     # due to limitations in Geckoview streaming telemetry.
 786     # DO NOT DUPLICATE unless approved by Glean team.
 787     lifetime: user
 788     bugs:
 789       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 790       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 791       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 792     data_reviews:
 793       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 794     notification_emails:
 795       - gfx-telemetry-alerts@mozilla.com
 796     expires: never
 797
 798   subsystem_id:
 799     description: >
 800       Graphics adapter subsystem identification
 801       (Migrated from the geckoview metric of the same name).
 802     type: string
 803     # Temporary misuse of the user lifetime approved by Glean team
 804     # due to limitations in Geckoview streaming telemetry.
 805     # DO NOT DUPLICATE unless approved by Glean team.
 806     lifetime: user
 807     bugs:
 808       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 809       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 810       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 811     data_reviews:
 812       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 813     notification_emails:
 814       - gfx-telemetry-alerts@mozilla.com
 815     expires: never
 816
 817   ram:
 818     description: >
 819       Graphics adapter dedicated memory
 820       (Migrated from the geckoview metric of the same name).
 821     type: quantity
 822     unit: Megabytes
 823     # Temporary misuse of the user lifetime approved by Glean team
 824     # due to limitations in Geckoview streaming telemetry.
 825     # DO NOT DUPLICATE unless approved by Glean team.
 826     lifetime: user
 827     bugs:
 828       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 829       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 830       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 831     data_reviews:
 832       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 833     notification_emails:
 834       - gfx-telemetry-alerts@mozilla.com
 835     expires: never
 836
 837   driver_files:
 838     description: >
 839       List of graphics adapter driver files
 840       (Migrated from the geckoview metric of the same name).
 841     type: string
 842     # Temporary misuse of the user lifetime approved by Glean team
 843     # due to limitations in Geckoview streaming telemetry.
 844     # DO NOT DUPLICATE unless approved by Glean team.
 845     lifetime: user
 846     bugs:
 847       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 848       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 849       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 850     data_reviews:
 851       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 852     notification_emails:
 853       - gfx-telemetry-alerts@mozilla.com
 854     expires: never
 855
 856   driver_vendor:
 857     description: >
 858       Graphics adapter driver vendor identification
 859       (Migrated from the geckoview metric of the same name).
 860     type: string
 861     # Temporary misuse of the user lifetime approved by Glean team
 862     # due to limitations in Geckoview streaming telemetry.
 863     # DO NOT DUPLICATE unless approved by Glean team.
 864     lifetime: user
 865     bugs:
 866       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 867       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 868       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 869     data_reviews:
 870       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 871     notification_emails:
 872       - gfx-telemetry-alerts@mozilla.com
 873     expires: never
 874
 875   driver_version:
 876     description: >
 877       Graphics adapter driver version
 878       (Migrated from the geckoview metric of the same name).
 879     type: string
 880     # Temporary misuse of the user lifetime approved by Glean team
 881     # due to limitations in Geckoview streaming telemetry.
 882     # DO NOT DUPLICATE unless approved by Glean team.
 883     lifetime: user
 884     bugs:
 885       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 886       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 887       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 888     data_reviews:
 889       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 890     notification_emails:
 891       - gfx-telemetry-alerts@mozilla.com
 892     expires: never
 893
 894   driver_date:
 895     description: >
 896       Graphics adapter driver date
 897       (Migrated from the geckoview metric of the same name).
 898     type: string
 899     # Temporary misuse of the user lifetime approved by Glean team
 900     # due to limitations in Geckoview streaming telemetry.
 901     # DO NOT DUPLICATE unless approved by Glean team.
 902     lifetime: user
 903     bugs:
 904       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
 905       - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
 906       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 907     data_reviews:
 908       - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
 909     notification_emails:
 910       - gfx-telemetry-alerts@mozilla.com
 911     expires: never
 912
 913
 914 performance.interaction:
 915   keypress_present_latency:
 916     type: timing_distribution
 917     time_unit: millisecond
 918     telemetry_mirror: KEYPRESS_PRESENT_LATENCY
 919     description: >
 920       Time between receiving a keypress event in the event loop and compositing
 921       its result onto the screen.
 922       (Migrated from the geckoview metric of the same name).
 923     bugs:
 924       - https://bugzilla.mozilla.org/show_bug.cgi?id=1506537
 925       - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
 926       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 927     data_reviews:
 928       - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
 929     notification_emails:
 930       - perf-telemetry-alerts@mozilla.com
 931       - vchin@mozilla.com
 932     expires: never
 933
 934   mouseup_click_present_latency:
 935     type: timing_distribution
 936     time_unit: millisecond
 937     telemetry_mirror: MOUSEUP_FOLLOWED_BY_CLICK_PRESENT_LATENCY
 938     description: >
 939       Time between receiving a mouseup which follow by a mouseclick
 940       on the event loop and compositing its result onto the screen.
 941       (Migrated from the geckoview metric of the same name).
 942     bugs:
 943       - https://bugzilla.mozilla.org/show_bug.cgi?id=1698643
 944       - https://bugzilla.mozilla.org/show_bug.cgi?id=1875170
 945     data_reviews:
 946       - https://bugzilla.mozilla.org/show_bug.cgi?id=1698643#c3
 947     notification_emails:
 948       - perf-telemetry-alerts@mozilla.com
 949       - sefeng@mozilla.com
 950     expires: never