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/.
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
9 $schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
11 - 'Core :: DOM: Core & HTML'
14 largest_contentful_paint:
15 type: timing_distribution
16 time_unit: millisecond
18 Time from navigation start to largest contentful paint.
20 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939
22 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939#c5
24 - perf-telemetry-alerts@mozilla.com
26 telemetry_mirror: PERF_LARGEST_CONTENTFUL_PAINT_MS
27 largest_contentful_paint_from_response_start:
28 type: timing_distribution
29 time_unit: millisecond
31 Time from response start to largest contentful paint.
33 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939
35 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939#c5
37 - perf-telemetry-alerts@mozilla.com
39 telemetry_mirror: PERF_LARGEST_CONTENTFUL_PAINT_FROM_RESPONSE_START_MS
43 Recorded when a top level content document has been loaded.
45 - https://bugzilla.mozilla.org/show_bug.cgi?id=1759744
46 - https://bugzilla.mozilla.org/show_bug.cgi?id=1799727
47 - https://bugzilla.mozilla.org/show_bug.cgi?id=1834774
48 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939
49 - https://bugzilla.mozilla.org/show_bug.cgi?id=1892231
50 - https://bugzilla.mozilla.org/show_bug.cgi?id=1923894
52 - https://bugzilla.mozilla.org/show_bug.cgi?id=1759744#c5
53 - https://bugzilla.mozilla.org/show_bug.cgi?id=1799727#c4
54 - https://bugzilla.mozilla.org/show_bug.cgi?id=1834774#c3
55 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939#c5
56 - https://bugzilla.mozilla.org/show_bug.cgi?id=1892231#c3
58 - perf-telemetry-alerts@mozilla.com
59 - dpalmeiro@mozilla.com
64 "Time between loadEventStart and navigationStart, in ms."
69 "Time taken to perform dns lookup of the top level document, in ms."
72 time_to_request_start:
74 "Time between requestStart and navigationStart, in ms."
79 "Time between responseStart and navigationStart, in ms."
84 "Time between firstContentfulPaint and navigationStart, in ms."
89 "Time between largestContentfulPaint and navigationStart, at the point of onLoad firing, in ms. This may differ from the final LCP value as reported through the LCP histogram."
94 "Time spent executing JS during page load, in ms."
100 "Time spent in redirections for the top level document."
104 "Number of redirections for the top level document."
109 "One of normal,reload,stop,link,history,error or other."
113 "If true, a normal navigation was performed on the same origin."
117 "If true, a webdriver is running on the client."
121 "Version of HTTP protocol used."
130 "Bitfield of features in use within this document:
131 1 - fetchpriority applied to images"
137 performance.pageload:
139 type: timing_distribution
140 time_unit: millisecond
141 telemetry_mirror: PERF_PAGE_LOAD_TIME_MS
143 Time in milliseconds from navigationStart to loadEventStart
144 for the foreground http or https root content document.
145 (Migrated from the geckoview metric of the same name).
147 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
148 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
150 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
152 - dpalmeiro@mozilla.com
153 - perf-telemetry-alerts@mozilla.com
156 load_time_responsestart:
157 type: timing_distribution
158 time_unit: millisecond
159 telemetry_mirror: PERF_PAGE_LOAD_TIME_FROM_RESPONSESTART_MS
161 Time in milliseconds from responseStart to loadEventStart
162 for the foreground http or https root content document.
163 (Migrated from the geckoview metric of the same name).
165 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
166 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
168 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
170 - dpalmeiro@mozilla.com
171 - perf-telemetry-alerts@mozilla.com
175 type: timing_distribution
176 time_unit: millisecond
177 telemetry_mirror: PERF_FIRST_CONTENTFUL_PAINT_MS
179 The time between navigationStart and the first contentful paint
180 of a foreground http or https root content document, in
181 milliseconds. The contentful paint timestamp is taken during
182 display list building and does not include rasterization or
183 compositing of that paint.
184 (Migrated from the geckoview metric of the same name).
186 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
187 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
189 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
191 - dpalmeiro@mozilla.com
192 - perf-telemetry-alerts@mozilla.com
196 type: timing_distribution
197 time_unit: millisecond
198 telemetry_mirror: PERF_FIRST_CONTENTFUL_PAINT_FROM_RESPONSESTART_MS
200 The time between responseStart and the first contentful paint
201 of a foreground http or https root content document, in
202 milliseconds. The contentful paint timestamp is taken during
203 display list building and does not include rasterization or
204 compositing of that paint.
205 (Migrated from the geckoview metric of the same name).
207 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
208 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
210 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
212 - dpalmeiro@mozilla.com
213 - perf-telemetry-alerts@mozilla.com
216 http3_fcp_http3: &http3_fcp_http3
217 type: timing_distribution
218 time_unit: millisecond
220 The time between navigationStart and the first contentful paint of
221 a foreground http or https root content document, in milliseconds.
222 The contentful paint timestamp is taken during display list building
223 and does not include rasterization or compositing of that paint.
224 This is collected only on page load where the main document uses or suppports HTTP3.
226 - https://bugzilla.mozilla.org/show_bug.cgi?id=1675503
227 - https://bugzilla.mozilla.org/show_bug.cgi?id=1898245
229 - https://bugzilla.mozilla.org/show_bug.cgi?id=1898245
232 - perf-telemetry-alerts@mozilla.com
235 http3_fcp_supports_http3:
238 The time between navigationStart and the first contentful paint of
239 a foreground http or https root content document, in milliseconds.
240 The contentful paint timestamp is taken during display list building
241 and does not include rasterization or compositing of that paint.
242 This is collected only on page load where the main document supports but is not using HTTP3.
244 h3p_fcp_with_priority: &h3p_fcp_with_priority
245 type: timing_distribution
246 time_unit: millisecond
248 The time between navigationStart and the first contentful paint of
249 a foreground http or https root content document, in milliseconds.
250 The contentful paint timestamp is taken during display list
251 building and does not include rasterization or compositing of that paint.
252 This is collected only on page load where the main document uses HTTP3.
253 A "priority" header has been received.
255 - https://bugzilla.mozilla.org/show_bug.cgi?id=1743965
256 - https://bugzilla.mozilla.org/show_bug.cgi?id=1796398
257 - https://bugzilla.mozilla.org/show_bug.cgi?id=1898245
259 - https://bugzilla.mozilla.org/show_bug.cgi?id=1898245
262 - perf-telemetry-alerts@mozilla.com
265 http3_fcp_without_priority:
266 <<: *h3p_fcp_with_priority
268 The time between navigationStart and the first contentful paint of
269 a foreground http or https root content document, in milliseconds.
270 The contentful paint timestamp is taken during display list
271 building and does not include rasterization or compositing of that paint.
272 This is collected only on page load where the main document uses HTTP3.
273 A "priority" header has not been received.
277 type: timing_distribution
278 time_unit: millisecond
279 telemetry_mirror: TIME_TO_DOM_INTERACTIVE_MS
281 Time from navigationStart to domInteractive as per the W3C
282 Performance Timing API.
283 (Migrated from the geckoview metric of the same name.)
285 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
286 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
287 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
288 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
290 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
293 - perf-telemetry-alerts@mozilla.com
296 dom_content_loaded_start:
297 type: timing_distribution
298 time_unit: millisecond
299 telemetry_mirror: TIME_TO_DOM_CONTENT_LOADED_START_MS
301 Time from navigationStart to domContentLoadedEventStart as per
302 the W3C Performance Timing API.
303 (Migrated from the geckoview metric of the same name.)
305 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
306 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
307 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
309 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
311 - perf-telemetry-alerts@mozilla.com
315 dom_content_loaded_end:
316 type: timing_distribution
317 time_unit: millisecond
318 telemetry_mirror: TIME_TO_DOM_CONTENT_LOADED_END_MS
320 Time from navigationStart to domContentLoadedEventEnd as per
321 the W3C Performance Timing API.
322 (Migrated from the geckoview metric of the same name.)
324 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
325 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
326 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
327 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
329 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
332 - perf-telemetry-alerts@mozilla.com
336 type: timing_distribution
337 time_unit: millisecond
338 telemetry_mirror: TIME_TO_DOM_COMPLETE_MS
340 Time from navigationStart to domComplete as per the W3C Performance
342 (Migrated from the geckoview metric of the same name.)
344 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
345 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
346 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
347 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
349 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
352 - perf-telemetry-alerts@mozilla.com
356 type: timing_distribution
357 time_unit: millisecond
358 telemetry_mirror: TIME_TO_LOAD_EVENT_START_MS
360 Time from navigationStart to loadEventStart as per the W3C Performance
362 (Migrated from the geckoview metric of the same name.)
364 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
365 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
366 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
368 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
370 - perf-telemetry-alerts@mozilla.com
375 type: timing_distribution
376 time_unit: millisecond
377 telemetry_mirror: TIME_TO_LOAD_EVENT_END_MS
379 Time from navigationStart to loadEventEnd as per the W3C Performance
381 (Migrated from the geckoview metric of the same name.)
383 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
384 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
385 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
386 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
388 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
391 - perf-telemetry-alerts@mozilla.com
397 type: timing_distribution
398 time_unit: millisecond
399 telemetry_mirror: TIME_TO_NON_BLANK_PAINT_MS
401 The time between navigationStart and the first non-blank paint of a
402 foreground root content document, in milliseconds. This only records
403 documents that were in an active docshell throughout the whole time
404 between navigation start and non-blank paint. The non-blank paint
405 timestamp is taken during display list building and does not include
406 rasterization or compositing of that paint.
407 (Migrated from the geckoview metric of the same name.)
409 - https://bugzilla.mozilla.org/show_bug.cgi?id=1307242
410 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
411 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
412 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842
414 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
417 - perf-telemetry-alerts@mozilla.com
423 type: timing_distribution
424 time_unit: millisecond
425 telemetry_mirror: JS_PAGELOAD_EXECUTION_MS
427 Time spent during page load executing Javascript in ms.
428 (Migrated from the geckoview metric of the same name.)
430 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
431 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877843
433 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
435 - dpalmeiro@mozilla.com
436 - perf-telemetry-alerts@mozilla.com
440 type: timing_distribution
441 time_unit: millisecond
442 telemetry_mirror: JS_PAGELOAD_DELAZIFICATION_MS
444 Time spent during page load delazifying Javascript in ms.
445 (Migrated from the geckoview metric of the same name.)
447 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
448 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877843
450 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
452 - dpalmeiro@mozilla.com
453 - perf-telemetry-alerts@mozilla.com
457 type: timing_distribution
458 time_unit: millisecond
459 telemetry_mirror: JS_PAGELOAD_XDR_ENCODING_MS
461 Time spent during page load XDR encoding Javascript in ms.
462 (Migrated from the geckoview metric of the same name.)
464 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
465 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877843
467 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
469 - dpalmeiro@mozilla.com
470 - perf-telemetry-alerts@mozilla.com
473 baseline_compile_time:
474 type: timing_distribution
475 time_unit: millisecond
476 telemetry_mirror: JS_PAGELOAD_BASELINE_COMPILE_MS
478 Time spent during page load baseline compiling Javascript in ms.
479 (Migrated from the geckoview metric of the same name.)
481 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
482 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877843
484 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
486 - dpalmeiro@mozilla.com
487 - perf-telemetry-alerts@mozilla.com
491 type: timing_distribution
492 time_unit: millisecond
493 telemetry_mirror: JS_PAGELOAD_GC_MS
495 Time spent during page load in the GC in ms.
496 (Migrated from the geckoview metric of the same name.)
498 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
499 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877843
501 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
503 - dpalmeiro@mozilla.com
504 - perf-telemetry-alerts@mozilla.com
508 type: timing_distribution
509 time_unit: millisecond
510 telemetry_mirror: JS_PAGELOAD_PARSE_MS
512 Time spent during page load syntax parsing JS scripts on
513 the main thread in ms.
514 (Migrated from the geckoview metric of the same name.)
516 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
517 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877843
519 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
521 - dpalmeiro@mozilla.com
522 - perf-telemetry-alerts@mozilla.com
526 type: timing_distribution
527 time_unit: millisecond
528 telemetry_mirror: JS_PAGELOAD_PROTECT_MS
530 Time spent during page load protecting JIT executable memory.
531 (Migrated from the geckoview metric of the same name.)
533 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
534 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877843
536 - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
538 - dpalmeiro@mozilla.com
539 - perf-telemetry-alerts@mozilla.com
546 When running with Fission, we received an unexpected principal from
547 the content process. Expected values for this telemetry event are
548 the method names in ContentParent that received the unexpected
550 This event was generated to correspond to the Legacy Telemetry event
551 security.fissionPrincipals#contentParent.
553 - https://bugzil.la/1687891
555 - https://bugzil.la/1687891
558 - ckerschb@mozilla.com
563 The `value` of the event. Mirrors to the Legacy Telemetry
564 event's `value` parameter.
568 The type of principal that was received. Expected values for this field are
578 If the principal is a ContentPrincipal, we also collect the scheme
580 telemetry_mirror: Security_Fissionprincipals_Contentparent
586 The number of documents that contained enabled MathML elements.
587 This metric was generated to correspond to the Legacy Telemetry
588 scalar mathml.doc_count.
590 - https://bugzil.la/1362187
591 - https://bugzil.la/1538985
592 - https://bugzil.la/1590350
594 - https://bugzil.la/1362187
595 - https://bugzil.la/1538985
596 - https://bugzil.la/1590350
600 - dev-tech-layout@lists.mozilla.org
602 telemetry_mirror: MATHML_DOC_COUNT
608 The number of times the about:restartrequired page appeared due to a
609 buildID mismatch between the parent and the content processes.
610 This metric was generated to correspond to the Legacy Telemetry
611 scalar dom.contentprocess.buildID_mismatch.
613 - https://bugzil.la/1366808
615 - https://bugzil.la/1366808
619 telemetry_mirror: DOM_CONTENTPROCESS_BUILDID_MISMATCH
621 build_id_mismatch_false_positive:
624 The number of times a process crashed early but we could verify it
625 was not because of buildID mismatch between the parent and the
627 This metric was generated to correspond to the Legacy Telemetry
628 scalar dom.contentprocess.buildID_mismatch_false_positive.
630 - https://bugzil.la/1651133
631 - https://bugzil.la/1730045
632 - https://bugzil.la/1754658
633 - https://bugzil.la/1777404
634 - https://bugzil.la/1817104
635 - https://bugzil.la/1866197
636 - https://bugzil.la/1928259
638 - https://bugzil.la/1651133
639 - https://bugzil.la/1730045
640 - https://bugzil.la/1754658
641 - https://bugzil.la/1777404
642 - https://bugzil.la/1817104
643 - https://bugzil.la/1866197
644 - https://bugzil.la/1928259
648 telemetry_mirror: DOM_CONTENTPROCESS_BUILDID_MISMATCH_FALSE_POSITIVE
653 The number of times a content process has had its OS priority
654 lowered due to only containing background tabs without audible media
656 This metric was generated to correspond to the Legacy Telemetry
657 scalar dom.contentprocess.os_priority_lowered.
659 - https://bugzil.la/1538987
661 - https://bugzil.la/1538987
663 - mconley@mozilla.com
664 - gsvelto@mozilla.com
666 telemetry_mirror: DOM_CONTENTPROCESS_OS_PRIORITY_LOWERED
671 The number of times a content process has had its OS priority raised
672 due to containing at least one foregrounded tab, or a tab with
673 audible media has started playing in it.
674 This metric was generated to correspond to the Legacy Telemetry
675 scalar dom.contentprocess.os_priority_raised.
677 - https://bugzil.la/1538987
679 - https://bugzil.la/1538987
681 - mconley@mozilla.com
682 - gsvelto@mozilla.com
684 telemetry_mirror: DOM_CONTENTPROCESS_OS_PRIORITY_RAISED
686 os_priority_change_considered:
689 The number of times we've had the opportunity to change content
690 process priority due to a tab switch or a tab being opened.
691 This metric was generated to correspond to the Legacy Telemetry
692 scalar dom.contentprocess.os_priority_change_considered.
694 - https://bugzil.la/1538987
696 - https://bugzil.la/1538987
698 - mconley@mozilla.com
699 - gsvelto@mozilla.com
701 telemetry_mirror: DOM_CONTENTPROCESS_OS_PRIORITY_CHANGE_CONSIDERED
707 Whether a private browsing window has been used in the session.
708 This metric was generated to correspond to the Legacy Telemetry
709 scalar dom.parentprocess.private_window_used.
711 - https://bugzil.la/1491047
713 - https://bugzil.la/1491047
715 - seceng-telemetry@mozilla.com
716 - ehsan+telemetry@mozilla.com
718 telemetry_mirror: DOM_PARENTPROCESS_PRIVATE_WINDOW_USED
720 process_launch_errors:
721 type: labeled_counter
723 Collect precise set of error code and calling site upon process
724 creation failure path.
725 This metric was generated to correspond to the Legacy Telemetry
726 scalar dom.parentprocess.process_launch_errors.
728 - https://bugzil.la/1819311
730 - https://bugzil.la/1819311
734 telemetry_mirror: DOM_PARENTPROCESS_PROCESS_LAUNCH_ERRORS