metrics.yaml (42625B)
1 # This Source Code Form is subject to the terms of the Mozilla Public 2 # License, v. 2.0. If a copy of the MPL was not distributed with this 3 # file, You can obtain one at http://mozilla.org/MPL/2.0/. 4 5 # Adding a new metric? We have docs for that! 6 # https://firefox-source-docs.mozilla.org/toolkit/components/glean/user/new_definitions_file.html 7 8 --- 9 $schema: moz://mozilla.org/schemas/glean/metrics/2-0-0 10 $tags: 11 - 'Core :: DOM: Core & HTML' 12 13 perf: 14 largest_contentful_paint: 15 type: timing_distribution 16 time_unit: millisecond 17 description: > 18 Time from navigation start to largest contentful paint. 19 bugs: 20 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939 21 data_reviews: 22 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939#c5 23 notification_emails: 24 - perf-telemetry-alerts@mozilla.com 25 expires: never 26 telemetry_mirror: PERF_LARGEST_CONTENTFUL_PAINT_MS 27 metadata: 28 # Settings used for prototyping telemetry alerting 29 monitor: True 30 largest_contentful_paint_from_response_start: 31 type: timing_distribution 32 time_unit: millisecond 33 description: > 34 Time from response start to largest contentful paint. 35 bugs: 36 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939 37 data_reviews: 38 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939#c5 39 notification_emails: 40 - perf-telemetry-alerts@mozilla.com 41 expires: never 42 telemetry_mirror: PERF_LARGEST_CONTENTFUL_PAINT_FROM_RESPONSE_START_MS 43 page_load: 44 type: event 45 description: > 46 Recorded when a top level content document has been loaded. 47 bugs: 48 - https://bugzilla.mozilla.org/show_bug.cgi?id=1759744 49 - https://bugzilla.mozilla.org/show_bug.cgi?id=1799727 50 - https://bugzilla.mozilla.org/show_bug.cgi?id=1834774 51 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939 52 - https://bugzilla.mozilla.org/show_bug.cgi?id=1892231 53 - https://bugzilla.mozilla.org/show_bug.cgi?id=1923894 54 - https://bugzilla.mozilla.org/show_bug.cgi?id=1954216 55 - https://bugzilla.mozilla.org/show_bug.cgi?id=1949038 56 data_reviews: 57 - https://bugzilla.mozilla.org/show_bug.cgi?id=1759744#c5 58 - https://bugzilla.mozilla.org/show_bug.cgi?id=1799727#c4 59 - https://bugzilla.mozilla.org/show_bug.cgi?id=1834774#c3 60 - https://bugzilla.mozilla.org/show_bug.cgi?id=1862939#c5 61 - https://bugzilla.mozilla.org/show_bug.cgi?id=1892231#c3 62 notification_emails: 63 - perf-telemetry-alerts@mozilla.com 64 - dpalmeiro@mozilla.com 65 expires: never 66 extra_keys: 67 load_time: 68 description: | 69 Time between loadEventStart and navigationStart, in ms. 70 type: quantity 71 unit: ms 72 dns_lookup_time: 73 description: | 74 Time taken to perform dns lookup of the top level document, in ms. 75 type: quantity 76 unit: ms 77 time_to_request_start: 78 description: | 79 Time between requestStart and navigationStart, in ms. 80 type: quantity 81 unit: ms 82 response_time: 83 description: | 84 Time between responseStart and navigationStart, in ms. 85 type: quantity 86 unit: ms 87 fcp_time: 88 description: | 89 Time between firstContentfulPaint and navigationStart, in ms. 90 type: quantity 91 unit: ms 92 lcp_time: 93 description: | 94 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. 95 type: quantity 96 unit: ms 97 js_exec_time: 98 description: | 99 Time spent executing JS during page load, in ms. 100 type: quantity 101 unit: ms 102 delazify_time: 103 description: | 104 Time spent delazifying JS during page load, in ms. 105 type: quantity 106 unit: ms 107 redirect_time: 108 type: quantity 109 description: | 110 Time spent in redirections for the top level document. 111 unit: ms 112 tls_handshake_time: 113 type: quantity 114 description: | 115 Time spent in TLS handshake for the top level document. 116 unit: ms 117 redirect_count: 118 description: | 119 Number of redirections for the top level document. 120 type: quantity 121 unit: integer 122 load_type: 123 description: | 124 One of normal,reload,stop,link,history,error or other. 125 type: string 126 same_origin_nav: 127 description: | 128 If true, a normal navigation was performed on the same origin. 129 type: boolean 130 using_webdriver: 131 description: | 132 If true, a webdriver is running on the client. 133 type: boolean 134 http_ver: 135 description: | 136 Version of HTTP protocol used. 137 type: quantity 138 unit: integer 139 trr_domain: 140 description: | 141 TRR domain used. 142 type: string 143 document_features: 144 description: > 145 Bitfield of web features in use within this document: 146 1 - fetchpriority applied to images 147 type: quantity 148 unit: integer 149 user_features: 150 description: > 151 Bitfield of features the user is enabling: 152 1 - assistive technology in use 153 type: quantity 154 unit: integer 155 has_ssd: 156 description: | 157 Whether the user has SSD in their hardware or not. Only available on Windows, after startup-idle-tasks are done 158 type: boolean 159 cache_disposition: 160 description: | 161 cache disposition for the top level document 162 type: quantity 163 unit: integer 164 network_type: 165 description: | 166 Network link type from nsINetworkLinkService, only available on android. Values as: 167 - 0 unknown 168 - 1 ethernet 169 - 2 usb 170 - 3 wifi 171 - 4 wifimax 172 - 9 mobile 173 type: quantity 174 unit: integer 175 android_app_link_launch_type: 176 description: 177 "AppLink launch type, android only. UNKNOWN = 0 COLD = 1, WARM = 2, HOT = 3, see LoadURIOptions.webidl" 178 type: quantity 179 unit: integer 180 android_app_link_to_navigation_start: 181 type: quantity 182 description: 183 "For android navigations, the time from application launch (i.e parent process start) to navigation start. Only meaningful with android_app_link_launch_type = COLD" 184 unit: ms 185 send_in_pings: 186 - pageload 187 page_load_domain: 188 type: event 189 description: > 190 Recorded when a top level content document has been loaded. 191 Includes ETLD+1 information and sent with ohttp. 192 bugs: 193 - https://bugzilla.mozilla.org/show_bug.cgi?id=1967780 194 data_reviews: 195 - https://phabricator.services.mozilla.com/D250521 196 notification_emails: 197 - perf-telemetry-alerts@mozilla.com 198 - dpalmeiro@mozilla.com 199 expires: never 200 extra_keys: 201 lcp_time: 202 description: | 203 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. 204 type: quantity 205 unit: ms 206 load_type: 207 description: | 208 One of normal,reload,stop,link,history,error or other. 209 type: string 210 same_origin_nav: 211 description: | 212 If true, a normal navigation was performed on the same origin. 213 type: boolean 214 http_ver: 215 description: | 216 Version of HTTP protocol used. 217 type: quantity 218 unit: integer 219 document_features: 220 description: > 221 Bitfield of web features in use within this document: 222 1 - fetchpriority applied to images 223 type: quantity 224 unit: integer 225 domain: 226 description: | 227 ETLD+1 domain of website visited. 228 type: string 229 channel: 230 description: | 231 Release channel of the build. Either "nightly" or "release" only. 232 type: string 233 app_version_major: 234 description: | 235 Major version number. 236 type: quantity 237 unit: integer 238 send_in_pings: 239 - pageload-base-domain 240 241 h3p_page_load_time: 242 type: labeled_timing_distribution 243 description: > 244 Time in milliseconds from navigationStart to loadEventStart for the 245 foreground http or https root content document. This is collected only on 246 page load where the main document uses HTTP3. It is keyed based on whether 247 a "priority" header has been received. 248 249 This metric was generated to correspond to the Legacy Telemetry 250 exponential histogram H3P_PERF_PAGE_LOAD_TIME_MS. 251 time_unit: millisecond 252 bugs: 253 - https://bugzilla.mozilla.org/show_bug.cgi?id=1743965 254 - https://bugzilla.mozilla.org/show_bug.cgi?id=1796398 255 data_reviews: 256 - https://bugzilla.mozilla.org/show_bug.cgi?id=1743965 257 - https://bugzilla.mozilla.org/show_bug.cgi?id=1796398 258 notification_emails: 259 - necko@mozilla.com 260 expires: never 261 telemetry_mirror: H3P_PERF_PAGE_LOAD_TIME_MS 262 263 h3p_first_contentful_paint: 264 type: labeled_timing_distribution 265 description: > 266 The time between navigationStart and the first contentful paint of a 267 foreground http or https root content document, in milliseconds. The 268 contentful paint timestamp is taken during display list building and does 269 not include rasterization or compositing of that paint. This is collected 270 only on page load where the main document uses HTTP3. It is keyed based on 271 whether a "priority" header has been received. 272 273 This metric was generated to correspond to the Legacy Telemetry 274 exponential histogram H3P_PERF_FIRST_CONTENTFUL_PAINT_MS. 275 time_unit: millisecond 276 bugs: 277 - https://bugzilla.mozilla.org/show_bug.cgi?id=1743965 278 - https://bugzilla.mozilla.org/show_bug.cgi?id=1796398 279 data_reviews: 280 - https://bugzilla.mozilla.org/show_bug.cgi?id=1743965 281 - https://bugzilla.mozilla.org/show_bug.cgi?id=1796398 282 notification_emails: 283 - necko@mozilla.com 284 expires: never 285 telemetry_mirror: H3P_PERF_FIRST_CONTENTFUL_PAINT_MS 286 287 dns_first_byte: 288 type: labeled_timing_distribution 289 description: > 290 The time from a top-level document's HTTP channel open to the first byte 291 of the reply is received (ms). Keyed by TRR domain for DoH or 'Native' 292 otherwise 293 294 This metric was generated to correspond to the Legacy Telemetry 295 exponential histogram DNS_PERF_FIRST_BYTE_MS. 296 time_unit: millisecond 297 bugs: 298 - https://bugzilla.mozilla.org/show_bug.cgi?id=1803671 299 data_reviews: 300 - https://bugzilla.mozilla.org/show_bug.cgi?id=1803671 301 notification_emails: 302 - necko@mozilla.com 303 - acreskey@mozilla.com 304 expires: never 305 telemetry_mirror: DNS_PERF_FIRST_BYTE_MS 306 307 cold_applink_process_launch_to_load_uri: 308 type: timing_distribution 309 time_unit: millisecond 310 description: | 311 The duration from cold process launch to load URI for an android cold applink. 312 bugs: 313 - https://bugzilla.mozilla.org/show_bug.cgi?id=1990344 314 data_reviews: 315 - https://bugzilla.mozilla.org/show_bug.cgi?id=1990344 316 data_sensitivity: 317 - technical 318 notification_emails: 319 - perf-telemetry-alerts@mozilla.com 320 - android-probes@mozilla.com 321 expires: never 322 323 cold_applink_main_to_load_uri: 324 type: timing_distribution 325 time_unit: millisecond 326 description: | 327 The duration from StartupTimeline::MAIN to load URI for an android cold applink. 328 bugs: 329 - https://bugzilla.mozilla.org/show_bug.cgi?id=1991160 330 data_reviews: 331 - https://bugzilla.mozilla.org/show_bug.cgi?id=1991160 332 data_sensitivity: 333 - technical 334 notification_emails: 335 - perf-telemetry-alerts@mozilla.com 336 - android-probes@mozilla.com 337 expires: never 338 339 performance.pageload: 340 load_time: 341 type: timing_distribution 342 time_unit: millisecond 343 telemetry_mirror: PERF_PAGE_LOAD_TIME_MS 344 description: > 345 Time in milliseconds from navigationStart to loadEventStart 346 for the foreground http or https root content document. 347 (Migrated from the geckoview metric of the same name). 348 bugs: 349 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729 350 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 351 data_reviews: 352 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7 353 notification_emails: 354 - dpalmeiro@mozilla.com 355 - perf-telemetry-alerts@mozilla.com 356 expires: never 357 358 load_time_responsestart: 359 type: timing_distribution 360 time_unit: millisecond 361 telemetry_mirror: PERF_PAGE_LOAD_TIME_FROM_RESPONSESTART_MS 362 description: > 363 Time in milliseconds from responseStart to loadEventStart 364 for the foreground http or https root content document. 365 (Migrated from the geckoview metric of the same name). 366 bugs: 367 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729 368 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 369 data_reviews: 370 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7 371 notification_emails: 372 - dpalmeiro@mozilla.com 373 - perf-telemetry-alerts@mozilla.com 374 expires: never 375 376 fcp: 377 type: timing_distribution 378 time_unit: millisecond 379 telemetry_mirror: PERF_FIRST_CONTENTFUL_PAINT_MS 380 description: > 381 The time between navigationStart and the first contentful paint 382 of a foreground http or https root content document, in 383 milliseconds. The contentful paint timestamp is taken during 384 display list building and does not include rasterization or 385 compositing of that paint. 386 (Migrated from the geckoview metric of the same name). 387 bugs: 388 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729 389 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 390 data_reviews: 391 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7 392 notification_emails: 393 - dpalmeiro@mozilla.com 394 - perf-telemetry-alerts@mozilla.com 395 expires: never 396 397 fcp_responsestart: 398 type: timing_distribution 399 time_unit: millisecond 400 telemetry_mirror: PERF_FIRST_CONTENTFUL_PAINT_FROM_RESPONSESTART_MS 401 description: > 402 The time between responseStart and the first contentful paint 403 of a foreground http or https root content document, in 404 milliseconds. The contentful paint timestamp is taken during 405 display list building and does not include rasterization or 406 compositing of that paint. 407 (Migrated from the geckoview metric of the same name). 408 bugs: 409 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729 410 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 411 data_reviews: 412 - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7 413 notification_emails: 414 - dpalmeiro@mozilla.com 415 - perf-telemetry-alerts@mozilla.com 416 expires: never 417 418 http3_fcp_http3: &http3_fcp_http3 419 type: timing_distribution 420 time_unit: millisecond 421 description: > 422 The time between navigationStart and the first contentful paint of 423 a foreground http or https root content document, in milliseconds. 424 The contentful paint timestamp is taken during display list building 425 and does not include rasterization or compositing of that paint. 426 This is collected only on page load where the main document uses or suppports HTTP3. 427 bugs: 428 - https://bugzilla.mozilla.org/show_bug.cgi?id=1675503 429 - https://bugzilla.mozilla.org/show_bug.cgi?id=1898245 430 data_reviews: 431 - https://bugzilla.mozilla.org/show_bug.cgi?id=1898245 432 notification_emails: 433 - necko@mozilla.com 434 - perf-telemetry-alerts@mozilla.com 435 expires: never 436 437 http3_fcp_supports_http3: 438 <<: *http3_fcp_http3 439 description: > 440 The time between navigationStart and the first contentful paint of 441 a foreground http or https root content document, in milliseconds. 442 The contentful paint timestamp is taken during display list building 443 and does not include rasterization or compositing of that paint. 444 This is collected only on page load where the main document supports but is not using HTTP3. 445 446 h3p_fcp_with_priority: &h3p_fcp_with_priority 447 type: timing_distribution 448 time_unit: millisecond 449 description: > 450 The time between navigationStart and the first contentful paint of 451 a foreground http or https root content document, in milliseconds. 452 The contentful paint timestamp is taken during display list 453 building and does not include rasterization or compositing of that paint. 454 This is collected only on page load where the main document uses HTTP3. 455 A "priority" header has been received. 456 bugs: 457 - https://bugzilla.mozilla.org/show_bug.cgi?id=1743965 458 - https://bugzilla.mozilla.org/show_bug.cgi?id=1796398 459 - https://bugzilla.mozilla.org/show_bug.cgi?id=1898245 460 data_reviews: 461 - https://bugzilla.mozilla.org/show_bug.cgi?id=1898245 462 notification_emails: 463 - necko@mozilla.com 464 - perf-telemetry-alerts@mozilla.com 465 expires: never 466 467 http3_fcp_without_priority: 468 <<: *h3p_fcp_with_priority 469 description: > 470 The time between navigationStart and the first contentful paint of 471 a foreground http or https root content document, in milliseconds. 472 The contentful paint timestamp is taken during display list 473 building and does not include rasterization or compositing of that paint. 474 This is collected only on page load where the main document uses HTTP3. 475 A "priority" header has not been received. 476 477 performance.time: 478 dom_interactive: 479 type: timing_distribution 480 time_unit: millisecond 481 telemetry_mirror: TIME_TO_DOM_INTERACTIVE_MS 482 description: > 483 Time from navigationStart to domInteractive as per the W3C 484 Performance Timing API. 485 (Migrated from the geckoview metric of the same name.) 486 bugs: 487 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893 488 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524 489 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077 490 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 491 data_reviews: 492 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10 493 notification_emails: 494 - vgosu@mozilla.com 495 - perf-telemetry-alerts@mozilla.com 496 expires: never 497 498 dom_content_loaded_start: 499 type: timing_distribution 500 time_unit: millisecond 501 telemetry_mirror: TIME_TO_DOM_CONTENT_LOADED_START_MS 502 description: > 503 Time from navigationStart to domContentLoadedEventStart as per 504 the W3C Performance Timing API. 505 (Migrated from the geckoview metric of the same name.) 506 bugs: 507 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893 508 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077 509 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 510 data_reviews: 511 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10 512 notification_emails: 513 - perf-telemetry-alerts@mozilla.com 514 - bdekoz@mozilla.com 515 expires: never 516 517 dom_content_loaded_end: 518 type: timing_distribution 519 time_unit: millisecond 520 telemetry_mirror: TIME_TO_DOM_CONTENT_LOADED_END_MS 521 description: > 522 Time from navigationStart to domContentLoadedEventEnd as per 523 the W3C Performance Timing API. 524 (Migrated from the geckoview metric of the same name.) 525 bugs: 526 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893 527 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524 528 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077 529 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 530 data_reviews: 531 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10 532 notification_emails: 533 - vchin@mozilla.com 534 - perf-telemetry-alerts@mozilla.com 535 expires: never 536 537 dom_complete: 538 type: timing_distribution 539 time_unit: millisecond 540 telemetry_mirror: TIME_TO_DOM_COMPLETE_MS 541 description: > 542 Time from navigationStart to domComplete as per the W3C Performance 543 Timing API. 544 (Migrated from the geckoview metric of the same name.) 545 bugs: 546 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893 547 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524 548 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077 549 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 550 data_reviews: 551 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10 552 notification_emails: 553 - vgosu@mozilla.com 554 - perf-telemetry-alerts@mozilla.com 555 expires: never 556 557 load_event_start: 558 type: timing_distribution 559 time_unit: millisecond 560 telemetry_mirror: TIME_TO_LOAD_EVENT_START_MS 561 description: > 562 Time from navigationStart to loadEventStart as per the W3C Performance 563 Timing API. 564 (Migrated from the geckoview metric of the same name.) 565 bugs: 566 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893 567 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077 568 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 569 data_reviews: 570 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10 571 notification_emails: 572 - perf-telemetry-alerts@mozilla.com 573 - bdekoz@mozilla.com 574 expires: never 575 576 load_event_end: 577 type: timing_distribution 578 time_unit: millisecond 579 telemetry_mirror: TIME_TO_LOAD_EVENT_END_MS 580 description: > 581 Time from navigationStart to loadEventEnd as per the W3C Performance 582 Timing API. 583 (Migrated from the geckoview metric of the same name.) 584 bugs: 585 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893 586 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524 587 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077 588 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 589 data_reviews: 590 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10 591 notification_emails: 592 - vchin@mozilla.com 593 - perf-telemetry-alerts@mozilla.com 594 expires: never 595 596 to_first_contentful_paint: 597 type: timing_distribution 598 description: > 599 The time between navigation start and the first contentful paint of a 600 foreground root content document, in milliseconds. This only records 601 documents that were in an active docshell throughout the whole time 602 between navigation start and contentful paint. The contentful paint 603 timestamp is taken during display list building and does not include 604 rasterization or compositing of that paint. 605 606 This metric was generated to correspond to the Legacy Telemetry 607 exponential histogram TIME_TO_FIRST_CONTENTFUL_PAINT_MS. 608 time_unit: millisecond 609 bugs: 610 - https://bugzilla.mozilla.org/show_bug.cgi?id=1515132 611 data_reviews: 612 - https://bugzilla.mozilla.org/show_bug.cgi?id=1515132 613 notification_emails: 614 - perf-telemetry-alerts@mozilla.com 615 expires: never 616 telemetry_mirror: TIME_TO_FIRST_CONTENTFUL_PAINT_MS 617 618 to_dom_loading: 619 type: timing_distribution 620 description: > 621 Time in milliseconds from navigationStart to domLoading. 622 623 This metric was generated to correspond to the Legacy Telemetry 624 exponential histogram TIME_TO_DOM_LOADING_MS. 625 time_unit: millisecond 626 bugs: 627 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893 628 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524 629 data_reviews: 630 - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893 631 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524 632 notification_emails: 633 - vgosu@mozilla.com 634 - necko@mozilla.com 635 expires: never 636 telemetry_mirror: TIME_TO_DOM_LOADING_MS 637 638 performance.page: 639 non_blank_paint: 640 type: timing_distribution 641 time_unit: millisecond 642 telemetry_mirror: TIME_TO_NON_BLANK_PAINT_MS 643 description: > 644 The time between navigationStart and the first non-blank paint of a 645 foreground root content document, in milliseconds. This only records 646 documents that were in an active docshell throughout the whole time 647 between navigation start and non-blank paint. The non-blank paint 648 timestamp is taken during display list building and does not include 649 rasterization or compositing of that paint. 650 (Migrated from the geckoview metric of the same name.) 651 bugs: 652 - https://bugzilla.mozilla.org/show_bug.cgi?id=1307242 653 - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524 654 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077 655 - https://bugzilla.mozilla.org/show_bug.cgi?id=1877842 656 data_reviews: 657 - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10 658 notification_emails: 659 - vchin@mozilla.com 660 - perf-telemetry-alerts@mozilla.com 661 expires: never 662 663 security: 664 fission_principals: 665 type: event 666 description: > 667 When running with Fission, we received an unexpected principal from 668 the content process. Expected values for this telemetry event are 669 the method names in ContentParent that received the unexpected 670 principal. 671 This event was generated to correspond to the Legacy Telemetry event 672 security.fissionPrincipals#contentParent. 673 bugs: 674 - https://bugzil.la/1687891 675 data_reviews: 676 - https://bugzil.la/1687891 677 notification_emails: 678 - tom@mozilla.com 679 - ckerschb@mozilla.com 680 expires: never 681 extra_keys: 682 value: 683 description: > 684 The `value` of the event. Mirrors to the Legacy Telemetry 685 event's `value` parameter. 686 type: string 687 principalType: 688 description: > 689 The type of principal that was received. Expected values for this field are 690 NullPtr 691 SystemPrincipal 692 ExpandedPrincipal 693 ContentPrincipal 694 Unknown 695 696 type: string 697 scheme: 698 description: > 699 If the principal is a ContentPrincipal, we also collect the scheme 700 type: string 701 telemetry_mirror: Security_Fissionprincipals_Contentparent 702 703 shadowed_html_document_property_access: 704 type: event 705 description: > 706 When accessing a property on the HTMLDocument like (document.currentScript), 707 if that property was shadowed/"clobbered" (e.g. using <img name=currentScript>), the 708 name of the shadowed built-in property is collected. 709 bugs: 710 - https://bugzil.la/1955578 711 data_reviews: 712 - https://bugzil.la/1955578 713 notification_emails: 714 - tschuster@mozilla.com 715 expires: 152 716 extra_keys: 717 name: 718 description: > 719 Name of the shadowed HTML property that was accessed. 720 type: string 721 722 dom.contentprocess: 723 build_id_mismatch: 724 type: counter 725 description: > 726 The number of times the about:restartrequired page appeared due to a 727 buildID mismatch between the parent and the content processes. 728 This metric was generated to correspond to the Legacy Telemetry 729 scalar dom.contentprocess.buildID_mismatch. 730 bugs: 731 - https://bugzil.la/1366808 732 data_reviews: 733 - https://bugzil.la/1366808 734 notification_emails: 735 - spohl@mozilla.com 736 expires: never 737 telemetry_mirror: DOM_CONTENTPROCESS_BUILDID_MISMATCH 738 739 build_id_mismatch_false_positive: 740 type: counter 741 description: > 742 The number of times a process crashed early but we could verify it 743 was not because of buildID mismatch between the parent and the 744 content processes. 745 This metric was generated to correspond to the Legacy Telemetry 746 scalar dom.contentprocess.buildID_mismatch_false_positive. 747 bugs: 748 - https://bugzil.la/1651133 749 - https://bugzil.la/1730045 750 - https://bugzil.la/1754658 751 - https://bugzil.la/1777404 752 - https://bugzil.la/1817104 753 - https://bugzil.la/1866197 754 - https://bugzil.la/1928259 755 data_reviews: 756 - https://bugzil.la/1651133 757 - https://bugzil.la/1730045 758 - https://bugzil.la/1754658 759 - https://bugzil.la/1777404 760 - https://bugzil.la/1817104 761 - https://bugzil.la/1866197 762 - https://bugzil.la/1928259 763 notification_emails: 764 - alissy@mozilla.com 765 expires: 150 766 telemetry_mirror: DOM_CONTENTPROCESS_BUILDID_MISMATCH_FALSE_POSITIVE 767 768 os_priority_lowered: 769 type: counter 770 description: > 771 The number of times a content process has had its OS priority 772 lowered due to only containing background tabs without audible media 773 playing. 774 This metric was generated to correspond to the Legacy Telemetry 775 scalar dom.contentprocess.os_priority_lowered. 776 bugs: 777 - https://bugzil.la/1538987 778 data_reviews: 779 - https://bugzil.la/1538987 780 notification_emails: 781 - mconley@mozilla.com 782 - gsvelto@mozilla.com 783 expires: never 784 telemetry_mirror: DOM_CONTENTPROCESS_OS_PRIORITY_LOWERED 785 786 os_priority_raised: 787 type: counter 788 description: > 789 The number of times a content process has had its OS priority raised 790 due to containing at least one foregrounded tab, or a tab with 791 audible media has started playing in it. 792 This metric was generated to correspond to the Legacy Telemetry 793 scalar dom.contentprocess.os_priority_raised. 794 bugs: 795 - https://bugzil.la/1538987 796 data_reviews: 797 - https://bugzil.la/1538987 798 notification_emails: 799 - mconley@mozilla.com 800 - gsvelto@mozilla.com 801 expires: never 802 telemetry_mirror: DOM_CONTENTPROCESS_OS_PRIORITY_RAISED 803 804 os_priority_change_considered: 805 type: counter 806 description: > 807 The number of times we've had the opportunity to change content 808 process priority due to a tab switch or a tab being opened. 809 This metric was generated to correspond to the Legacy Telemetry 810 scalar dom.contentprocess.os_priority_change_considered. 811 bugs: 812 - https://bugzil.la/1538987 813 data_reviews: 814 - https://bugzil.la/1538987 815 notification_emails: 816 - mconley@mozilla.com 817 - gsvelto@mozilla.com 818 expires: never 819 telemetry_mirror: DOM_CONTENTPROCESS_OS_PRIORITY_CHANGE_CONSIDERED 820 821 launch_mainthread: 822 type: timing_distribution 823 description: > 824 Time spent on the main thread during asynchronous content process launch. 825 826 This metric was generated to correspond to the Legacy Telemetry 827 exponential histogram CONTENT_PROCESS_LAUNCH_MAINTHREAD_MS. 828 time_unit: millisecond 829 bugs: 830 - https://bugzilla.mozilla.org/show_bug.cgi?id=1474991 831 data_reviews: 832 - https://bugzilla.mozilla.org/show_bug.cgi?id=1474991 833 notification_emails: 834 - jld@mozilla.com 835 - jimm@mozilla.com 836 - mconley@mozilla.com 837 expires: never 838 telemetry_mirror: CONTENT_PROCESS_LAUNCH_MAINTHREAD_MS 839 840 launch_total: 841 type: timing_distribution 842 description: > 843 Total time elapsed during asynchronous content process launch, until the 844 process is usable for loading content. 845 846 This metric was generated to correspond to the Legacy Telemetry 847 exponential histogram CONTENT_PROCESS_LAUNCH_TOTAL_MS. 848 time_unit: millisecond 849 bugs: 850 - https://bugzilla.mozilla.org/show_bug.cgi?id=1474991 851 data_reviews: 852 - https://bugzilla.mozilla.org/show_bug.cgi?id=1474991 853 notification_emails: 854 - jld@mozilla.com 855 - jimm@mozilla.com 856 - mconley@mozilla.com 857 expires: never 858 telemetry_mirror: CONTENT_PROCESS_LAUNCH_TOTAL_MS 859 860 sync_launch: 861 type: timing_distribution 862 description: > 863 Time elapsed during synchronous content process launch until the process 864 is usable for loading content. 865 866 This metric was generated to correspond to the Legacy Telemetry 867 exponential histogram CONTENT_PROCESS_SYNC_LAUNCH_MS. 868 time_unit: millisecond 869 bugs: 870 - https://bugzilla.mozilla.org/show_bug.cgi?id=1474991 871 data_reviews: 872 - https://bugzilla.mozilla.org/show_bug.cgi?id=1474991 873 notification_emails: 874 - jld@mozilla.com 875 - jimm@mozilla.com 876 - mconley@mozilla.com 877 expires: never 878 telemetry_mirror: CONTENT_PROCESS_SYNC_LAUNCH_MS 879 880 launch_is_sync: 881 type: labeled_counter 882 description: > 883 Whether a content process was launched synchronously (unnecessarily 884 delaying UI response). 885 886 This metric was generated to correspond to the Legacy Telemetry boolean 887 histogram CONTENT_PROCESS_LAUNCH_IS_SYNC. 888 labels: 889 - "false" 890 - "true" 891 bugs: 892 - https://bugzilla.mozilla.org/show_bug.cgi?id=1474991 893 data_reviews: 894 - https://bugzilla.mozilla.org/show_bug.cgi?id=1474991 895 notification_emails: 896 - jld@mozilla.com 897 - jimm@mozilla.com 898 - mconley@mozilla.com 899 expires: never 900 telemetry_mirror: h#CONTENT_PROCESS_LAUNCH_IS_SYNC 901 902 dom.parentprocess: 903 private_window_used: 904 type: boolean 905 description: > 906 Whether a private browsing window has been used in the session. 907 This metric was generated to correspond to the Legacy Telemetry 908 scalar dom.parentprocess.private_window_used. 909 bugs: 910 - https://bugzil.la/1491047 911 data_reviews: 912 - https://bugzil.la/1491047 913 notification_emails: 914 - seceng-telemetry@mozilla.com 915 - ehsan+telemetry@mozilla.com 916 expires: never 917 telemetry_mirror: DOM_PARENTPROCESS_PRIVATE_WINDOW_USED 918 919 process_launch_errors: 920 type: labeled_counter 921 description: > 922 Collect precise set of error code and calling site upon process 923 creation failure path. 924 This metric was generated to correspond to the Legacy Telemetry 925 scalar dom.parentprocess.process_launch_errors. 926 bugs: 927 - https://bugzil.la/1819311 928 data_reviews: 929 - https://bugzil.la/1819311 930 notification_emails: 931 - alissy@mozilla.com 932 expires: never 933 telemetry_mirror: DOM_PARENTPROCESS_PROCESS_LAUNCH_ERRORS 934 935 dom.textfragment: 936 find_directives: 937 type: timing_distribution 938 description: | 939 Time spent in TextDirectiveFinder::FindTextDirectivesInDocument() per page load 940 time_unit: millisecond 941 expires: never 942 bugs: 943 - https://bugzilla.mozilla.org/show_bug.cgi?id=1942117 944 data_reviews: 945 - https://bugzilla.mozilla.org/show_bug.cgi?id=1942117 946 notification_emails: 947 - dom-core@mozilla.com 948 - jjaschke@mozilla.com 949 950 create_directive: 951 type: timing_distribution 952 description: | 953 Time spent in FragmentDirective::CreateTextDirective() 954 time_unit: millisecond 955 expires: never 956 bugs: 957 - https://bugzilla.mozilla.org/show_bug.cgi?id=1942117 958 data_reviews: 959 - https://bugzilla.mozilla.org/show_bug.cgi?id=1942117 960 notification_emails: 961 - dom-core@mozilla.com 962 - jjaschke@mozilla.com 963 964 dom: 965 forget_skippable_during_idle: 966 type: custom_distribution 967 description: > 968 Percent of the cycle collector's forget skippable done during idle time 969 970 This metric was generated to correspond to the Legacy Telemetry linear 971 histogram FORGET_SKIPPABLE_DURING_IDLE. 972 range_min: 1 973 range_max: 100 974 bucket_count: 50 975 histogram_type: linear 976 unit: percent 977 bugs: 978 - https://bugzilla.mozilla.org/show_bug.cgi?id=1372042 979 data_reviews: 980 - https://bugzilla.mozilla.org/show_bug.cgi?id=1372042 981 notification_emails: 982 - dev-telemetry-gc-alerts@mozilla.org 983 expires: never 984 telemetry_mirror: FORGET_SKIPPABLE_DURING_IDLE 985 986 forget_skippable_frequency: 987 type: custom_distribution 988 description: > 989 Number of forget skippables occurred during a minute 990 991 This metric was generated to correspond to the Legacy Telemetry linear 992 histogram FORGET_SKIPPABLE_FREQUENCY. 993 range_min: 1 994 range_max: 500 995 bucket_count: 100 996 histogram_type: linear 997 unit: forget skippables per minute 998 bugs: 999 - https://bugzilla.mozilla.org/show_bug.cgi?id=1487271 1000 data_reviews: 1001 - https://bugzilla.mozilla.org/show_bug.cgi?id=1487271 1002 notification_emails: 1003 - smaug@mozilla.com 1004 - dev-telemetry-gc-alerts@mozilla.org 1005 expires: never 1006 telemetry_mirror: FORGET_SKIPPABLE_FREQUENCY 1007 1008 fullscreen_transition_black: 1009 type: timing_distribution 1010 description: > 1011 The time spent in the fully-black screen in fullscreen transition 1012 1013 This metric was generated to correspond to the Legacy Telemetry 1014 exponential histogram FULLSCREEN_TRANSITION_BLACK_MS. 1015 time_unit: millisecond 1016 bugs: 1017 - https://bugzilla.mozilla.org/show_bug.cgi?id=1271160 1018 data_reviews: 1019 - https://bugzilla.mozilla.org/show_bug.cgi?id=1271160 1020 notification_emails: 1021 - mozilla-telemetry@upsuper.org 1022 expires: never 1023 telemetry_mirror: FULLSCREEN_TRANSITION_BLACK_MS 1024 1025 gc_in_progress: 1026 type: timing_distribution 1027 description: > 1028 Time from the beginning of the first slice to the end of the last slice 1029 (ms) 1030 1031 This metric was generated to correspond to the Legacy Telemetry 1032 exponential histogram GC_IN_PROGRESS_MS. 1033 time_unit: millisecond 1034 bugs: 1035 - https://bugzilla.mozilla.org/show_bug.cgi?id=1545093 1036 data_reviews: 1037 - https://bugzilla.mozilla.org/show_bug.cgi?id=1545093 1038 notification_emails: 1039 - dev-telemetry-gc-alerts@mozilla.org 1040 - smaug@mozilla.com 1041 expires: never 1042 telemetry_mirror: GC_IN_PROGRESS_MS 1043 1044 gc_slice_during_idle: 1045 type: custom_distribution 1046 description: > 1047 Percent of GC slice done during idle time 1048 1049 This metric was generated to correspond to the Legacy Telemetry linear 1050 histogram GC_SLICE_DURING_IDLE. 1051 range_min: 1 1052 range_max: 100 1053 bucket_count: 50 1054 histogram_type: linear 1055 unit: percent 1056 bugs: 1057 - https://bugzilla.mozilla.org/show_bug.cgi?id=1372042 1058 data_reviews: 1059 - https://bugzilla.mozilla.org/show_bug.cgi?id=1372042 1060 notification_emails: 1061 - dev-telemetry-gc-alerts@mozilla.org 1062 expires: never 1063 telemetry_mirror: GC_SLICE_DURING_IDLE 1064 1065 xmlhttprequest_async_or_sync: 1066 type: labeled_counter 1067 description: > 1068 Type of XMLHttpRequest, async or sync 1069 1070 This metric was generated to correspond to the Legacy Telemetry boolean 1071 histogram XMLHTTPREQUEST_ASYNC_OR_SYNC. 1072 labels: 1073 - "false" 1074 - "true" 1075 bugs: 1076 - https://bugzilla.mozilla.org/show_bug.cgi?id=1956726 1077 data_reviews: 1078 - https://bugzilla.mozilla.org/show_bug.cgi?id=1956726 1079 notification_emails: 1080 - dom-core@mozilla.com 1081 expires: never 1082 telemetry_mirror: h#XMLHTTPREQUEST_ASYNC_OR_SYNC 1083 1084 storage_access_api_ui: 1085 type: labeled_counter 1086 description: > 1087 Storage Access API UI events. 1088 1089 This metric was generated to correspond to the Legacy Telemetry 1090 categorical histogram STORAGE_ACCESS_API_UI. 1091 labels: 1092 - Request 1093 - AllowAutomatically 1094 - Deny 1095 - Allow 1096 - AllowOnAnySite 1097 bugs: 1098 - https://bugzilla.mozilla.org/show_bug.cgi?id=1513309 1099 - https://bugzilla.mozilla.org/show_bug.cgi?id=1588844 1100 - https://bugzilla.mozilla.org/show_bug.cgi?id=1643432 1101 - https://bugzilla.mozilla.org/show_bug.cgi?id=1689262 1102 - https://bugzilla.mozilla.org/show_bug.cgi?id=1730043 1103 - https://bugzilla.mozilla.org/show_bug.cgi?id=1832670 1104 data_reviews: 1105 - https://bugzilla.mozilla.org/show_bug.cgi?id=1513309 1106 - https://bugzilla.mozilla.org/show_bug.cgi?id=1588844 1107 - https://bugzilla.mozilla.org/show_bug.cgi?id=1643432 1108 - https://bugzilla.mozilla.org/show_bug.cgi?id=1689262 1109 - https://bugzilla.mozilla.org/show_bug.cgi?id=1730043 1110 - https://bugzilla.mozilla.org/show_bug.cgi?id=1832670 1111 notification_emails: 1112 - emz@mozilla.com 1113 - tihuang@mozilla.com 1114 expires: never 1115 telemetry_mirror: h#STORAGE_ACCESS_API_UI 1116 1117 slow_script_notice_count: 1118 type: counter 1119 description: > 1120 Count slow script notices 1121 1122 This metric was generated to correspond to the Legacy Telemetry count 1123 histogram SLOW_SCRIPT_NOTICE_COUNT. 1124 bugs: 1125 - https://bugzilla.mozilla.org/show_bug.cgi?id=1956726 1126 data_reviews: 1127 - https://bugzilla.mozilla.org/show_bug.cgi?id=1956726 1128 notification_emails: 1129 - perf-telemetry-alerts@mozilla.com 1130 expires: never 1131 telemetry_mirror: h#SLOW_SCRIPT_NOTICE_COUNT 1132 1133 slow_script_page_count: 1134 type: counter 1135 description: > 1136 The number of pages that trigger slow script notices 1137 1138 This metric was generated to correspond to the Legacy Telemetry count 1139 histogram SLOW_SCRIPT_PAGE_COUNT. 1140 bugs: 1141 - https://bugzilla.mozilla.org/show_bug.cgi?id=1251667 1142 data_reviews: 1143 - https://bugzilla.mozilla.org/show_bug.cgi?id=1251667 1144 notification_emails: 1145 - perf-telemetry-alerts@mozilla.com 1146 expires: never 1147 telemetry_mirror: h#SLOW_SCRIPT_PAGE_COUNT 1148 1149 script_loading_source: 1150 type: labeled_counter 1151 description: > 1152 Record the input from which the bytes are coming from, for each script in 1153 a document. 1154 1155 This metric was generated to correspond to the Legacy Telemetry 1156 categorical histogram DOM_SCRIPT_LOADING_SOURCE. 1157 labels: 1158 - Inline 1159 - SourceFallback 1160 - Source 1161 - AltData 1162 bugs: 1163 - https://bugzilla.mozilla.org/show_bug.cgi?id=1362114 1164 data_reviews: 1165 - https://bugzilla.mozilla.org/show_bug.cgi?id=1362114 1166 notification_emails: 1167 - nicolas.b.pierron@mozilla.com 1168 expires: never 1169 telemetry_mirror: h#DOM_SCRIPT_LOADING_SOURCE 1170 1171 blink_filesystem_used: 1172 type: labeled_counter 1173 description: > 1174 Webkit/Blink filesystem used 1175 1176 This metric was generated to correspond to the Legacy Telemetry boolean 1177 histogram BLINK_FILESYSTEM_USED. 1178 labels: 1179 - "false" 1180 - "true" 1181 bugs: 1182 - https://bugzilla.mozilla.org/show_bug.cgi?id=1272501 1183 data_reviews: 1184 - https://bugzilla.mozilla.org/show_bug.cgi?id=1272501 1185 notification_emails: 1186 - amarchesini@mozilla.com 1187 expires: never 1188 telemetry_mirror: h#BLINK_FILESYSTEM_USED 1189 1190 webkit_directory_used: 1191 type: labeled_counter 1192 description: > 1193 HTMLInputElement.webkitdirectory attribute used 1194 1195 This metric was generated to correspond to the Legacy Telemetry boolean 1196 histogram WEBKIT_DIRECTORY_USED. 1197 labels: 1198 - "false" 1199 - "true" 1200 bugs: 1201 - https://bugzilla.mozilla.org/show_bug.cgi?id=1272501 1202 data_reviews: 1203 - https://bugzilla.mozilla.org/show_bug.cgi?id=1272501 1204 notification_emails: 1205 - amarchesini@mozilla.com 1206 expires: never 1207 telemetry_mirror: h#WEBKIT_DIRECTORY_USED