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# This file defines the metrics that are recorded by the Glean SDK. They are
6# automatically converted to platform-specific code at build time using the
7# `glean_parser` PyPI package.
8
9# Adding a new metric? Please don't!
10# (At least not without the permission of a Telemetry Module Peer)
11
12---
13$schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
14
15geckoview:
16  version:
17    description: >
18      The version of the Gecko engine, example: 74.0a1
19    type: string
20    # Temporary misuse of the user lifetime approved by Glean team
21    # due to limitations in Geckoview streaming telemetry.
22    # DO NOT DUPLICATE unless approved by Glean team.
23    lifetime: user
24    gecko_datapoint: gecko.version
25    bugs:
26      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240
27      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
28    data_reviews:
29      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240#c2
30    notification_emails:
31      - gfx-telemetry-alerts@mozilla.com
32    expires: never
33
34  build_id:
35    description: >
36      The Buildid of the Gecko engine, example: 20200205124310
37    type: string
38    # Temporary misuse of the user lifetime approved by Glean team
39    # due to limitations in Geckoview streaming telemetry.
40    # DO NOT DUPLICATE unless approved by Glean team.
41    lifetime: user
42    gecko_datapoint: gecko.build_id
43    bugs:
44      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240
45      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
46    data_reviews:
47      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240#c2
48    notification_emails:
49      - gfx-telemetry-alerts@mozilla.com
50    expires: never
51
52  content_process_lifetime:
53    type: timing_distribution
54    time_unit: millisecond
55    gecko_datapoint: GV_CONTENT_PROCESS_LIFETIME_MS
56    description: >
57      The uptime of content processes in ms
58    bugs:
59      - https://bugzilla.mozilla.org/show_bug.cgi?id=1625325
60    data_reviews:
61      - https://bugzilla.mozilla.org/show_bug.cgi?id=1625325#c2
62    notification_emails:
63      - geckoview-team@mozilla.com
64      - asferro@mozilla.com
65    expires: never
66
67  page_load_progress_time:
68    type: timing_distribution
69    time_unit: millisecond
70    gecko_datapoint: GV_PAGE_LOAD_PROGRESS_MS
71    description: >
72      Time between page load progress starts (0) and completion (100).
73    bugs:
74      - https://bugzilla.mozilla.org/show_bug.cgi?id=1499418
75      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
76    data_reviews:
77      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
78    notification_emails:
79      - geckoview-team@mozilla.com
80      - esawin@mozilla.com
81    expires: never
82
83  page_load_time:
84    type: timing_distribution
85    time_unit: millisecond
86    gecko_datapoint: GV_PAGE_LOAD_MS
87    description: >
88      The time taken to load a page. This includes all static contents, no
89      dynamic content.
90      Loading of about: pages is not counted.
91      Back back navigation (sometimes via BFCache) is included which is a
92      source of bimodality due to the <50ms load times.
93    bugs:
94      - https://bugzilla.mozilla.org/show_bug.cgi?id=1499418
95      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
96    data_reviews:
97      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
98    notification_emails:
99      - geckoview-team@mozilla.com
100      - esawin@mozilla.com
101    expires: never
102
103  page_reload_time:
104    type: timing_distribution
105    time_unit: millisecond
106    gecko_datapoint: GV_PAGE_RELOAD_MS
107    description: >
108      Time taken to reload a page.
109      This includes all static contents, no dynamic content.
110      Loading of about: pages is not counted.
111    bugs:
112      - https://bugzilla.mozilla.org/show_bug.cgi?id=1549519
113      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
114    data_reviews:
115      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
116    notification_emails:
117      - geckoview-team@mozilla.com
118      - sefeng@mozilla.com
119      - perf-telemetry-alerts@mozilla.com
120    expires: never
121
122  startup_runtime:
123    type: timing_distribution
124    time_unit: millisecond
125    gecko_datapoint: GV_STARTUP_RUNTIME_MS
126    description: >
127      The time taken to initialize GeckoRuntime.
128    bugs:
129      - https://bugzilla.mozilla.org/show_bug.cgi?id=1499418
130      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
131    data_reviews:
132      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
133    notification_emails:
134      - geckoview-team@mozilla.com
135      - esawin@mozilla.com
136    expires: never
137
138  document_site_origins:
139    type: custom_distribution
140    description: >
141      When a document is loaded, report the
142      number of [site origins](https://searchfox.org/
143      mozilla-central/rev/
144      3300072e993ae05d50d5c63d815260367eaf9179/
145      caps/nsIPrincipal.idl#264) of the entire browser
146      if it has been at least 5 minutes since last
147      time we collect this data.
148    range_min: 0
149    range_max: 100
150    bucket_count: 50
151    histogram_type: exponential
152    unit: number of site_origin
153    gecko_datapoint: FX_NUMBER_OF_UNIQUE_SITE_ORIGINS_ALL_TABS
154    bugs:
155      - https://bugzilla.mozilla.org/show_bug.cgi?id=1589700
156    data_reviews:
157      - https://bugzilla.mozilla.org/show_bug.cgi?id=1589700#c5
158    notification_emails:
159      - sefeng@mozilla.com
160      - perf-telemetry-alerts@mozilla.com
161    expires: never
162
163  per_document_site_origins:
164    type: custom_distribution
165    description: >
166      When a document is unloaded, report the highest number of
167      [site origins](https://searchfox.org/
168      mozilla-central/rev/
169      3300072e993ae05d50d5c63d815260367eaf9179/
170      caps/nsIPrincipal.idl#264) loaded simultaneously in that
171      document.
172    range_min: 0
173    range_max: 100
174    bucket_count: 50
175    histogram_type: exponential
176    unit: number of site origins per document
177    gecko_datapoint: FX_NUMBER_OF_UNIQUE_SITE_ORIGINS_PER_DOCUMENT
178    bugs:
179      - https://bugzilla.mozilla.org/show_bug.cgi?id=1603185
180    data_reviews:
181      - https://bugzilla.mozilla.org/show_bug.cgi?id=1603185#c13
182    notification_emails:
183      - barret@mozilla.com
184      - perf-telemetry-alerts@mozilla.com
185    expires: never
186
187gfx:
188  composite_time:
189    type: timing_distribution
190    time_unit: millisecond
191    gecko_datapoint: COMPOSITE_TIME
192    description: >
193      The time taken to composite a frame.
194      On non-webrender this is the time taken in
195      `CompositorBridgeParent::CompositeToTarget()`.
196      On webrender, this is the time taken from the start of
197      `WebRenderBridgeParent::CompositeToTarget()`,
198      until the render thread has rendered the frame (in
199      `RenderThread::HandleFrameOneDoc()`).
200    bugs:
201      - https://bugzilla.mozilla.org/show_bug.cgi?id=1080160
202      - https://bugzilla.mozilla.org/show_bug.cgi?id=1529352
203      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580129
204    data_reviews:
205      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580129#c7
206    notification_emails:
207      - gfx-telemetry-alerts@mozilla.com
208      - jnicol@mozilla.com
209    expires: never
210
211  scroll_present_latency:
212    type: timing_distribution
213    time_unit: millisecond
214    description: >
215      Time between receiving a scroll
216      event on the event loop and compositing
217      its result onto the screen (ms).
218    gecko_datapoint: SCROLL_PRESENT_LATENCY
219    bugs:
220      - https://bugzilla.mozilla.org/show_bug.cgi?id=1604818
221    data_reviews:
222      - https://bugzilla.mozilla.org/show_bug.cgi?id=1604818#c4
223    notification_emails:
224      - sefeng@mozilla.com
225      - perf-telemetry-alerts@mozilla.com
226    expires: never
227
228gfx.checkerboard:
229  duration:
230    type: timing_distribution
231    time_unit: millisecond
232    gecko_datapoint: CHECKERBOARD_DURATION
233    description: >
234      The duration of a checkerboard event.
235      Checkerboarding is when painting has not kept up with asynchronous
236      panning and zooming so the compositor has to display a "checkerboard
237      pattern" (or in practice, the background color) rather than the actual
238      page content.
239    bugs:
240      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
241      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
242      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
243    data_reviews:
244      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
245    notification_emails:
246      - gfx-telemetry-alerts@mozilla.com
247      - botond@mozilla.com
248    expires: never
249
250  peak_pixel_count:
251    type: custom_distribution
252    range_max: 66355200
253    bucket_count: 50
254    histogram_type: exponential
255    unit: Pixels
256    gecko_datapoint: CHECKERBOARD_PEAK
257    description: >
258      The peak number of CSS pixels that checkerboarded during a checkerboard
259      event. The minimum value of the largest histogram bucket is the size of
260      a 4k display with maximum APZ zooming.
261    bugs:
262      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
263      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
264      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
265    data_reviews:
266      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
267    notification_emails:
268      - gfx-telemetry-alerts@mozilla.com
269      - botond@mozilla.com
270    expires: never
271
272  potential_duration:
273    type: timing_distribution
274    time_unit: millisecond
275    gecko_datapoint: CHECKERBOARD_POTENTIAL_DURATION
276    description: >
277      The total amount of time that we could reasonably be checkerboarding.
278      This is the union of two possibly-intersecting sets of time periods:
279      The first set is that in which checkerboarding was actually happening,
280      since by definition it could potentially be happening.
281      The second set is that in which the APZC is actively transforming content
282      in the compositor, since it could potentially transform it so as to
283      display checkerboarding to the user. Combined with other information,
284      this allows us to meaningfully say how frequently users actually
285      enncounters checkerboarding.
286    bugs:
287      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
288      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
289      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
290    data_reviews:
291      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
292    notification_emails:
293      - gfx-telemetry-alerts@mozilla.com
294      - botond@mozilla.com
295    expires: never
296
297  severity:
298    type: custom_distribution
299    range_max: 1073741824
300    bucket_count: 50
301    histogram_type: exponential
302    unit: Opaque unit
303    gecko_datapoint: CHECKERBOARD_SEVERITY
304    description: >
305      An opaque measurement of the severity of a checkerboard event.
306      This doesn't have units, it's just useful for comparing two checkerboard
307      events to see which one is worse, for some implementation-specific
308      definition of "worse". The larger the value, the worse the
309      checkerboarding.
310    bugs:
311      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
312      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
313      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
314    data_reviews:
315      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
316    notification_emails:
317      - gfx-telemetry-alerts@mozilla.com
318      - botond@mozilla.com
319    expires: never
320
321gfx.content:
322  paint_time:
323    type: timing_distribution
324    time_unit: millisecond
325    gecko_datapoint: CONTENT_PAINT_TIME
326    description: >
327      Time spent in the main-thread paint pipeline for content.
328      For non-webrender, this includes display list building, layer building,
329      and when OMTP is disabled, rasterization.
330      For webrender, this includes display list building, and webrender display
331      list building.
332    bugs:
333      - https://bugzilla.mozilla.org/show_bug.cgi?id=1309442
334      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
335      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
336    data_reviews:
337      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
338    notification_emails:
339      - gfx-telemetry-alerts@mozilla.com
340      - mwoodrow@mozilla.com
341      - dbolter@mozilla.com
342    expires: never
343
344  full_paint_time:
345    type: timing_distribution
346    time_unit: millisecond
347    gecko_datapoint: CONTENT_FULL_PAINT_TIME
348    description: >
349      Time spent in the full paint pipeline for content until it's ready for
350      composition.
351      For non-webrender this includes `paint_time`, plus rasterization if OMTP
352      is enabled.
353      For webrender, this includes `paint_time`, plus scene building time.
354    bugs:
355      - https://bugzilla.mozilla.org/show_bug.cgi?id=1505858
356      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
357    data_reviews:
358      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
359    notification_emails:
360      - gfx-telemetry-alerts@mozilla.com
361      - jmuizelaar@mozilla.com
362      - dbolter@mozilla.com
363    expires: never
364
365gfx.content.frame_time:
366  from_paint:
367    type: custom_distribution
368    range_max: 5000
369    bucket_count: 50
370    histogram_type: exponential
371    unit: Percentage of vsync interval
372    gecko_datapoint: CONTENT_FRAME_TIME
373    description: >
374      The time, in percentage of a vsync interval, spent from beginning a paint
375      in the content process until that frame is presented in the compositor.
376    bugs:
377      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470528
378      - https://bugzilla.mozilla.org/show_bug.cgi?id=1509536
379      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
380    data_reviews:
381      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
382    notification_emails:
383      - gfx-telemetry-alerts@mozilla.com
384      - jnicol@mozilla.com
385    expires: never
386
387  from_vsync:
388    type: custom_distribution
389    range_min: 8
390    range_max: 792
391    bucket_count: 100
392    histogram_type: linear
393    unit: Percentage of vsync interval
394    gecko_datapoint: CONTENT_FRAME_TIME_VSYNC
395    description: >
396      The time, in percentage of a vsync interval, spent from the vsync that
397      started a paint in the content process until that frame is presented in
398      the compositor.
399    bugs:
400      - https://bugzilla.mozilla.org/show_bug.cgi?id=1517355
401      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
402    data_reviews:
403      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
404    notification_emails:
405      - gfx-telemetry-alerts@mozilla.com
406      - mwoodrow@mozilla.com
407    expires: never
408
409  with_svg:
410    type: custom_distribution
411    range_max: 5000
412    bucket_count: 50
413    histogram_type: exponential
414    unit: Percentage of vsync interval
415    gecko_datapoint: CONTENT_FRAME_TIME_WITH_SVG
416    description: >
417      The time, in percentage of a vsync interval, spent from beginning a paint
418      in the content process until that frame is presented in the compositor,
419      for frames that contained an SVG to be drawn by webrender.
420    bugs:
421      - https://bugzilla.mozilla.org/show_bug.cgi?id=1483549
422      - https://bugzilla.mozilla.org/show_bug.cgi?id=1509536
423      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
424    data_reviews:
425      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
426    notification_emails:
427      - gfx-telemetry-alerts@mozilla.com
428      - mwoodrow@mozilla.com
429    expires: never
430
431  without_resource_upload:
432    type: custom_distribution
433    range_max: 5000
434    bucket_count: 50
435    histogram_type: exponential
436    unit: Percentage of vsync interval
437    gecko_datapoint: CONTENT_FRAME_TIME_WITHOUT_RESOURCE_UPLOAD
438    description: >
439      The time, in percentage of a vsync interval, spent from beginning a paint
440      in the content process until that frame is presented in the compositor by
441      webrender, excluding time spent uploading resources.
442    bugs:
443      - https://bugzilla.mozilla.org/show_bug.cgi?id=1503405
444      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
445    data_reviews:
446      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
447    notification_emails:
448      - gfx-telemetry-alerts@mozilla.com
449      - mwoodrow@mozilla.com
450    expires: never
451
452  without_upload:
453    type: custom_distribution
454    range_max: 5000
455    bucket_count: 50
456    histogram_type: exponential
457    unit: Percentage of vsync interval
458    gecko_datapoint: CONTENT_FRAME_TIME_WITHOUT_UPLOAD
459    description: >
460      The time, in percentage of a vsync interval, spent from beginning a paint
461      in the content process until that frame is presented in the compositor by
462      webrender, excluding time spent uploading any content.
463    bugs:
464      - https://bugzilla.mozilla.org/show_bug.cgi?id=1503405
465      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
466    data_reviews:
467      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
468    notification_emails:
469      - gfx-telemetry-alerts@mozilla.com
470      - mwoodrow@mozilla.com
471    expires: never
472
473  reason:
474    type: labeled_counter
475    labels:
476      - on_time
477      - no_vsync
478      - missed_composite
479      - slow_composite
480      - missed_composite_mid
481      - missed_composite_long
482      - missed_composite_low
483      - no_vsync_no_id
484    gecko_datapoint: CONTENT_FRAME_TIME_REASON
485    description: >
486      The reason that `gfx.content.frame_time.from_paint` recorded a slow
487      (>200ms) result, if any.
488    bugs:
489      - https://bugzilla.mozilla.org/show_bug.cgi?id=1510853
490      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
491    data_reviews:
492      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
493    notification_emails:
494      - gfx-telemetry-alerts@mozilla.com
495      - mwoodrow@mozilla.com
496    expires: never
497
498gfx.webrender:
499  scenebuild_time:
500    type: timing_distribution
501    time_unit: millisecond
502    gecko_datapoint: WR_SCENEBUILD_TIME
503    description: >
504      The time taken to build a webrender scene.
505      This occurs each time webrender receives a new display list.
506      This additionally includes blob rasterization time.
507    bugs:
508      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
509      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
510    data_reviews:
511      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
512    notification_emails:
513      - gfx-telemetry-alerts@mozilla.com
514      - jmuizelaar@mozilla.com
515    expires: never
516  sceneswap_time:
517    type: timing_distribution
518    time_unit: millisecond
519    gecko_datapoint: WR_SCENESWAP_TIME
520    description: >
521      The time taken to do a webrender scene swap. This is book-keeping that
522      APZ must perform once webrender has built a new scene.
523    bugs:
524      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
525      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
526    data_reviews:
527      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
528    notification_emails:
529      - gfx-telemetry-alerts@mozilla.com
530      - jmuizelaar@mozilla.com
531    expires: never
532  framebuild_time:
533    type: timing_distribution
534    time_unit: millisecond
535    gecko_datapoint: WR_FRAMEBUILD_TIME
536    description: >
537      The time taken to build a webrender frame.
538      This involves calculating the visibility of primitives, requesting
539      resources, and building the render passes which will be used to render
540      the frame.
541    bugs:
542      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
543      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
544    data_reviews:
545      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
546    notification_emails:
547      - gfx-telemetry-alerts@mozilla.com
548      - jmuizelaar@mozilla.com
549    expires: never
550
551gfx.display:
552  count:
553    description: >
554      Amount of displays connected to the device
555    type: quantity
556    unit: Display count
557    # Temporary misuse of the user lifetime approved by Glean team
558    # due to limitations in Geckoview streaming telemetry.
559    # DO NOT DUPLICATE unless approved by Glean team.
560    lifetime: user
561    gecko_datapoint: gfx.display.count
562    bugs:
563      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
564      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
565    data_reviews:
566      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
567    notification_emails:
568      - gfx-telemetry-alerts@mozilla.com
569    expires: never
570  primary_width:
571    description: >
572      Width of the primary display, takes device rotation into account.
573    type: quantity
574    unit: Pixels
575    # Temporary misuse of the user lifetime approved by Glean team
576    # due to limitations in Geckoview streaming telemetry.
577    # DO NOT DUPLICATE unless approved by Glean team.
578    lifetime: user
579    gecko_datapoint: gfx.display.primary_width
580    bugs:
581      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
582      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
583    data_reviews:
584      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
585    notification_emails:
586      - gfx-telemetry-alerts@mozilla.com
587    expires: never
588  primary_height:
589    description: >
590      Height of the primary display, takes device rotation into account.
591    type: quantity
592    unit: Pixels
593    # Temporary misuse of the user lifetime approved by Glean team
594    # due to limitations in Geckoview streaming telemetry.
595    # DO NOT DUPLICATE unless approved by Glean team.
596    lifetime: user
597    gecko_datapoint: gfx.display.primary_height
598    bugs:
599      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
600      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
601    data_reviews:
602      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
603    notification_emails:
604      - gfx-telemetry-alerts@mozilla.com
605    expires: never
606gfx.adapter.primary:
607  description:
608    description: >
609      Long form description of the Graphics adapter
610    type: string
611    # Temporary misuse of the user lifetime approved by Glean team
612    # due to limitations in Geckoview streaming telemetry.
613    # DO NOT DUPLICATE unless approved by Glean team.
614    lifetime: user
615    gecko_datapoint: gfx.adapter.description
616    bugs:
617      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
618      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
619    data_reviews:
620      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
621    notification_emails:
622      - gfx-telemetry-alerts@mozilla.com
623    expires: never
624  vendor_id:
625    description: >
626      Graphics adapter vendor identification
627    type: string
628    # Temporary misuse of the user lifetime approved by Glean team
629    # due to limitations in Geckoview streaming telemetry.
630    # DO NOT DUPLICATE unless approved by Glean team.
631    lifetime: user
632    gecko_datapoint: gfx.adapter.vendor_id
633    bugs:
634      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
635      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
636    data_reviews:
637      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
638    notification_emails:
639      - gfx-telemetry-alerts@mozilla.com
640    expires: never
641  device_id:
642    description: >
643      Graphics adapter device identification
644    type: string
645    # Temporary misuse of the user lifetime approved by Glean team
646    # due to limitations in Geckoview streaming telemetry.
647    # DO NOT DUPLICATE unless approved by Glean team.
648    lifetime: user
649    gecko_datapoint: gfx.adapter.device_id
650    bugs:
651      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
652      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
653    data_reviews:
654      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
655    notification_emails:
656      - gfx-telemetry-alerts@mozilla.com
657    expires: never
658  subsystem_id:
659    description: >
660      Graphics adapter subsystem identification
661    type: string
662    # Temporary misuse of the user lifetime approved by Glean team
663    # due to limitations in Geckoview streaming telemetry.
664    # DO NOT DUPLICATE unless approved by Glean team.
665    lifetime: user
666    gecko_datapoint: gfx.adapter.subsystem_id
667    bugs:
668      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
669      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
670    data_reviews:
671      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
672    notification_emails:
673      - gfx-telemetry-alerts@mozilla.com
674    expires: never
675  ram:
676    description: >
677      Graphics adapter dedicated memory
678    type: quantity
679    unit: Megabytes
680    # Temporary misuse of the user lifetime approved by Glean team
681    # due to limitations in Geckoview streaming telemetry.
682    # DO NOT DUPLICATE unless approved by Glean team.
683    lifetime: user
684    gecko_datapoint: gfx.adapter.ram
685    bugs:
686      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
687      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
688    data_reviews:
689      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
690    notification_emails:
691      - gfx-telemetry-alerts@mozilla.com
692    expires: never
693  driver_files:
694    description: >
695      List of graphics adapter driver files
696    type: string
697    # Temporary misuse of the user lifetime approved by Glean team
698    # due to limitations in Geckoview streaming telemetry.
699    # DO NOT DUPLICATE unless approved by Glean team.
700    lifetime: user
701    gecko_datapoint: gfx.adapter.driver_files
702    bugs:
703      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
704      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
705    data_reviews:
706      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
707    notification_emails:
708      - gfx-telemetry-alerts@mozilla.com
709    expires: never
710  driver_vendor:
711    description: >
712      Graphics adapter driver vendor identification
713    type: string
714    # Temporary misuse of the user lifetime approved by Glean team
715    # due to limitations in Geckoview streaming telemetry.
716    # DO NOT DUPLICATE unless approved by Glean team.
717    lifetime: user
718    gecko_datapoint: gfx.adapter.driver_vendor
719    bugs:
720      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
721      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
722    data_reviews:
723      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
724    notification_emails:
725      - gfx-telemetry-alerts@mozilla.com
726    expires: never
727  driver_version:
728    description: >
729      Graphics adapter driver version
730    type: string
731    # Temporary misuse of the user lifetime approved by Glean team
732    # due to limitations in Geckoview streaming telemetry.
733    # DO NOT DUPLICATE unless approved by Glean team.
734    lifetime: user
735    gecko_datapoint: gfx.adapter.driver_version
736    bugs:
737      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
738      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
739    data_reviews:
740      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
741    notification_emails:
742      - gfx-telemetry-alerts@mozilla.com
743    expires: never
744  driver_date:
745    description: >
746      Graphics adapter driver date
747    type: string
748    # Temporary misuse of the user lifetime approved by Glean team
749    # due to limitations in Geckoview streaming telemetry.
750    # DO NOT DUPLICATE unless approved by Glean team.
751    lifetime: user
752    gecko_datapoint: gfx.adapter.driver_date
753    bugs:
754      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
755      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
756    data_reviews:
757      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
758    notification_emails:
759      - gfx-telemetry-alerts@mozilla.com
760    expires: never
761
762gfx.status:
763  compositor:
764    description: >
765      Name of the graphics compositor in use.
766      Possible values are "opengl, d3d11, client, webrender or basic"
767    type: string
768    # Temporary misuse of the user lifetime approved by Glean team
769    # due to limitations in Geckoview streaming telemetry.
770    # DO NOT DUPLICATE unless approved by Glean team.
771    lifetime: user
772    gecko_datapoint: gfx.compositor
773    bugs:
774      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
775      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
776    data_reviews:
777      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
778    notification_emails:
779      - gfx-telemetry-alerts@mozilla.com
780    expires: never
781  last_compositor_gecko_version:
782    description: >
783      The gecko version at the last time a compositor was initialized, and
784      therefore when gfx_status_compositor was last updated. Due to
785      gfx_status_compositor's user lifetime we see lots of unexpected values for
786      the current gecko version. We believe this is because the user has not
787      opened a tab since they were updated to a version where webrender should
788      be enabled on their device. This can be used to verify that theory.
789    type: string
790    # Temporary misuse of the user lifetime approved by Glean team
791    # in order to match gfx_status_compositor's lifetime.
792    # DO NOT DUPLICATE unless approved by Glean team.
793    lifetime: user
794    gecko_datapoint: gfx.last_compositor_gecko_version
795    bugs:
796      - https://bugzilla.mozilla.org/show_bug.cgi?id=1704842
797    data_reviews:
798      - https://bugzilla.mozilla.org/show_bug.cgi?id=1704842#c8
799    notification_emails:
800      - jnicol@mozilla.com
801      - gfx-telemetry-alerts@mozilla.com
802    expires: never
803  headless:
804    description: >
805      Boolean indicated whether graphics is running in
806      headless (no display) mode
807    type: boolean
808    # Temporary misuse of the user lifetime approved by Glean team
809    # due to limitations in Geckoview streaming telemetry.
810    # DO NOT DUPLICATE unless approved by Glean team.
811    lifetime: user
812    gecko_datapoint: gfx.headless
813    bugs:
814      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
815      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
816    data_reviews:
817      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
818    notification_emails:
819      - gfx-telemetry-alerts@mozilla.com
820    expires: never
821
822gfx.feature:
823  webrender:
824    type: string
825    description: Whether webrender is enabled or disabled, and why.
826    lifetime: application
827    gecko_datapoint: gfx.feature.webrender
828    bugs:
829      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687312
830    data_reviews:
831      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687312#c5
832    notification_emails:
833      - gfx-telemetry-alerts@mozilla.com
834      - jnicol@mozilla.com
835    expires: never
836
837avif:
838  decode_result:
839    type: labeled_counter
840    labels:
841      - success
842      - parse_error
843      - no_primary_item
844      - decode_error
845      - size_overflow
846      - out_of_memory
847      - pipe_init_error
848      - write_buffer_error
849      - alpha_y_sz_mismatch
850      - alpha_y_bpc_mismatch
851      - ispe_mismatch
852      - invalid_cicp
853      - invalid_parse_status
854      - missing_brand
855      - ftyp_not_first
856      - no_image
857      - multiple_moov
858      - no_moov
859      - lsel_no_essential
860      - a1op_no_essential
861      - a1lx_essential
862      - txform_no_essential
863      - image_item_type
864      - item_type_missing
865      - construction_method
866      - item_loc_not_found
867      - no_item_data_box
868    gecko_datapoint: AVIF_DECODE_RESULT
869    description: >
870      Decode result of AVIF image.
871    bugs:
872      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
873    data_reviews:
874      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
875    notification_emails:
876      - cchang@mozilla.com
877      - jbauman@mozilla.com
878    expires: never
879
880  decoder:
881    type: labeled_counter
882    labels:
883      - dav1d
884      - aom
885    gecko_datapoint: AVIF_DECODER
886    description: >
887      Decoder of AVIF image.
888    bugs:
889      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
890    data_reviews:
891      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
892    notification_emails:
893      - cchang@mozilla.com
894      - jbauman@mozilla.com
895    expires: never
896
897  aom_decode_error:
898    type: labeled_counter
899    labels:
900      - error
901      - mem_error
902      - abi_mismatch
903      - incapable
904      - unsup_bitstream
905      - unsup_feature
906      - corrupt_frame
907      - invalid_param
908    gecko_datapoint: AVIF_AOM_DECODE_ERROR
909    description: >
910      Image-decode Error from AOM decoder
911    bugs:
912      - https://bugzilla.mozilla.org/show_bug.cgi?id=1690406
913    data_reviews:
914      - https://bugzilla.mozilla.org/show_bug.cgi?id=1690406#c3
915    notification_emails:
916      - cchang@mozilla.com
917      - jbauman@mozilla.com
918    expires: never
919
920  # dav1d_decode_error is replaced by avif.dav1d_get_picture in Events.yaml
921  # Unfortunately, events are not currently supported for geckoview
922
923  yuv_color_space:
924    type: labeled_counter
925    labels:
926      - bt601
927      - bt709
928      - bt2020
929      - identity
930      - unknown
931    gecko_datapoint: AVIF_YUV_COLOR_SPACE
932    description: >
933      YUV color space of AVIF image.
934    bugs:
935      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
936    data_reviews:
937      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
938    notification_emails:
939      - cchang@mozilla.com
940      - jbauman@mozilla.com
941    expires: never
942
943  bit_depth:
944    type: labeled_counter
945    labels:
946      - color_8
947      - color_10
948      - color_12
949      - color_16
950      - unknown
951    gecko_datapoint: AVIF_BIT_DEPTH
952    description: >
953      Bits per pixel of AVIF image.
954    bugs:
955      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
956    data_reviews:
957      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
958    notification_emails:
959      - cchang@mozilla.com
960      - jbauman@mozilla.com
961    expires: never
962
963  alpha:
964    type: labeled_counter
965    labels:
966      - absent
967      - present
968    gecko_datapoint: AVIF_ALPHA
969    description: >
970      AVIF alpha plane.
971    bugs:
972      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
973    data_reviews:
974      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
975    notification_emails:
976      - cchang@mozilla.com
977      - jbauman@mozilla.com
978    expires: never
979
980  colr:
981    type: labeled_counter
982    labels:
983      - nclx
984      - icc
985      - absent
986      - both
987    gecko_datapoint: AVIF_COLR
988    description: >
989      AVIF colour information type.
990    bugs:
991      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
992      - https://bugzilla.mozilla.org/show_bug.cgi?id=1729071
993    data_reviews:
994      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
995      - https://bugzilla.mozilla.org/show_bug.cgi?id=1729071#c15
996    notification_emails:
997      - cchang@mozilla.com
998      - jbauman@mozilla.com
999    expires: never
1000
1001  cicp_cp:
1002    type: labeled_counter
1003    labels:
1004      - reserved
1005      - bt709
1006      - unspecified
1007      - reserved_3
1008      - bt470m
1009      - bt470bg
1010      - bt601
1011      - smpte240
1012      - generic_film
1013      - bt2020
1014      - xyz
1015      - smpte431
1016      - smpte432
1017      - reserved_13
1018      - reserved_14
1019      - reserved_15
1020      - reserved_16
1021      - reserved_17
1022      - reserved_18
1023      - reserved_19
1024      - reserved_20
1025      - reserved_21
1026      - ebu3213
1027      - reserved_rest
1028    gecko_datapoint: AVIF_CICP_CP
1029    description: >
1030      AVIF CICP colour primaries.
1031    bugs:
1032      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
1033    data_reviews:
1034      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
1035    notification_emails:
1036      - cchang@mozilla.com
1037      - jbauman@mozilla.com
1038    expires: never
1039
1040  cicp_tc:
1041    type: labeled_counter
1042    labels:
1043      - reserved
1044      - bt709
1045      - unspecified
1046      - reserved_3
1047      - bt470m
1048      - bt470bg
1049      - bt601
1050      - smpte240
1051      - linear
1052      - log_100
1053      - log_100_sqrt10
1054      - iec61966
1055      - bt_1361
1056      - srgb
1057      - bt2020_10bit
1058      - bt2020_12bit
1059      - smpte2084
1060      - smpte428
1061      - hlg
1062      - reserved_rest
1063    gecko_datapoint: AVIF_CICP_TC
1064    description: >
1065      AVIF CICP transfer characteristics.
1066    bugs:
1067      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
1068    data_reviews:
1069      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
1070    notification_emails:
1071      - cchang@mozilla.com
1072      - jbauman@mozilla.com
1073    expires: never
1074
1075  cicp_mc:
1076    type: labeled_counter
1077    labels:
1078      - identity
1079      - bt709
1080      - unspecified
1081      - reserved
1082      - fcc
1083      - bt470bg
1084      - bt601
1085      - smpte240
1086      - ycgco
1087      - bt2020_ncl
1088      - bt2020_cl
1089      - smpte2085
1090      - chromat_ncl
1091      - chromat_cl
1092      - ictcp
1093      - reserved_rest
1094    gecko_datapoint: AVIF_CICP_MC
1095    description: >
1096      AVIF CICP transfer characteristics.
1097    bugs:
1098      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
1099    data_reviews:
1100      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
1101    notification_emails:
1102      - cchang@mozilla.com
1103      - jbauman@mozilla.com
1104    expires: never
1105
1106  ispe:
1107    type: labeled_counter
1108    labels:
1109      - valid
1110      - absent
1111      - bitstream_mismatch
1112    gecko_datapoint: AVIF_ISPE
1113    description: >
1114      AVIF spatial extents (image size).
1115    bugs:
1116      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
1117    data_reviews:
1118      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
1119    notification_emails:
1120      - cchang@mozilla.com
1121      - jbauman@mozilla.com
1122    expires: never
1123
1124  pixi:
1125    type: labeled_counter
1126    labels:
1127      - valid
1128      - absent
1129      - bitstream_mismatch
1130    gecko_datapoint: AVIF_PIXI
1131    description: >
1132      AVIF pixel information (bits per channel).
1133    bugs:
1134      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
1135    data_reviews:
1136      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
1137    notification_emails:
1138      - cchang@mozilla.com
1139      - jbauman@mozilla.com
1140    expires: never
1141
1142  pasp:
1143    type: labeled_counter
1144    labels:
1145      - absent
1146      - square
1147      - nonsquare
1148      - invalid
1149    gecko_datapoint: AVIF_PASP
1150    description: >
1151      AVIF pixel aspect ratio.
1152    bugs:
1153      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
1154    data_reviews:
1155      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
1156    notification_emails:
1157      - cchang@mozilla.com
1158      - jbauman@mozilla.com
1159    expires: never
1160
1161  major_brand:
1162    type: labeled_counter
1163    labels:
1164      - avif
1165      - avis
1166      - other
1167    description: >
1168      AVIF major brand.
1169    bugs:
1170      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
1171    data_reviews:
1172      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
1173    notification_emails:
1174      - cchang@mozilla.com
1175      - jbauman@mozilla.com
1176    expires: never
1177
1178  sequence:
1179    type: labeled_counter
1180    labels:
1181      - present
1182      - absent
1183    description: >
1184      AVIF image sequence.
1185    bugs:
1186      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
1187    data_reviews:
1188      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
1189    notification_emails:
1190      - cchang@mozilla.com
1191      - jbauman@mozilla.com
1192    expires: never
1193
1194  a1lx:
1195    type: labeled_counter
1196    labels:
1197      - present
1198      - absent
1199    gecko_datapoint: AVIF_A1LX
1200    description: >
1201      AV1LayeredImageIndexingProperty (a1lx).
1202    bugs:
1203      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
1204    data_reviews:
1205      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
1206    notification_emails:
1207      - cchang@mozilla.com
1208      - jbauman@mozilla.com
1209    expires: never
1210
1211  a1op:
1212    type: labeled_counter
1213    labels:
1214      - present
1215      - absent
1216    gecko_datapoint: AVIF_A1OP
1217    description: >
1218      AVIF OperatingPointSelectorProperty (a1op).
1219    bugs:
1220      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
1221    data_reviews:
1222      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
1223    notification_emails:
1224      - cchang@mozilla.com
1225      - jbauman@mozilla.com
1226    expires: never
1227
1228  clap:
1229    type: labeled_counter
1230    labels:
1231      - present
1232      - absent
1233    gecko_datapoint: AVIF_CLAP
1234    description: >
1235      AVIF CleanApertureBox (clap).
1236    bugs:
1237      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
1238    data_reviews:
1239      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
1240    notification_emails:
1241      - cchang@mozilla.com
1242      - jbauman@mozilla.com
1243    expires: never
1244
1245  grid:
1246    type: labeled_counter
1247    labels:
1248      - present
1249      - absent
1250    gecko_datapoint: AVIF_GRID
1251    description: >
1252      AVIF AVIF grid-based image.
1253    bugs:
1254      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
1255    data_reviews:
1256      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
1257    notification_emails:
1258      - cchang@mozilla.com
1259      - jbauman@mozilla.com
1260    expires: never
1261
1262  ipro:
1263    type: labeled_counter
1264    labels:
1265      - present
1266      - absent
1267    gecko_datapoint: AVIF_IPRO
1268    description: >
1269      AVIF ItemProtectionBox (ipro).
1270    bugs:
1271      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
1272    data_reviews:
1273      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
1274    notification_emails:
1275      - cchang@mozilla.com
1276      - jbauman@mozilla.com
1277    expires: never
1278
1279  lsel:
1280    type: labeled_counter
1281    labels:
1282      - present
1283      - absent
1284    gecko_datapoint: AVIF_LSEL
1285    description: >
1286      AVIF LayerSelectorProperty (lsel).
1287    bugs:
1288      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
1289    data_reviews:
1290      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
1291    notification_emails:
1292      - cchang@mozilla.com
1293      - jbauman@mozilla.com
1294    expires: never
1295
1296network:
1297  cache_hit_time:
1298    type: timing_distribution
1299    time_unit: millisecond
1300    gecko_datapoint: NETWORK_CACHE_V2_HIT_TIME_MS
1301    description: >
1302      Time to open existing cache entry file.
1303    bugs:
1304      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
1305      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1306    data_reviews:
1307      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1308    notification_emails:
1309      - hbambas@mozilla.com
1310      - mnovotny@mozilla.com
1311    expires: never
1312
1313  tls_handshake:
1314    type: timing_distribution
1315    time_unit: millisecond
1316    gecko_datapoint: HTTP_PAGE_TLS_HANDSHAKE
1317    description: >
1318      In the HTTP page channel, time from after the TCP SYN packet is
1319      received to the secure connection is established and ready for HTTP.
1320    bugs:
1321      - https://bugzilla.mozilla.org/show_bug.cgi?id=772589
1322      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1323    data_reviews:
1324      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1325    notification_emails:
1326      - necko@mozilla.com
1327      - ddamjanovic@mozilla.com
1328    expires: never
1329
1330  tcp_connection:
1331    type: timing_distribution
1332    time_unit: millisecond
1333    gecko_datapoint: HTTP_PAGE_TCP_CONNECTION_2
1334    description: >
1335      In the HTTP page channel, time from the TCP SYN packet is received to
1336      the connection is established and ready for HTTP.
1337    bugs:
1338      - https://bugzilla.mozilla.org/show_bug.cgi?id=772589
1339      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1340    data_reviews:
1341      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1342    notification_emails:
1343      - necko@mozilla.com
1344      - ddamjanovic@mozilla.com
1345    expires: never
1346
1347  dns_start:
1348    type: timing_distribution
1349    time_unit: millisecond
1350    gecko_datapoint: HTTP_PAGE_DNS_ISSUE_TIME
1351    description: >
1352      In the HTTP page channel, time from connection open to the DNS request
1353      being issued.
1354    bugs:
1355      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1356    data_reviews:
1357      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1358    notification_emails:
1359      - necko@mozilla.com
1360      - vogosu@mozilla.com
1361    expires: never
1362
1363  dns_end:
1364    type: timing_distribution
1365    time_unit: millisecond
1366    gecko_datapoint: HTTP_PAGE_DNS_LOOKUP_TIME
1367    description: >
1368      In the HTTP page channel, time from the DNS request being issued to
1369      the response.
1370    bugs:
1371      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1372    data_reviews:
1373      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1374    notification_emails:
1375      - necko@mozilla.com
1376      - vogosu@mozilla.com
1377    expires: never
1378
1379  font_download_end:
1380    type: timing_distribution
1381    time_unit: millisecond
1382    gecko_datapoint: WEBFONT_DOWNLOAD_TIME_AFTER_START
1383    description: >
1384      Time after navigationStart that all webfont downloads are completed.
1385    bugs:
1386      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1387    data_reviews:
1388      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1389    notification_emails:
1390      - perf-telemetry-alerts@mozilla.com
1391      - necko@mozilla.com
1392      - bdekoz@mozilla.com
1393    expires: never
1394
1395  first_from_cache:
1396    type: timing_distribution
1397    time_unit: millisecond
1398    gecko_datapoint: HTTP_PAGE_OPEN_TO_FIRST_FROM_CACHE_V2
1399    description: >
1400      In the HTTP page channel, time from connection open to cache read start.
1401    bugs:
1402      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1403    data_reviews:
1404      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1405    notification_emails:
1406      - necko@mozilla.com
1407      - mnovotny@mozilla.com
1408    expires: never
1409
1410performance.pageload:
1411  load_time:
1412    type: timing_distribution
1413    time_unit: millisecond
1414    gecko_datapoint: PERF_PAGE_LOAD_TIME_MS
1415    description: >
1416      Time in milliseconds from navigationStart to loadEventStart
1417      for the foreground http or https root content document.
1418    bugs:
1419      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
1420    data_reviews:
1421      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
1422    notification_emails:
1423      - dpalmeiro@mozilla.com
1424      - perf-telemetry-alerts@mozilla.com
1425    expires: never
1426
1427  load_time_responsestart:
1428    type: timing_distribution
1429    time_unit: millisecond
1430    gecko_datapoint: PERF_PAGE_LOAD_TIME_FROM_RESPONSESTART_MS
1431    description: >
1432      Time in milliseconds from responseStart to loadEventStart
1433      for the foreground http or https root content document.
1434    bugs:
1435      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
1436    data_reviews:
1437      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
1438    notification_emails:
1439      - dpalmeiro@mozilla.com
1440      - perf-telemetry-alerts@mozilla.com
1441    expires: never
1442
1443  dcl:
1444    type: timing_distribution
1445    time_unit: millisecond
1446    gecko_datapoint: PERF_DOM_CONTENT_LOADED_MS
1447    description: >
1448      Time in milliseconds from navigationStart to domContentLoaded
1449      for the foreground http or https root content document.
1450    bugs:
1451      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
1452    data_reviews:
1453      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
1454    notification_emails:
1455      - dpalmeiro@mozilla.com
1456      - perf-telemetry-alerts@mozilla.com
1457    expires: never
1458
1459  dcl_responsestart:
1460    type: timing_distribution
1461    time_unit: millisecond
1462    gecko_datapoint: PERF_DOM_CONTENT_LOADED_FROM_RESPONSESTART_MS
1463    description: >
1464      Time in milliseconds from responseStart to domContentLoaded
1465      for the foreground http or https root content document.
1466    bugs:
1467      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
1468    data_reviews:
1469      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
1470    notification_emails:
1471      - dpalmeiro@mozilla.com
1472      - perf-telemetry-alerts@mozilla.com
1473    expires: never
1474
1475  fcp:
1476    type: timing_distribution
1477    time_unit: millisecond
1478    gecko_datapoint: PERF_FIRST_CONTENTFUL_PAINT_MS
1479    description: >
1480      The time between navigationStart and the first contentful paint
1481      of a foreground http or https root content document, in
1482      milliseconds. The contentful paint timestamp is taken during
1483      display list building and does not include rasterization or
1484      compositing of that paint.
1485    bugs:
1486      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
1487    data_reviews:
1488      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
1489    notification_emails:
1490      - dpalmeiro@mozilla.com
1491      - perf-telemetry-alerts@mozilla.com
1492    expires: never
1493
1494  fcp_responsestart:
1495    type: timing_distribution
1496    time_unit: millisecond
1497    gecko_datapoint: PERF_FIRST_CONTENTFUL_PAINT_FROM_RESPONSESTART_MS
1498    description: >
1499      The time between responseStart and the first contentful paint
1500      of a foreground http or https root content document, in
1501      milliseconds. The contentful paint timestamp is taken during
1502      display list building and does not include rasterization or
1503      compositing of that paint.
1504    bugs:
1505      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
1506    data_reviews:
1507      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
1508    notification_emails:
1509      - dpalmeiro@mozilla.com
1510      - perf-telemetry-alerts@mozilla.com
1511    expires: never
1512
1513  req_anim_frame_callback:
1514    type: timing_distribution
1515    time_unit: millisecond
1516    gecko_datapoint: PERF_REQUEST_ANIMATION_CALLBACK_PAGELOAD_MS
1517    description: >
1518      Time spent in milliseconds calling all request animation frame callbacks
1519      for a document before it has reached readystate complete.
1520    bugs:
1521      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
1522    data_reviews:
1523      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
1524    notification_emails:
1525      - dpalmeiro@mozilla.com
1526      - perf-telemetry-alerts@mozilla.com
1527    expires: never
1528
1529performance.responsiveness:
1530  req_anim_frame_callback:
1531    type: timing_distribution
1532    time_unit: millisecond
1533    gecko_datapoint: PERF_REQUEST_ANIMATION_CALLBACK_NON_PAGELOAD_MS
1534    description: >
1535      Time spent in milliseconds calling all request animation frame callbacks
1536      for a document after it has reached readystate complete.
1537    bugs:
1538      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
1539    data_reviews:
1540      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
1541    notification_emails:
1542      - dpalmeiro@mozilla.com
1543      - perf-telemetry-alerts@mozilla.com
1544    expires: never
1545
1546
1547performance.time:
1548  response_start:
1549    type: timing_distribution
1550    time_unit: millisecond
1551    gecko_datapoint: TIME_TO_RESPONSE_START_MS
1552    description: >
1553      Time from navigationStart to responseStart as per the W3C
1554      Performance Timing API.
1555    bugs:
1556      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
1557      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
1558      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1559    data_reviews:
1560      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1561    notification_emails:
1562      - vchin@mozilla.com
1563      - perf-telemetry-alerts@mozilla.com
1564    expires: never
1565
1566  dom_interactive:
1567    type: timing_distribution
1568    time_unit: millisecond
1569    gecko_datapoint: TIME_TO_DOM_INTERACTIVE_MS
1570    description: >
1571      Time from navigationStart to domInteractive as per the W3C
1572      Performance Timing API.
1573    bugs:
1574      - https://bugzilla.mozilla.org/show_bug.cgi?1344893
1575      - https://bugzilla.mozilla.org/show_bug.cgi?1489524
1576      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1577    data_reviews:
1578      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1579    notification_emails:
1580      - hbambas@mozilla.com
1581      - vgosu@mozilla.com
1582      - perf-telemetry-alerts@mozilla.com
1583    expires: never
1584
1585  dom_content_loaded_start:
1586    type: timing_distribution
1587    time_unit: millisecond
1588    gecko_datapoint: TIME_TO_DOM_CONTENT_LOADED_START_MS
1589    description: >
1590      Time from navigationStart to domContentLoadedEventStart as per
1591      the W3C Performance Timing API.
1592    bugs:
1593      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
1594      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1595    data_reviews:
1596      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1597    notification_emails:
1598      - perf-telemetry-alerts@mozilla.com
1599      - bdekoz@mozilla.com
1600    expires: never
1601
1602  dom_content_loaded_end:
1603    type: timing_distribution
1604    time_unit: millisecond
1605    gecko_datapoint: TIME_TO_DOM_CONTENT_LOADED_END_MS
1606    description: >
1607      Time from navigationStart to domContentLoadedEventEnd as per
1608      the W3C Performance Timing API.
1609    bugs:
1610      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
1611      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
1612      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1613    data_reviews:
1614      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1615    notification_emails:
1616      - vchin@mozilla.com
1617      - perf-telemetry-alerts@mozilla.com
1618    expires: never
1619
1620  dom_complete:
1621    type: timing_distribution
1622    time_unit: millisecond
1623    gecko_datapoint: TIME_TO_DOM_COMPLETE_MS
1624    description: >
1625      Time from navigationStart to domComplete as per the W3C Performance
1626      Timing API.
1627    bugs:
1628      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
1629      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
1630      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1631    data_reviews:
1632      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1633    notification_emails:
1634      - hbambas@mozilla.com
1635      - vgosu@mozilla.com
1636      - perf-telemetry-alerts@mozilla.com
1637    expires: never
1638
1639  load_event_start:
1640    type: timing_distribution
1641    time_unit: millisecond
1642    gecko_datapoint: TIME_TO_LOAD_EVENT_START_MS
1643    description: >
1644      Time from navigationStart to loadEventStart as per the W3C Performance
1645      Timing API.
1646    bugs:
1647      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
1648      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1649    data_reviews:
1650      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1651    notification_emails:
1652      - perf-telemetry-alerts@mozilla.com
1653      - bdekoz@mozilla.com
1654    expires: never
1655
1656  load_event_end:
1657    type: timing_distribution
1658    time_unit: millisecond
1659    gecko_datapoint: TIME_TO_LOAD_EVENT_END_MS
1660    description: >
1661      Time from navigationStart to loadEventEnd as per the W3C Performance
1662      Timing API.
1663    bugs:
1664      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
1665      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
1666      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1667    data_reviews:
1668      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1669    notification_emails:
1670      - vchin@mozilla.com
1671      - perf-telemetry-alerts@mozilla.com
1672    expires: never
1673
1674performance.page:
1675  non_blank_paint:
1676    type: timing_distribution
1677    time_unit: millisecond
1678    gecko_datapoint: TIME_TO_NON_BLANK_PAINT_MS
1679    description: >
1680      The time between navigationStart and the first non-blank paint of a
1681      foreground root content document, in milliseconds. This only records
1682      documents that were in an active docshell throughout the whole time
1683      between navigation start and non-blank paint. The non-blank paint
1684      timestamp is taken during display list building and does not include
1685      rasterization or compositing of that paint.
1686    bugs:
1687      - https://bugzilla.mozilla.org/show_bug.cgi?id=1307242
1688      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
1689      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1690    data_reviews:
1691      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1692    notification_emails:
1693      - vchin@mozilla.com
1694      - perf-telemetry-alerts@mozilla.com
1695    expires: never
1696
1697  total_content_page_load:
1698    type: timing_distribution
1699    time_unit: millisecond
1700    gecko_datapoint: TOTAL_CONTENT_PAGE_LOAD_TIME
1701    description: >
1702      Time to load all of a page's resources and render.
1703    bugs:
1704      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1705    data_reviews:
1706      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1707    notification_emails:
1708      - perf-telemetry-alerts@mozilla.com
1709      - bdekoz@mozilla.com
1710    expires: never
1711
1712performance.interaction:
1713  keypress_present_latency:
1714    type: timing_distribution
1715    time_unit: millisecond
1716    gecko_datapoint: KEYPRESS_PRESENT_LATENCY
1717    description: >
1718      Time between receiving a keypress event in the event loop and compositing
1719      its result onto the screen.
1720    bugs:
1721      - https://bugzilla.mozilla.org/show_bug.cgi?id=1506537
1722      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1723    data_reviews:
1724      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1725    notification_emails:
1726      - perf-telemetry-alerts@mozilla.com
1727      - vchin@mozilla.com
1728    expires: never
1729
1730  mouseup_click_present_latency:
1731    type: timing_distribution
1732    time_unit: millisecond
1733    gecko_datapoint: MOUSEUP_FOLLOWED_BY_CLICK_PRESENT_LATENCY
1734    description: >
1735      Time between receiving a mouseup which follow by a mouseclick
1736      on the event loop and compositing its result onto the screen.
1737    bugs:
1738      - https://bugzilla.mozilla.org/show_bug.cgi?id=1698643
1739    data_reviews:
1740      - https://bugzilla.mozilla.org/show_bug.cgi?id=1698643#c3
1741    notification_emails:
1742      - perf-telemetry-alerts@mozilla.com
1743      - sefeng@mozilla.com
1744    expires: never
1745
1746  tab_switch_composite:
1747    type: timing_distribution
1748    time_unit: millisecond
1749    gecko_datapoint: FX_TAB_SWITCH_COMPOSITE_E10S_MS
1750    description: >
1751      Time between tab selection and first composite of the tab content onto the
1752      screen.
1753    bugs:
1754      - https://bugzilla.mozilla.org/show_bug.cgi?id=1481704
1755      - https://bugzilla.mozilla.org/show_bug.cgi?id=1529352
1756      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
1757    data_reviews:
1758      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
1759    notification_emails:
1760      - mconley@mozilla.com
1761      - perf-telemetry-alerts@mozilla.com
1762    expires: never
1763
1764javascript.pageload:
1765  execution_time:
1766    type: timing_distribution
1767    time_unit: millisecond
1768    gecko_datapoint: JS_PAGELOAD_EXECUTION_MS
1769    description: >
1770      Time spent during page load executing Javascript in ms.
1771    bugs:
1772      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
1773    data_reviews:
1774      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
1775    notification_emails:
1776      - dpalmeiro@mozilla.com
1777      - perf-telemetry-alerts@mozilla.com
1778    expires: never
1779  delazification_time:
1780    type: timing_distribution
1781    time_unit: millisecond
1782    gecko_datapoint: JS_PAGELOAD_DELAZIFICATION_MS
1783    description: >
1784      Time spent during page load delazifying Javascript in ms.
1785    bugs:
1786      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
1787    data_reviews:
1788      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
1789    notification_emails:
1790      - dpalmeiro@mozilla.com
1791      - perf-telemetry-alerts@mozilla.com
1792    expires: never
1793  xdr_encode_time:
1794    type: timing_distribution
1795    time_unit: millisecond
1796    gecko_datapoint: JS_PAGELOAD_XDR_ENCODING_MS
1797    description: >
1798      Time spent during page load XDR encoding Javascript in ms.
1799    bugs:
1800      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
1801    data_reviews:
1802      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
1803    notification_emails:
1804      - dpalmeiro@mozilla.com
1805      - perf-telemetry-alerts@mozilla.com
1806    expires: never
1807  baseline_compile_time:
1808    type: timing_distribution
1809    time_unit: millisecond
1810    gecko_datapoint: JS_PAGELOAD_BASELINE_COMPILE_MS
1811    description: >
1812      Time spent during page load baseline compiling Javascript in ms.
1813    bugs:
1814      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
1815    data_reviews:
1816      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
1817    notification_emails:
1818      - dpalmeiro@mozilla.com
1819      - perf-telemetry-alerts@mozilla.com
1820    expires: never
1821  gc_time:
1822    type: timing_distribution
1823    time_unit: millisecond
1824    gecko_datapoint: JS_PAGELOAD_GC_MS
1825    description: >
1826      Time spent during page load in the GC in ms.
1827    bugs:
1828      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
1829    data_reviews:
1830      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
1831    notification_emails:
1832      - dpalmeiro@mozilla.com
1833      - perf-telemetry-alerts@mozilla.com
1834    expires: never
1835  parse_time:
1836    type: timing_distribution
1837    time_unit: millisecond
1838    gecko_datapoint: JS_PAGELOAD_PARSE_MS
1839    description: >
1840      Time spent during page load syntax parsing JS scripts on
1841      the main thread in ms.
1842    bugs:
1843      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
1844    data_reviews:
1845      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
1846    notification_emails:
1847      - dpalmeiro@mozilla.com
1848      - perf-telemetry-alerts@mozilla.com
1849    expires: never
1850  protect_time:
1851    type: timing_distribution
1852    time_unit: millisecond
1853    gecko_datapoint: JS_PAGELOAD_PROTECT_MS
1854    description: >
1855      Time spent during page load protecting JIT executable memory.
1856    bugs:
1857      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
1858    data_reviews:
1859      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
1860    notification_emails:
1861      - dpalmeiro@mozilla.com
1862      - perf-telemetry-alerts@mozilla.com
1863    expires: never
1864
1865javascript.gc:
1866  total_time:
1867    type: timing_distribution
1868    time_unit: millisecond
1869    gecko_datapoint: GC_MS
1870    description: >
1871      The total time taken by a major collection.
1872    bugs:
1873      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
1874    data_reviews:
1875      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c8
1876    notification_emails:
1877      - dev-telemetry-gc-alerts@mozilla.org
1878      - jcoppeard@mozilla.com
1879    expires: never
1880
1881  minor_time:
1882    type: timing_distribution
1883    time_unit: microsecond
1884    gecko_datapoint: GC_MINOR_US
1885    description: >
1886      The time taked by a minor (nursery) collection.
1887    bugs:
1888      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
1889    data_reviews:
1890      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
1891    notification_emails:
1892      - dev-telemetry-gc-alerts@mozilla.org
1893      - jcoppeard@mozilla.com
1894    expires: never
1895
1896  prepare_time:
1897    type: timing_distribution
1898    time_unit: millisecond
1899    gecko_datapoint: GC_PREPARE_MS
1900    description: >
1901      The time spent in the preparation phase.
1902    bugs:
1903      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
1904    data_reviews:
1905      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
1906    notification_emails:
1907      - dev-telemetry-gc-alerts@mozilla.org
1908      - jcoppeard@mozilla.com
1909    expires: never
1910
1911  mark_roots_time:
1912    type: timing_distribution
1913    time_unit: microsecond
1914    gecko_datapoint: GC_MARK_ROOTS_US
1915    description: >
1916      The time spent marking GC roots.
1917    bugs:
1918      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
1919    data_reviews:
1920      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
1921    notification_emails:
1922      - dev-telemetry-gc-alerts@mozilla.org
1923      - jcoppeard@mozilla.com
1924    expires: never
1925
1926  mark_time:
1927    type: timing_distribution
1928    time_unit: millisecond
1929    gecko_datapoint: GC_MARK_MS
1930    description: >
1931      The time spent in the mark phase.
1932    bugs:
1933      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
1934    data_reviews:
1935      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
1936    notification_emails:
1937      - dev-telemetry-gc-alerts@mozilla.org
1938      - jcoppeard@mozilla.com
1939    expires: never
1940
1941  sweep_time:
1942    type: timing_distribution
1943    time_unit: millisecond
1944    gecko_datapoint: GC_SWEEP_MS
1945    description: >
1946      The time spent in the sweep phase.
1947    bugs:
1948      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
1949    data_reviews:
1950      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
1951    notification_emails:
1952      - dev-telemetry-gc-alerts@mozilla.org
1953      - jcoppeard@mozilla.com
1954    expires: never
1955
1956  compact_time:
1957    type: timing_distribution
1958    time_unit: millisecond
1959    gecko_datapoint: GC_COMPACT_MS
1960    description: >
1961      The time spent in the compact phase.
1962    bugs:
1963      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
1964    data_reviews:
1965      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
1966    notification_emails:
1967      - dev-telemetry-gc-alerts@mozilla.org
1968      - jcoppeard@mozilla.com
1969    expires: never
1970
1971  slice_time:
1972    type: timing_distribution
1973    time_unit: millisecond
1974    gecko_datapoint: GC_SLICE_MS
1975    description: >
1976      The time spent running a GC slice.
1977    bugs:
1978      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
1979    data_reviews:
1980      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
1981    notification_emails:
1982      - dev-telemetry-gc-alerts@mozilla.org
1983      - jcoppeard@mozilla.com
1984    expires: never
1985
1986performance.clone.deserialize:
1987  size:
1988    description: >
1989      Size of deserialized data, in bytes
1990    type: memory_distribution
1991    memory_unit: byte
1992    gecko_datapoint: DESERIALIZE_BYTES
1993    bugs:
1994      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631
1995    data_reviews:
1996      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631#c4
1997    notification_emails:
1998      - sfink@mozilla.com
1999    expires: never
2000
2001  items:
2002    description: >
2003      Size of deserialized data, in items
2004    type: custom_distribution
2005    unit: Serialized items
2006    histogram_type: exponential
2007    range_max: 2147483646
2008    bucket_count: 50
2009    gecko_datapoint: DESERIALIZE_ITEMS
2010    bugs:
2011      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631
2012    data_reviews:
2013      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631#c4
2014    notification_emails:
2015      - sfink@mozilla.com
2016    expires: never
2017
2018  time:
2019    description: >
2020      Time spent deserializing structured data
2021    type: timing_distribution
2022    time_unit: microsecond
2023    gecko_datapoint: DESERIALIZE_US
2024    bugs:
2025      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631
2026    data_reviews:
2027      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631#c4
2028    notification_emails:
2029      - sfink@mozilla.com
2030    expires: never
2031
2032media.audio:
2033  init_failure:
2034    type: labeled_counter
2035    labels:
2036      - first
2037      - other
2038    gecko_datapoint: MEDIA_AUDIO_INIT_FAILURE
2039    description: >
2040      Failure occurs when initializing the audio stream.
2041    bugs:
2042      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714
2043    data_reviews:
2044      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714#c10
2045    notification_emails:
2046      - padenot@mozilla.com
2047      - kinetik@flim.org
2048      - cchang@mozilla.com
2049    expires: never
2050
2051  backend:
2052    type: labeled_counter
2053    labels:
2054      - unknown
2055      - audiounit
2056      - audiounit_rust
2057      - aaudio
2058      - opensl
2059      - wasapi
2060      - winmm
2061      - alsa
2062      - jack
2063      - oss
2064      - pulse
2065      - pulse_rust
2066      - sndio
2067      - sun
2068    gecko_datapoint: MEDIA_AUDIO_BACKEND
2069    description: >
2070      The operating system audio backend
2071    bugs:
2072      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714
2073    data_reviews:
2074      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714#c10
2075    notification_emails:
2076      - padenot@mozilla.com
2077      - kinetik@flim.org
2078      - cchang@mozilla.com
2079    expires: never
2080