netwerk/metrics.yaml

   1 # This Source Code Form is subject to the terms of the Mozilla Public
   2 # License, v. 2.0. If a copy of the MPL was not distributed with this
   3 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
   4
   5 # Adding a new metric? We have docs for that!
   6 # https://firefox-source-docs.mozilla.org/toolkit/components/glean/user/new_definitions_file.html
   7
   8 ---
   9 $schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
  10 $tags:
  11   - 'Core :: Networking'
  12
  13 networking:
  14   speculative_connect_outcome:
  15     type: labeled_counter
  16     description: >
  17       Counts the occurrence of each outcome of a speculative connection
  18     bugs:
  19       - https://bugzilla.mozilla.org/show_bug.cgi?id=909865
  20     data_reviews:
  21       - https://bugzilla.mozilla.org/show_bug.cgi?id=909865
  22     data_sensitivity:
  23       - technical
  24     notification_emails:
  25       - necko@mozilla.com
  26       - acreskey@mozilla.com
  27     expires: never
  28     labels:
  29       - successful
  30       - aborted_socket_limit
  31       - aborted_socket_fail
  32       - aborted_https_not_enabled
  33     telemetry_mirror: NETWORKING_SPECULATIVE_CONNECT_OUTCOME
  34
  35   cookie_timestamp_fixed_count:
  36     type: labeled_counter
  37     description: >
  38       Counts the number of times a cookie's invalid timestamp was fixed when
  39       reading it from the DB.
  40     bugs:
  41       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828126
  42     data_reviews:
  43       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828126#c5
  44     data_sensitivity:
  45       - technical
  46     notification_emails:
  47       - necko@mozilla.com
  48       - vgosu@mozilla.com
  49     labels:
  50       - creationTime
  51       - lastAccessed
  52     expires: never
  53
  54   cookie_creation_fixup_diff:
  55     type: custom_distribution
  56     unit: second
  57     description: >
  58       If we fix up a cookie creation timestamp that is in the future this
  59       metric records the number of seconds that timestamp was off from NOW.
  60     bugs:
  61       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828126
  62     data_reviews:
  63       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828126#c5
  64     data_sensitivity:
  65       - technical
  66     notification_emails:
  67       - necko@mozilla.com
  68       - vgosu@mozilla.com
  69     expires: never
  70     range_min: 0
  71     range_max: 315360000000
  72     bucket_count: 100
  73     histogram_type: exponential
  74
  75   cookie_access_fixup_diff:
  76     type: custom_distribution
  77     unit: second
  78     description: >
  79       If we fix up a cookie lastAccessed timestamp that is in the future this
  80       metric records the number of seconds that timestamp was off from NOW.
  81     bugs:
  82       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828126
  83     data_reviews:
  84       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828126#c5
  85     data_sensitivity:
  86       - technical
  87     notification_emails:
  88       - necko@mozilla.com
  89       - vgosu@mozilla.com
  90     expires: never
  91     range_min: 0
  92     range_max: 315360000000
  93     bucket_count: 100
  94     histogram_type: exponential
  95
  96   cookie_count_total:
  97     type: custom_distribution
  98     description: >
  99       Reports the total number of cookies in storage
 100     range_min: 0
 101     range_max: 4000
 102     bucket_count: 22
 103     histogram_type: exponential
 104     unit: integer
 105     bugs:
 106       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942
 107       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 108       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 109     data_reviews:
 110       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942#TDB
 111       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 112       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 113     data_sensitivity:
 114       - technical
 115     notification_emails:
 116       - necko@mozilla.com
 117       - edgul@mozilla.com
 118     expires: 146
 119
 120   cookie_count_partitioned:
 121     type: custom_distribution
 122     description: >
 123       Reports the number of partitioned cookies in storage
 124     range_min: 0
 125     range_max: 4000
 126     bucket_count: 22
 127     histogram_type: exponential
 128     unit: integer
 129     bugs:
 130       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942
 131       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 132       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 133     data_reviews:
 134       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942#TDB
 135       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 136       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 137     data_sensitivity:
 138       - technical
 139     notification_emails:
 140       - necko@mozilla.com
 141       - edgul@mozilla.com
 142     expires: 146
 143
 144   cookie_count_unpartitioned:
 145     type: custom_distribution
 146     description: >
 147       Reports the number of unpartitioned cookies in storage
 148     range_min: 0
 149     range_max: 4000
 150     bucket_count: 22
 151     histogram_type: exponential
 152     unit: integer
 153     bugs:
 154       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942
 155       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 156       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 157     data_reviews:
 158       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942#TDB
 159       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 160       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 161     data_sensitivity:
 162       - technical
 163     notification_emails:
 164       - necko@mozilla.com
 165       - edgul@mozilla.com
 166     expires: 146
 167
 168   cookie_count_part_by_key:
 169     type: custom_distribution
 170     description: >
 171       A distribution of the partitioned cookies in storage belonging to
 172       a particular cookie key (host + origin attributes)
 173     range_min: 1
 174     range_max: 220
 175     bucket_count: 10
 176     histogram_type: exponential
 177     unit: integer
 178     bugs:
 179       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942
 180       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 181       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 182     data_reviews:
 183       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942#TDB
 184       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 185       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 186     data_sensitivity:
 187       - technical
 188     notification_emails:
 189       - necko@mozilla.com
 190       - edgul@mozilla.com
 191     expires: 146
 192
 193   cookie_count_unpart_by_key:
 194     type: custom_distribution
 195     description: >
 196       A distribution of the unpartitioned cookies in storage belonging to
 197       a particular cookie key (host + origin attributes)
 198     range_min: 1
 199     range_max: 220
 200     bucket_count: 10
 201     histogram_type: exponential
 202     unit: integer
 203     bugs:
 204       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942
 205       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 206       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 207     data_reviews:
 208       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942#TDB
 209       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 210       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 211     data_sensitivity:
 212       - technical
 213     notification_emails:
 214       - necko@mozilla.com
 215       - edgul@mozilla.com
 216     expires: 146
 217
 218   cookie_count_invalid_first_party_partitioned_in_db:
 219     type: counter
 220     description: >
 221       This counts the number of invalid first-party partitioned cookies that
 222       don't have the partitioned cookie attribution(CHIPS).
 223     bugs:
 224       - https://bugzilla.mozilla.org/1922193
 225     data_reviews:
 226       - https://bugzilla.mozilla.org/1922193
 227     notification_emails:
 228       - bvandersloot@mozilla.com
 229       - tihuang@mozilla.com
 230       - edgul@mozilla.com
 231     expires: 146
 232
 233   set_invalid_first_party_partitioned_cookie:
 234     type: counter
 235     description: >
 236       This counts the number of times we set an invalid first-party partitioned
 237       cookie.
 238     bugs:
 239       - https://bugzilla.mozilla.org/1922193
 240     data_reviews:
 241       - https://bugzilla.mozilla.org/1922193
 242     notification_emails:
 243       - bvandersloot@mozilla.com
 244       - tihuang@mozilla.com
 245       - edgul@mozilla.com
 246     expires: 146
 247
 248   cookie_purge_max:
 249     type: custom_distribution
 250     description: >
 251       A distribution of the number of cookies purged across
 252       all host + OAs as a result of exceeding the cookie maximum threshold
 253       (single purge)
 254     range_min: 1
 255     range_max: 4000
 256     bucket_count: 22
 257     histogram_type: exponential
 258     unit: integer
 259     bugs:
 260       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942
 261       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 262       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 263     data_reviews:
 264       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942#TDB
 265       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 266       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 267     data_sensitivity:
 268       - technical
 269     notification_emails:
 270       - necko@mozilla.com
 271       - edgul@mozilla.com
 272     expires: 146
 273
 274   cookie_purge_entry_max:
 275     type: custom_distribution
 276     description: >
 277       A distribution of the number of cookies purged for a single
 278       host + OA entry as a result of exceeding the maximum threshold
 279       for the given host + OA (single purge)
 280     range_min: 1
 281     range_max: 220
 282     bucket_count: 10
 283     histogram_type: exponential
 284     unit: integer
 285     bugs:
 286       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942
 287       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 288       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 289     data_reviews:
 290       - https://bugzilla.mozilla.org/show_bug.cgi?id=1828942#TDB
 291       - https://bugzilla.mozilla.org/show_bug.cgi?id=1892158
 292       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 293     data_sensitivity:
 294       - technical
 295     notification_emails:
 296       - necko@mozilla.com
 297       - edgul@mozilla.com
 298     expires: 146
 299
 300   cookie_chips_partition_limit_overflow:
 301     type: custom_distribution
 302     description: >
 303       The number of cookie bytes exceeding chips partition limit capacity for a single partition
 304     range_min: 0
 305     range_max: 16000000
 306     bucket_count: 22
 307     histogram_type: exponential
 308     unit: integer
 309     bugs:
 310       - https://bugzilla.mozilla.org/show_bug.cgi?id=1878391
 311       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 312     data_reviews:
 313       - https://bugzilla.mozilla.org/show_bug.cgi?id=1878391
 314       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922606
 315     data_sensitivity:
 316       - technical
 317     notification_emails:
 318       - necko@mozilla.com
 319       - edgul@mozilla.com
 320     expires: 146
 321
 322   sqlite_cookies_block_main_thread:
 323     type: timing_distribution
 324     time_unit: millisecond
 325     description: >
 326       Time spent on blocking main thread by startup cookie database read (in milliseconds), only for blocking case
 327     bugs:
 328       - https://bugzilla.mozilla.org/show_bug.cgi?id=870460
 329     data_reviews:
 330       - https://bugzilla.mozilla.org/show_bug.cgi?id=870460
 331     notification_emails:
 332       - necko@mozilla.com
 333     expires: never
 334     telemetry_mirror: MOZ_SQLITE_COOKIES_BLOCK_MAIN_THREAD_MS_V2
 335
 336   sqlite_cookies_time_to_block_main_thread:
 337     type: timing_distribution
 338     time_unit: millisecond
 339     description: >
 340       How long (in milliseconds) after we finished reading the cookie db until the first cookie request came in (0 implies we blocked the main thread)
 341     bugs:
 342       - https://bugzilla.mozilla.org/show_bug.cgi?id=1413839
 343     data_reviews:
 344       - https://bugzilla.mozilla.org/show_bug.cgi?id=1413839
 345     notification_emails:
 346       - necko@mozilla.com
 347     expires: never
 348     telemetry_mirror: MOZ_SQLITE_COOKIES_TIME_TO_BLOCK_MAIN_THREAD_MS
 349
 350   set_cookie:
 351     type: counter
 352     description: >
 353       This counts the number of times we set a cookie. Introduced
 354       as a denomenator for measuring CHIPS adoption.
 355     bugs:
 356       - https://bugzilla.mozilla.org/1865199
 357       - https://bugzilla.mozilla.org/show_bug.cgi?id=1912184
 358     data_reviews:
 359       - https://bugzilla.mozilla.org/show_bug.cgi?id=1865199#c3
 360       - https://bugzilla.mozilla.org/show_bug.cgi?id=1912184#c7
 361     notification_emails:
 362       - bvandersloot@mozilla.com
 363     expires: 138
 364
 365   set_cookie_foreign:
 366     type: rate
 367     description: >
 368       This counts the number of times we set a cookie from a foreign (not
 369       same-site) context. Introduced as a denomenator for measuring CHIPS
 370       adoption.
 371     bugs:
 372       - https://bugzilla.mozilla.org/1865199
 373       - https://bugzilla.mozilla.org/show_bug.cgi?id=1912184
 374     data_reviews:
 375       - https://bugzilla.mozilla.org/show_bug.cgi?id=1865199#c3
 376       - https://bugzilla.mozilla.org/show_bug.cgi?id=1912184#c7
 377     notification_emails:
 378       - bvandersloot@mozilla.com
 379     expires: 138
 380     denominator_metric: networking.set_cookie
 381
 382   set_cookie_partitioned:
 383     type: rate
 384     description: >
 385       This counts the number of times we set a cookie that has the Partitioned
 386       attribute. This tracks the adoption of CHIPS.
 387     bugs:
 388       - https://bugzilla.mozilla.org/1865199
 389       - https://bugzilla.mozilla.org/show_bug.cgi?id=1912184
 390     data_reviews:
 391       - https://bugzilla.mozilla.org/show_bug.cgi?id=1865199#c3
 392       - https://bugzilla.mozilla.org/show_bug.cgi?id=1912184#c7
 393     notification_emails:
 394       - bvandersloot@mozilla.com
 395     expires: 138
 396     denominator_metric: networking.set_cookie
 397
 398   set_cookie_foreign_partitioned:
 399     type: rate
 400     description: >
 401       This counts the number of times we set a cookie that has the Partitioned
 402       attribute in a foreign (not same-site) context. This tracks the adoption
 403       of CHIPS.
 404     bugs:
 405       - https://bugzilla.mozilla.org/1865199
 406       - https://bugzilla.mozilla.org/show_bug.cgi?id=1912184
 407     data_reviews:
 408       - https://bugzilla.mozilla.org/show_bug.cgi?id=1865199#c3
 409       - https://bugzilla.mozilla.org/show_bug.cgi?id=1912184#c7
 410     notification_emails:
 411       - bvandersloot@mozilla.com
 412     expires: 138
 413     denominator_metric: networking.set_cookie
 414
 415   set_cookie_expired_without_server_time:
 416     type: rate
 417     description: >
 418       This counts the number of times a cookie is set already expires but it
 419       would not if we considered the server time.
 420     bugs:
 421       - https://bugzilla.mozilla.org/1909980
 422       - https://bugzilla.mozilla.org/1916532
 423     data_reviews:
 424       - https://bugzilla.mozilla.org/show_bug.cgi?id=1909980#c7
 425       - https://bugzilla.mozilla.org/show_bug.cgi?id=1916532#c7
 426     notification_emails:
 427       - baku@mozilla.com
 428     expires: 138
 429     denominator_metric: networking.set_cookie
 430
 431   dns_lookup_time:
 432     type: timing_distribution
 433     time_unit: millisecond
 434     description: >
 435       Time for a successful DNS resolution (msec) |
 436       Migrated from Firefox Telemetry's `DNS_LOOKUP_TIME`.
 437     bugs:
 438       - https://bugzilla.mozilla.org/show_bug.cgi?id=1838240
 439     data_reviews:
 440       - https://bugzilla.mozilla.org/show_bug.cgi?id=1838240#c6
 441     data_sensitivity:
 442       - technical
 443     notification_emails:
 444       - necko@mozilla.com
 445       - acreskey@mozilla.com
 446     expires: never
 447     telemetry_mirror: DNS_LOOKUP_TIME
 448
 449   trr_fetch_duration:
 450     type: labeled_timing_distribution
 451     time_unit: millisecond
 452     description: >
 453       Time for a successful DoH request, from AsyncOpen to ReturnData
 454     bugs:
 455       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922235
 456     data_reviews:
 457       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922235
 458     notification_emails:
 459       - necko@mozilla.com
 460     labels:
 461       - h1
 462       - h1_network_only
 463       - h2
 464       - h2_network_only
 465       - h3
 466       - h3_network_only
 467     expires: never
 468
 469   trr_dns_start: &trr_dns_start
 470     type: labeled_timing_distribution
 471     time_unit: millisecond
 472     description: >
 473       In TRR channel, time from connection open to the DNS request
 474       being issued.
 475     bugs:
 476       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922238
 477     data_reviews:
 478       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922238
 479     notification_emails:
 480       - necko@mozilla.com
 481       - kershaw@mozilla.com
 482     labels:
 483       - mozilla.cloudflare-dns.com
 484       - firefox.dns.nextdns.io
 485       - private.canadianshield.cira.ca
 486       - doh.xfinity.com
 487       - dns.shaw.ca
 488       - dooh.cloudflare-dns.com
 489       - mozilla.cloudflare-dns.com_2
 490       - firefox.dns.nextdns.io_2
 491       - private.canadianshield.cira.ca_2
 492       - doh.xfinity.com_2
 493       - dns.shaw.ca_2
 494       - dooh.cloudflare-dns.com_2
 495       - mozilla.cloudflare-dns.com_3
 496       - firefox.dns.nextdns.io_3
 497       - private.canadianshield.cira.ca_3
 498       - doh.xfinity.com_3
 499       - dns.shaw.ca_3
 500       - dooh.cloudflare-dns.com_3
 501     expires: never
 502
 503   trr_dns_end:
 504     <<: *trr_dns_start
 505     description: >
 506       In TRR channel, time from the DNS request being issued to
 507       the response.
 508     expires: never
 509
 510   trr_tcp_connection:
 511     <<: *trr_dns_start
 512     description: >
 513       In TRR channel, time from the TCP SYN packet is received to
 514       the connection is established and ready for HTTP.
 515     expires: never
 516
 517   trr_tls_handshake:
 518     <<: *trr_dns_start
 519     description: >
 520       In TRR channel, time from after the TCP SYN packet is
 521       received to the secure connection is established and ready for HTTP.
 522     expires: never
 523
 524   trr_open_to_first_sent:
 525     <<: *trr_dns_start
 526     description: >
 527       In TRR channel, time from open to first byte of request.
 528     expires: never
 529
 530   trr_first_sent_to_last_received:
 531     <<: *trr_dns_start
 532     description: >
 533       In TRR channel, time from first byte of request sent to
 534       last byte of response received.
 535     expires: never
 536
 537   trr_open_to_first_received:
 538     <<: *trr_dns_start
 539     description: >
 540       In TRR channel, time from open to first byte of reply received.
 541     expires: never
 542
 543   trr_complete_load:
 544     <<: *trr_dns_start
 545     description: >
 546       In TRR channel, overall load time.
 547     expires: never
 548
 549   dns_renewal_time:
 550     type: timing_distribution
 551     time_unit: millisecond
 552     description: >
 553       Time for a renewed DNS OS resolution (msec) |
 554       Migrated from Firefox Telemetry's `DNS_RENEWAL_TIME`.
 555     bugs:
 556       - https://bugzilla.mozilla.org/show_bug.cgi?id=1838240
 557     data_reviews:
 558       - https://bugzilla.mozilla.org/show_bug.cgi?id=1838240#c6
 559     data_sensitivity:
 560       - technical
 561     notification_emails:
 562       - necko@mozilla.com
 563       - acreskey@mozilla.com
 564     expires: never
 565     telemetry_mirror: DNS_RENEWAL_TIME
 566
 567   dns_renewal_time_for_ttl:
 568     type: timing_distribution
 569     time_unit: millisecond
 570     description: >
 571       Time for a DNS OS resolution (msec) used to get TTL |
 572       Migrated from Firefox Telemetry's `DNS_RENEWAL_TIME_FOR_TTL`.
 573     bugs:
 574       - https://bugzilla.mozilla.org/show_bug.cgi?id=1838240
 575     data_reviews:
 576       - https://bugzilla.mozilla.org/show_bug.cgi?id=1838240#c6
 577     data_sensitivity:
 578       - technical
 579     notification_emails:
 580       - necko@mozilla.com
 581       - acreskey@mozilla.com
 582     expires: never
 583     telemetry_mirror: DNS_RENEWAL_TIME_FOR_TTL
 584
 585   dns_failed_lookup_time:
 586     type: timing_distribution
 587     time_unit: millisecond
 588     description: >
 589       Time for an unsuccessful DNS OS resolution (msec) |
 590       Migrated from Firefox Telemetry's `DNS_FAILED_LOOKUP_TIME`.
 591     bugs:
 592       - https://bugzilla.mozilla.org/show_bug.cgi?id=1838240
 593     data_reviews:
 594       - https://bugzilla.mozilla.org/show_bug.cgi?id=1838240#c6
 595     data_sensitivity:
 596       - technical
 597     notification_emails:
 598       - necko@mozilla.com
 599       - acreskey@mozilla.com
 600     expires: never
 601     telemetry_mirror: DNS_FAILED_LOOKUP_TIME
 602
 603   dns_native_https_call_time:
 604     type: timing_distribution
 605     time_unit: millisecond
 606     description: >
 607       Time spent in the call to the native OS DNS resolution.
 608     bugs:
 609       - https://bugzilla.mozilla.org/show_bug.cgi?id=1885529
 610     data_reviews:
 611       - https://bugzilla.mozilla.org/show_bug.cgi?id=1885529
 612     data_sensitivity:
 613       - technical
 614     notification_emails:
 615       - necko@mozilla.com
 616       - vgosu@mozilla.com
 617     expires: never
 618
 619   dns_native_count:
 620     type: labeled_counter
 621     description: >
 622       The count of calls to the native DNS APIs
 623     bugs:
 624       - https://bugzilla.mozilla.org/show_bug.cgi?id=1879165
 625     data_reviews:
 626       - https://bugzilla.mozilla.org/show_bug.cgi?id=1879165
 627     data_sensitivity:
 628       - technical
 629     notification_emails:
 630       - vgosu@mozilla.com
 631       - necko@mozilla.com
 632     expires: 140
 633     labels:
 634       - regular
 635       - private
 636       - https_regular
 637       - https_private
 638
 639   fetch_keepalive_discard_count:
 640     type: labeled_counter
 641     description: >
 642       Counts how many fetch keepalive requests are dropped due to configured
 643       resource limits.
 644     bugs:
 645       - https://bugzilla.mozilla.org/show_bug.cgi?id=1873551
 646     data_reviews:
 647       - https://bugzilla.mozilla.org/show_bug.cgi?id=1873551
 648     notification_emails:
 649       - smayya@mozilla.com
 650     expires: 138
 651     labels:
 652       - total_keepalive_limit
 653       - per_origin_limit
 654
 655   fetch_keepalive_request_count:
 656     type: labeled_counter
 657     description: >
 658       Counts how many fetch keepalive requests are made. This counter helps us to
 659       understand the adoption of fetch keepalive for firefox.
 660     bugs:
 661       - https://bugzilla.mozilla.org/show_bug.cgi?id=1873551
 662     data_reviews:
 663       - https://bugzilla.mozilla.org/show_bug.cgi?id=1873551
 664     notification_emails:
 665       - smayya@mozilla.com
 666     expires: 138
 667     labels:
 668       - worker
 669       - main
 670
 671   http_content_onstart_delay:
 672     type: timing_distribution
 673     time_unit: millisecond
 674     description: >
 675       The time between dispatching OnStartRequest from the socket thread and processing it on the main thread (content process).
 676     bugs:
 677       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857926
 678       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 679     data_reviews:
 680       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857926#c
 681       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 682     data_sensitivity:
 683       - technical
 684     notification_emails:
 685       - necko@mozilla.com
 686       - rjesup@mozilla.com
 687     expires: 146
 688
 689   http_content_onstop_delay:
 690     type: timing_distribution
 691     time_unit: millisecond
 692     description: >
 693       The time between dispatching OnStopRequest from the socket thread and processing it on the main thread (content process).
 694     bugs:
 695       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857926
 696       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 697     data_reviews:
 698       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857926#c
 699       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 700     data_sensitivity:
 701       - technical
 702     notification_emails:
 703       - necko@mozilla.com
 704       - rjesup@mozilla.com
 705     expires: 146
 706
 707   http_content_ondatafinished_delay:
 708     type: timing_distribution
 709     time_unit: millisecond
 710     description: >
 711       The time between dispatching OnDataFinished from the socket thread and processing
 712       it on main/background thread.
 713     bugs:
 714       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857615
 715       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 716     data_reviews:
 717       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857615#c
 718       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 719     data_sensitivity:
 720       - technical
 721     notification_emails:
 722       - necko@mozilla.com
 723       - rjesup@mozilla.com
 724     expires: 146
 725
 726   http_content_ondatafinished_delay_2:
 727     type: timing_distribution
 728     time_unit: millisecond
 729     description: >
 730       The time between dispatching OnDataFinished from the socket thread and processing it
 731       on the background thread.
 732     bugs:
 733       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857615
 734       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 735       - https://bugzilla.mozilla.org/show_bug.cgi?id=1913140
 736     data_reviews:
 737       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857615#c
 738       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 739     data_sensitivity:
 740       - technical
 741     notification_emails:
 742       - necko@mozilla.com
 743       - jesup@mozilla.com
 744     expires: 146
 745
 746   http_content_ondatafinished_to_onstop_delay:
 747     type: timing_distribution
 748     time_unit: millisecond
 749     description: >
 750       The time between processing OnDataFinished and processing OnStopRequest (if OnDataFinished comes first)
 751     bugs:
 752       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857615
 753       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 754     data_reviews:
 755       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857615#c
 756       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 757     data_sensitivity:
 758       - technical
 759     notification_emails:
 760       - necko@mozilla.com
 761       - rjesup@mozilla.com
 762     expires: 146
 763
 764   http_content_html5parser_ondatafinished_to_onstop_delay:
 765     type: timing_distribution
 766     time_unit: millisecond
 767     description: >
 768       The time between processing OnDataFinished and processing OnStopRequest (if OnDataFinished comes first)
 769     bugs:
 770       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857926
 771       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 772     data_reviews:
 773       - https://bugzilla.mozilla.org/show_bug.cgi?id=1857926
 774       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902188
 775     data_sensitivity:
 776       - technical
 777     notification_emails:
 778       - necko@mozilla.com
 779       - rjesup@mozilla.com
 780     expires: 146
 781
 782   http_content_cssloader_ondatafinished_to_onstop_delay:
 783     type: timing_distribution
 784     time_unit: millisecond
 785     description: >
 786       The time between processing OnDataFinished and processing OnStopRequest for CSSLoader in the content process
 787     bugs:
 788       - https://bugzilla.mozilla.org/show_bug.cgi?id=1883391
 789       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902186
 790     data_reviews:
 791       - https://bugzilla.mozilla.org/show_bug.cgi?id=1883391
 792     data_sensitivity:
 793       - technical
 794     notification_emails:
 795       - necko@mozilla.com
 796     expires: 146
 797
 798   http_ip_addr_any_count:
 799     type: labeled_counter
 800     description: >
 801       The number of times we see the IP address 0.0.0.0 or its IPv6 equivalent.
 802     bugs:
 803     - https://bugzilla.mozilla.org/show_bug.cgi?id=1914583
 804     data_reviews:
 805     - https://bugzilla.mozilla.org/show_bug.cgi?id=1914583
 806     data_sensitivity:
 807     - technical
 808     notification_emails:
 809     - necko@mozilla.com
 810     expires: 138
 811     labels:
 812     - not_blocked_requests
 813     - blocked_requests
 814
 815   http_ip_addr_any_hostnames:
 816     type: labeled_counter
 817     description: >
 818         The number of times we see the IP address 0.0.0.0 or its IPv6 equivalent used as hostnames
 819     bugs:
 820     - https://bugzilla.mozilla.org/show_bug.cgi?id=1937743
 821     data_reviews:
 822     - https://bugzilla.mozilla.org/show_bug.cgi?id=1937743
 823     data_sensitivity:
 824     - technical
 825     notification_emails:
 826     - necko@mozilla.com
 827     expires: 138
 828     labels:
 829     - success
 830     - failure
 831
 832   http_onstart_suspend_total_time:
 833     type: timing_distribution
 834     time_unit: millisecond
 835     telemetry_mirror: HTTP_ONSTART_SUSPEND_TOTAL_TIME
 836     description: >
 837       Time in milliseconds that http channel spent suspended between AsyncOpen and OnStartRequest.
 838     bugs:
 839       - https://bugzilla.mozilla.org/show_bug.cgi?id=1897209
 840       - https://bugzilla.mozilla.org/show_bug.cgi?id=1347948
 841     data_reviews:
 842       - https://bugzilla.mozilla.org/show_bug.cgi?id=1897209
 843     notification_emails:
 844       - necko@mozilla.com
 845     expires: never
 846
 847   http_1_download_throughput:
 848     type: custom_distribution
 849     unit: mbps
 850     range_min: 0
 851     range_max: 10000
 852     bucket_count: 100
 853     histogram_type: exponential
 854     description: >
 855      The download throughput for  http/1.0, http/1.1 requests larger than 10MB. Measured in megabits per second, Mbps.
 856     bugs:
 857       - https://bugzilla.mozilla.org/show_bug.cgi?id=1846798
 858     data_reviews:
 859       - https://bugzilla.mozilla.org/show_bug.cgi?id=1846798#c2
 860     data_sensitivity:
 861       - technical
 862     notification_emails:
 863       - necko@mozilla.com
 864       - acreskey@mozilla.com
 865     expires: never
 866     telemetry_mirror: NETWORKING_DOWNLOAD_THROUGHPUT_HTTP_1
 867
 868   http_1_download_throughput_10_50: &http_1_download_throughput_10_50
 869     type: custom_distribution
 870     unit: mbps
 871     range_min: 0
 872     range_max: 10000
 873     bucket_count: 100
 874     histogram_type: exponential
 875     description: >
 876      The download throughput for http/1.0 and http/1.1 requests between 10MB and 50MB. Measured in megabits per second, Mbps.
 877     bugs:
 878       - https://bugzilla.mozilla.org/show_bug.cgi?id=1909931
 879     data_reviews:
 880       - https://bugzilla.mozilla.org/show_bug.cgi?id=1909931
 881     data_sensitivity:
 882       - technical
 883     notification_emails:
 884       - necko@mozilla.com
 885     expires: never
 886
 887   http_1_download_throughput_50_100:
 888     <<: *http_1_download_throughput_10_50
 889     description: >
 890      The download throughput for http/1.0 and http/1.1 requests between 50MB and 100MB. Measured in megabits per second, Mbps.
 891
 892   http_1_download_throughput_100:
 893     <<: *http_1_download_throughput_10_50
 894     description: >
 895      The download throughput for http/1.0 and http/1.1 requests size larger than 100MB. Measured in megabits per second, Mbps.
 896
 897   http_2_download_throughput:
 898     type: custom_distribution
 899     unit: mbps
 900     range_min: 0
 901     range_max: 10000
 902     bucket_count: 100
 903     histogram_type: exponential
 904     description: >
 905      The download throughput for http/2 requests larger than 10MB. Measured in megabits per second, Mbps.
 906     bugs:
 907       - https://bugzilla.mozilla.org/show_bug.cgi?id=1846798
 908     data_reviews:
 909       - https://bugzilla.mozilla.org/show_bug.cgi?id=1846798#c2
 910     data_sensitivity:
 911       - technical
 912     notification_emails:
 913       - necko@mozilla.com
 914       - acreskey@mozilla.com
 915     expires: never
 916     telemetry_mirror: NETWORKING_DOWNLOAD_THROUGHPUT_HTTP_2
 917
 918   http_2_download_throughput_10_50: &http_2_download_throughput_10_50
 919     type: custom_distribution
 920     unit: mbps
 921     range_min: 0
 922     range_max: 10000
 923     bucket_count: 100
 924     histogram_type: exponential
 925     description: >
 926      The download throughput for http/2 requests between 10MB and 50MB. Measured in megabits per second, Mbps.
 927     bugs:
 928       - https://bugzilla.mozilla.org/show_bug.cgi?id=1909931
 929     data_reviews:
 930       - https://bugzilla.mozilla.org/show_bug.cgi?id=1909931
 931     data_sensitivity:
 932       - technical
 933     notification_emails:
 934       - necko@mozilla.com
 935     expires: never
 936
 937   http_2_download_throughput_50_100:
 938     <<: *http_2_download_throughput_10_50
 939     description: >
 940      The download throughput for http/2 requests between 50MB and 100MB. Measured in megabits per second, Mbps.
 941
 942   http_2_download_throughput_100:
 943     <<: *http_2_download_throughput_10_50
 944     description: >
 945      The download throughput for http/2 requests size larger than 100MB. Measured in megabits per second, Mbps.
 946
 947   http_3_download_throughput:
 948     type: custom_distribution
 949     unit: mbps
 950     range_min: 0
 951     range_max: 10000
 952     bucket_count: 100
 953     histogram_type: exponential
 954     description: >
 955      The download throughput for http/3 requests larger than 10MB. Measured in megabits per second, Mbps.
 956     bugs:
 957       - https://bugzilla.mozilla.org/show_bug.cgi?id=1846798
 958     data_reviews:
 959       - https://bugzilla.mozilla.org/show_bug.cgi?id=1846798#c2
 960     data_sensitivity:
 961       - technical
 962     notification_emails:
 963       - necko@mozilla.com
 964       - acreskey@mozilla.com
 965     expires: never
 966     telemetry_mirror: NETWORKING_DOWNLOAD_THROUGHPUT_HTTP_3
 967
 968   http_3_download_throughput_10_50: &http_3_download_throughput_10_50
 969     type: custom_distribution
 970     unit: mbps
 971     range_min: 0
 972     range_max: 10000
 973     bucket_count: 100
 974     histogram_type: exponential
 975     description: >
 976      The download throughput for http/3 requests between 10MB and 50MB. Measured in megabits per second, Mbps.
 977     bugs:
 978       - https://bugzilla.mozilla.org/show_bug.cgi?id=1909663
 979     data_reviews:
 980       - https://bugzilla.mozilla.org/show_bug.cgi?id=1909663
 981     data_sensitivity:
 982       - technical
 983     notification_emails:
 984       - necko@mozilla.com
 985     expires: never
 986
 987   http_3_download_throughput_50_100:
 988     <<: *http_3_download_throughput_10_50
 989     description: >
 990      The download throughput for http/3 requests between 50MB and 100MB. Measured in megabits per second, Mbps.
 991
 992   http_3_download_throughput_100:
 993     <<: *http_3_download_throughput_10_50
 994     description: >
 995      The download throughput for http/3 requests size larger than 100MB. Measured in megabits per second, Mbps.
 996
 997   http_1_upload_throughput:
 998     type: custom_distribution
 999     unit: mbps
1000     range_min: 0
1001     range_max: 5000
1002     bucket_count: 100
1003     histogram_type: exponential
1004     description: >
1005      The upload throughput for http/1.0, http/1.1 requests larger than 10MB. Measured in megabits per second, Mbps.
1006     bugs:
1007       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256
1008     data_reviews:
1009       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1010     data_sensitivity:
1011       - technical
1012     notification_emails:
1013       - necko@mozilla.com
1014       - acreskey@mozilla.com
1015     expires: never
1016     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_1
1017
1018   http_2_upload_throughput:
1019     type: custom_distribution
1020     unit: mbps
1021     range_min: 0
1022     range_max: 5000
1023     bucket_count: 100
1024     histogram_type: exponential
1025     description: >
1026      The upload throughput for http/2 requests larger than 10MB. Measured in megabits per second, Mbps.
1027     bugs:
1028       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256
1029     data_reviews:
1030       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1031     data_sensitivity:
1032       - technical
1033     notification_emails:
1034       - necko@mozilla.com
1035       - acreskey@mozilla.com
1036     expires: never
1037     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_2
1038
1039   http_3_upload_throughput:
1040     type: custom_distribution
1041     unit: mbps
1042     range_min: 0
1043     range_max: 5000
1044     bucket_count: 100
1045     histogram_type: exponential
1046     description: >
1047      The upload throughput for http/3 requests larger than 10MB. Measured in megabits per second, Mbps.
1048     bugs:
1049       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256
1050     data_reviews:
1051       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1052     data_sensitivity:
1053       - technical
1054     notification_emails:
1055       - necko@mozilla.com
1056       - acreskey@mozilla.com
1057     expires: never
1058     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_3
1059
1060   http_1_upload_throughput_10_50:
1061     type: custom_distribution
1062     unit: mbps
1063     range_min: 0
1064     range_max: 5000
1065     bucket_count: 100
1066     histogram_type: exponential
1067     description: >
1068      The upload throughput for http/1.0, http/1.1 request size between 10MB and 50MB. Measured in megabits per second, Mbps.
1069     bugs:
1070       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866739
1071     data_reviews:
1072       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1073     data_sensitivity:
1074       - technical
1075     notification_emails:
1076       - necko@mozilla.com
1077       - kershaw@mozilla.com
1078     expires: never
1079     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_1_10_50
1080
1081   http_1_upload_throughput_50_100:
1082     type: custom_distribution
1083     unit: mbps
1084     range_min: 0
1085     range_max: 5000
1086     bucket_count: 100
1087     histogram_type: exponential
1088     description: >
1089      The upload throughput for http/1.0, http/1.1 request size between 50MB and 100MB. Measured in megabits per second, Mbps.
1090     bugs:
1091       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866739
1092     data_reviews:
1093       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1094     data_sensitivity:
1095       - technical
1096     notification_emails:
1097       - necko@mozilla.com
1098       - kershaw@mozilla.com
1099     expires: never
1100     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_1_50_100
1101
1102   http_1_upload_throughput_100:
1103     type: custom_distribution
1104     unit: mbps
1105     range_min: 0
1106     range_max: 5000
1107     bucket_count: 100
1108     histogram_type: exponential
1109     description: >
1110      The upload throughput for http/1.0, http/1.1 request size larger than 100MB. Measured in megabits per second, Mbps.
1111     bugs:
1112       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866739
1113     data_reviews:
1114       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1115     data_sensitivity:
1116       - technical
1117     notification_emails:
1118       - necko@mozilla.com
1119       - kershaw@mozilla.com
1120     expires: never
1121     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_1_100
1122
1123   http_2_upload_throughput_10_50:
1124     type: custom_distribution
1125     unit: mbps
1126     range_min: 0
1127     range_max: 5000
1128     bucket_count: 100
1129     histogram_type: exponential
1130     description: >
1131      The upload throughput for http/2 request size between 10MB and 50MB. Measured in megabits per second, Mbps.
1132     bugs:
1133       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866739
1134     data_reviews:
1135       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1136     data_sensitivity:
1137       - technical
1138     notification_emails:
1139       - necko@mozilla.com
1140       - kershaw@mozilla.com
1141     expires: never
1142     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_2_10_50
1143
1144   http_2_upload_throughput_50_100:
1145     type: custom_distribution
1146     unit: mbps
1147     range_min: 0
1148     range_max: 5000
1149     bucket_count: 100
1150     histogram_type: exponential
1151     description: >
1152      The upload throughput for http/2 request size between 50MB and 100MB. Measured in megabits per second, Mbps.
1153     bugs:
1154       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866739
1155     data_reviews:
1156       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1157     data_sensitivity:
1158       - technical
1159     notification_emails:
1160       - necko@mozilla.com
1161       - kershaw@mozilla.com
1162     expires: never
1163     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_2_50_100
1164
1165   http_2_upload_throughput_100:
1166     type: custom_distribution
1167     unit: mbps
1168     range_min: 0
1169     range_max: 5000
1170     bucket_count: 100
1171     histogram_type: exponential
1172     description: >
1173      The upload throughput for http/2 request size larger than 100MB. Measured in megabits per second, Mbps.
1174     bugs:
1175       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866739
1176     data_reviews:
1177       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1178     data_sensitivity:
1179       - technical
1180     notification_emails:
1181       - necko@mozilla.com
1182       - kershaw@mozilla.com
1183     expires: never
1184     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_2_100
1185
1186   http_3_upload_throughput_10_50:
1187     type: custom_distribution
1188     unit: mbps
1189     range_min: 0
1190     range_max: 5000
1191     bucket_count: 100
1192     histogram_type: exponential
1193     description: >
1194      The upload throughput for http/3 request size between 10MB and 50MB. Measured in megabits per second, Mbps.
1195     bugs:
1196       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866739
1197     data_reviews:
1198       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1199     data_sensitivity:
1200       - technical
1201     notification_emails:
1202       - necko@mozilla.com
1203       - kershaw@mozilla.com
1204     expires: never
1205     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_3_10_50
1206
1207   http_3_upload_throughput_50_100:
1208     type: custom_distribution
1209     unit: mbps
1210     range_min: 0
1211     range_max: 5000
1212     bucket_count: 100
1213     histogram_type: exponential
1214     description: >
1215      The upload throughput for http/3 request size between 50MB and 100MB. Measured in megabits per second, Mbps.
1216     bugs:
1217       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866739
1218     data_reviews:
1219       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1220     data_sensitivity:
1221       - technical
1222     notification_emails:
1223       - necko@mozilla.com
1224       - kershaw@mozilla.com
1225     expires: never
1226     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_3_50_100
1227
1228   http_3_upload_throughput_100:
1229     type: custom_distribution
1230     unit: mbps
1231     range_min: 0
1232     range_max: 5000
1233     bucket_count: 100
1234     histogram_type: exponential
1235     description: >
1236      The upload throughput for http/3 request size larger than 100MB. Measured in megabits per second, Mbps.
1237     bugs:
1238       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866739
1239     data_reviews:
1240       - https://bugzilla.mozilla.org/show_bug.cgi?id=1858256#c2
1241     data_sensitivity:
1242       - technical
1243     notification_emails:
1244       - necko@mozilla.com
1245       - kershaw@mozilla.com
1246     expires: never
1247     telemetry_mirror: HTTP_UPLOAD_THROUGHPUT_MBPS_HTTP_3_100
1248
1249   http_3_ecn_ce_ect0_ratio_sent: &http_3_ecn_ce_ect0_ratio_sent
1250     type: custom_distribution
1251     unit: integer
1252     range_min: 0
1253     range_max: 2000
1254     bucket_count: 100
1255     histogram_type: exponential
1256     description: >
1257       HTTP3: ECN CE to ECT0 ratio (multiply by 10000) sent.
1258     bugs:
1259       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902065
1260     data_reviews:
1261       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902065
1262     data_sensitivity:
1263       - technical
1264     notification_emails:
1265       - necko@mozilla.com
1266       - minden@mozilla.com
1267     expires: never
1268
1269   http_3_ecn_ce_ect0_ratio_received:
1270     <<: *http_3_ecn_ce_ect0_ratio_sent
1271     description: >
1272       HTTP3: ECN CE to ECT0 ratio (multiply by 10000) received.
1273
1274   http_3_ecn_path_capability:
1275     type: labeled_counter
1276     description: >
1277       Number of paths known to be ECN capable or not-capable.
1278     bugs:
1279       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902065
1280     data_reviews:
1281       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902065
1282     data_sensitivity:
1283       - technical
1284     notification_emails:
1285       - necko@mozilla.com
1286       - minden@mozilla.com
1287     expires: never
1288     labels:
1289       - capable
1290       - not-capable
1291
1292   http_3_loss_ratio:
1293     type: custom_distribution
1294     unit: integer
1295     range_min: 0
1296     range_max: 2000
1297     bucket_count: 100
1298     histogram_type: exponential
1299     description: >
1300       HTTP3: packet loss ratio (multiply by 10000).
1301     bugs:
1302       - https://bugzilla.mozilla.org/show_bug.cgi?id=1917778
1303     data_reviews:
1304       - https://bugzilla.mozilla.org/show_bug.cgi?id=1917778
1305     data_sensitivity:
1306       - technical
1307     notification_emails:
1308       - necko@mozilla.com
1309       - minden@mozilla.com
1310     expires: never
1311
1312   http_3_connection_close_reason:
1313     type: labeled_counter
1314     description: >
1315       Number of HTTP3 connections closed, labeled by reason.
1316     bugs:
1317       - https://bugzilla.mozilla.org/show_bug.cgi?id=1926258
1318     data_reviews:
1319       - https://bugzilla.mozilla.org/show_bug.cgi?id=1926258
1320     data_sensitivity:
1321       - technical
1322     notification_emails:
1323       - necko@mozilla.com
1324       - minden@mozilla.com
1325     expires: never
1326     labels:
1327       # neqo_transport::CloseReason::Application
1328       - Application
1329       # neqo_transport::CloseReason::Transport
1330       - NoError
1331       - InternalError
1332       - ConnectionRefused
1333       - FlowControlError
1334       - StreamLimitError
1335       - StreamStateError
1336       - FinalSizeError
1337       - FrameEncodingError
1338       - TransportParameterError
1339       - ProtocolViolation
1340       - InvalidToken
1341       - ApplicationError
1342       - CryptoBufferExceeded
1343       - CryptoError
1344       - QlogError
1345       - CryptoAlert
1346       - EchRetry
1347       - AckedUnsentPacket
1348       - ConnectionIdLimitExceeded
1349       - ConnectionIdsExhausted
1350       - ConnectionState
1351       - DecodingFrame
1352       - DecryptError
1353       - DisabledVersion
1354       - IdleTimeout
1355       - IntegerOverflow
1356       - InvalidInput
1357       - InvalidMigration
1358       - InvalidPacket
1359       - InvalidResumptionToken
1360       - InvalidRetry
1361       - InvalidStreamId
1362       - KeysDiscarded
1363       - KeysExhausted
1364       - KeysPending
1365       - KeyUpdateBlocked
1366       - NoAvailablePath
1367       - NoMoreData
1368       - NotAvailable
1369       - NotConnected
1370       - PacketNumberOverlap
1371       - PeerApplicationError
1372       - PeerError
1373       - StatelessReset
1374       - TooMuchData
1375       - UnexpectedMessage
1376       - UnknownConnectionId
1377       - UnknownFrameType
1378       - VersionNegotiation
1379       - WrongRole
1380
1381   http_3_quic_frame_count:
1382     type: labeled_counter
1383     description: >
1384       Number of QUIC frames send and received by type.
1385     bugs:
1386       - https://bugzilla.mozilla.org/show_bug.cgi?id=1929818
1387     data_reviews:
1388       - https://bugzilla.mozilla.org/show_bug.cgi?id=1929818
1389     data_sensitivity:
1390       - technical
1391     notification_emails:
1392       - necko@mozilla.com
1393       - minden@mozilla.com
1394     expires: never
1395     labels:
1396       - ack_tx
1397       - ack_rx
1398       - crypto_tx
1399       - crypto_rx
1400       - stream_tx
1401       - stream_rx
1402       - reset_stream_tx
1403       - reset_stream_rx
1404       - stop_sending_tx
1405       - stop_sending_rx
1406       - ping_tx
1407       - ping_rx
1408       - padding_tx
1409       - padding_rx
1410       - max_streams_tx
1411       - max_streams_rx
1412       - streams_blocked_tx
1413       - streams_blocked_rx
1414       - max_data_tx
1415       - max_data_rx
1416       - data_blocked_tx
1417       - data_blocked_rx
1418       - max_stream_data_tx
1419       - max_stream_data_rx
1420       - stream_data_blocked_tx
1421       - stream_data_blocked_rx
1422       - new_connection_id_tx
1423       - new_connection_id_rx
1424       - retire_connection_id_tx
1425       - retire_connection_id_rx
1426       - path_challenge_tx
1427       - path_challenge_rx
1428       - path_response_tx
1429       - path_response_rx
1430       - connection_close_tx
1431       - connection_close_rx
1432       - handshake_done_tx
1433       - handshake_done_rx
1434       - new_token_tx
1435       - new_token_rx
1436       - ack_frequency_tx
1437       - ack_frequency_rx
1438       - datagram_tx
1439       - datagram_rx
1440
1441
1442   cache_metadata_first_read_time: &cache_metadata_first_read_time
1443     type: timing_distribution
1444     time_unit: millisecond
1445     description: >
1446       Time spent to read the first part of the metadata from the cache entry file.
1447     bugs:
1448       - https://bugzilla.mozilla.org/show_bug.cgi?id=1908994
1449     data_reviews:
1450       - https://bugzilla.mozilla.org/show_bug.cgi?id=1908994
1451     notification_emails:
1452       - necko@mozilla.com
1453     expires: never
1454     telemetry_mirror: NETWORK_CACHE_METADATA_FIRST_READ_TIME_MS
1455
1456   cache_metadata_second_read_time:
1457     <<: *cache_metadata_first_read_time
1458     description: >
1459       Time spent to read the missing part of the metadata from the cache entry file.
1460     telemetry_mirror: NETWORK_CACHE_METADATA_SECOND_READ_TIME_MS
1461
1462   cache_metadata_size:
1463     type: memory_distribution
1464     memory_unit: byte
1465     description:
1466       Size of the metadata in bytes parsed from the disk.
1467     bugs:
1468       - https://bugzilla.mozilla.org/show_bug.cgi?id=1133739
1469       - https://bugzilla.mozilla.org/show_bug.cgi?id=1495336
1470       - https://bugzilla.mozilla.org/show_bug.cgi?id=1908994
1471     data_reviews:
1472       - https://bugzilla.mozilla.org/show_bug.cgi?id=1908994
1473     data_sensitivity:
1474       - technical
1475     notification_emails:
1476       - necko@mozilla.com
1477     expires: never
1478
1479   residual_cache_folder_count:
1480     type: counter
1481     description: >
1482       Counts how often we find a cache folder that wasn't purged
1483       at shutdown by a background task process.
1484     bugs:
1485       - https://bugzilla.mozilla.org/1848542
1486     data_reviews:
1487       - https://bugzilla.mozilla.org/show_bug.cgi?id=1848542
1488     notification_emails:
1489       - vgosu@mozilla.com
1490     expires: 146
1491
1492   residual_cache_folder_removal:
1493     type: labeled_counter
1494     description: >
1495       Counts how often succeed/fail in removing cache folder
1496       that wasn't purged at shutdown
1497     bugs:
1498       - https://bugzilla.mozilla.org/1848542
1499     data_reviews:
1500       - https://bugzilla.mozilla.org/show_bug.cgi?id=1848542
1501     notification_emails:
1502       - vgosu@mozilla.com
1503     expires: 146
1504     labels:
1505       - success
1506       - failure
1507
1508   cache_purge_due_to_memory_limit:
1509     type: labeled_counter
1510     description: >
1511       Counts how often we purge cache entries from memory due to memory limits.
1512     bugs:
1513       - https://bugzilla.mozilla.org/show_bug.cgi?id=1941935
1514     data_reviews:
1515       - https://bugzilla.mozilla.org/show_bug.cgi?id=1941935
1516     notification_emails:
1517       - necko@mozilla.com
1518     expires: 146
1519     labels:
1520       - meta_data_file_size_limit
1521       - cache_memory_limit
1522
1523   trr_request_count:
1524     type: labeled_counter
1525     description: >
1526       The count of successful TRR requests keyed by regular/private browsing
1527     bugs:
1528       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866245
1529       - https://bugzilla.mozilla.org/show_bug.cgi?id=1902190
1530     data_reviews:
1531       - https://bugzilla.mozilla.org/show_bug.cgi?id=1866245
1532     notification_emails:
1533       - vgosu@mozilla.com
1534       - necko@mozilla.com
1535     expires: 140
1536     labels:
1537       - regular
1538       - private
1539
1540   trr_request_count_per_conn:
1541     type: labeled_counter
1542     description: >
1543       Number of DOH requests per connection keyed by HTTP version
1544     bugs:
1545       - https://bugzilla.mozilla.org/show_bug.cgi?id=1916352
1546     data_reviews:
1547       - https://bugzilla.mozilla.org/show_bug.cgi?id=1916352
1548     notification_emails:
1549       - kershaw@mozilla.com
1550       - necko@mozilla.com
1551     expires: never
1552     labels:
1553       - h1
1554       - h2
1555       - h3
1556
1557   http_redirect_to_scheme_top_level: &http_redirect_to_scheme_top_level
1558     type: labeled_counter
1559     description: >
1560       Count of the HTTP redirection that triggered by top-level document, keyed by the URL scheme redirected to
1561     bugs:
1562       - https://bugzilla.mozilla.org/show_bug.cgi?id=1413512
1563       - https://bugzilla.mozilla.org/show_bug.cgi?id=1567462
1564       - https://bugzilla.mozilla.org/show_bug.cgi?id=1897290
1565     data_reviews:
1566       - https://bugzilla.mozilla.org/show_bug.cgi?id=1897290
1567     notification_emails:
1568       - necko@mozilla.com
1569     expires: never
1570
1571   http_redirect_to_scheme_subresource:
1572     <<: *http_redirect_to_scheme_top_level
1573     description: >
1574       Count of the HTTP redirection that triggered by subresource, keyed by the URL scheme redirected to
1575
1576   http_response_version:
1577     type: labeled_counter
1578     description: >
1579       HTTP protocol version used on response from nsHttp.h
1580     bugs:
1581       - https://bugzilla.mozilla.org/show_bug.cgi?id=1876776
1582     data_reviews:
1583       - https://bugzilla.mozilla.org/show_bug.cgi?id=1876776#c2
1584     notification_emails:
1585       - necko@mozilla.com
1586     expires: never
1587     labels:
1588       - unknown
1589       - http_1
1590       - http_2
1591       - http_3
1592
1593   http_response_status_code:
1594     type: labeled_counter
1595     description: >
1596       HTTP Response Status Code (200, 301, 302, 304, 307, 308, 400, 401, 403, 404, 421, 425, 429, other 400 and 500)
1597     bugs:
1598       - https://bugzilla.mozilla.org/show_bug.cgi?id=1896350
1599       - https://bugzilla.mozilla.org/show_bug.cgi?id=1903410
1600     data_reviews:
1601       - https://bugzilla.mozilla.org/show_bug.cgi?id=1896350
1602     notification_emails:
1603       - necko@mozilla.com
1604       - smayya@mozilla.com
1605     expires: never
1606     labels:
1607       - 200_ok
1608       - 301_moved_permanently
1609       - 302_found
1610       - 304_not_modified
1611       - 307_temporary_redirect
1612       - 308_permanent_redirect
1613       - 400_bad_request
1614       - 401_unauthorized
1615       - 403_forbidden
1616       - 404_not_found
1617       - 421_misdirected_request
1618       - 425_too_early
1619       - 429_too_many_requests
1620       - other_4xx
1621       - other_5xx
1622       - other
1623
1624   https_rr_presented:
1625     type: labeled_counter
1626     description: >
1627       HTTPS RR is presented or not
1628     bugs:
1629       - https://bugzilla.mozilla.org/1686421
1630     data_reviews:
1631       - https://bugzilla.mozilla.org/show_bug.cgi?id=1686421
1632     notification_emails:
1633       - necko@mozilla.com
1634       - kershaw@mozilla.com
1635     expires: never
1636     labels:
1637       - presented
1638       - presented_with_http3
1639       - none
1640
1641   http_channel_onstart_success_https_rr:
1642     type: labeled_counter
1643     description: >
1644       Successfully started HTTP channels when HTTPS RR is used
1645     bugs:
1646       - https://bugzilla.mozilla.org/1682552
1647     data_reviews:
1648       - https://bugzilla.mozilla.org/show_bug.cgi?id=1682552
1649     notification_emails:
1650       - necko@mozilla.com
1651       - kershaw@mozilla.com
1652     expires: never
1653     labels:
1654       - success
1655       - failure
1656       - success_ech_used
1657       - failure_ech_used
1658
1659   http_channel_disposition:
1660     type: labeled_counter
1661     description: >
1662       Channel Disposition for HTTP and HTTPS:
1663       cancel, disk, net_ok, net_early_fail, and net_late_fail
1664     bugs:
1665       - https://bugzilla.mozilla.org/1341128
1666       - https://bugzilla.mozilla.org/1898248
1667     data_reviews:
1668       - https://bugzilla.mozilla.org/show_bug.cgi?id=1898248
1669     notification_emails:
1670       - necko@mozilla.com
1671     expires: never
1672     labels:
1673       - http_cancelled
1674       - http_disk
1675       - http_net_ok
1676       - http_net_early_fail
1677       - http_net_late_fail
1678       - https_cancelled
1679       - https_disk
1680       - https_net_ok
1681       - https_net_early_fail
1682       - https_net_late_fail
1683
1684   http_channel_disposition_enabled_upgrade: &http_channel_disposition_enabled_upgrade
1685     type: labeled_counter
1686     description: >
1687       Upgrading display content Channel Disposition (key: enable_upgrade)
1688     bugs:
1689       - https://bugzilla.mozilla.org/1440701
1690       - https://bugzilla.mozilla.org/1898248
1691     data_reviews:
1692       - https://bugzilla.mozilla.org/show_bug.cgi?id=1898248
1693     notification_emails:
1694       - necko@mozilla.com
1695       - seceng-telemetry@mozilla.com
1696     expires: never
1697     labels:
1698       - cancel
1699       - disk
1700       - net_ok
1701       - net_early_fail
1702       - net_late_fail
1703
1704   http_channel_disposition_enabled_no_reason:
1705     <<: *http_channel_disposition_enabled_upgrade
1706     description: >
1707       Upgrading display content Channel Disposition (key: enabled_no_reason)
1708
1709   http_channel_disposition_enabled_wont:
1710     <<: *http_channel_disposition_enabled_upgrade
1711     description: >
1712       Upgrading display content Channel Disposition (key: enabled_wont)
1713
1714   http_channel_disposition_disabled_upgrade:
1715     <<: *http_channel_disposition_enabled_upgrade
1716     description: >
1717       Upgrading display content Channel Disposition (key: disable_upgrade)
1718
1719   http_channel_disposition_disabled_no_reason:
1720     <<: *http_channel_disposition_enabled_upgrade
1721     description: >
1722       Upgrading display content Channel Disposition (key: disabled_no_reason)
1723
1724   http_channel_disposition_disabled_wont:
1725     <<: *http_channel_disposition_enabled_upgrade
1726     description: >
1727       Upgrading display content Channel Disposition (key: disabled_wont)
1728
1729   http_channel_onstart_status:
1730     type: labeled_counter
1731     description: >
1732       Whether successfully started HTTP channels
1733     bugs:
1734       - https://bugzilla.mozilla.org/1473333
1735       - https://bugzilla.mozilla.org/1587226
1736       - https://bugzilla.mozilla.org/1898248
1737     data_reviews:
1738       - https://bugzilla.mozilla.org/show_bug.cgi?id=1898248
1739     notification_emails:
1740       - necko@mozilla.com
1741     expires: never
1742     labels:
1743       - successful
1744       - fail
1745
1746   http_channel_page_open_to_first_sent:
1747     type: timing_distribution
1748     time_unit: millisecond
1749     description: >
1750       Time in milliseconds from AsyncOpen to first byte of request sent,
1751       applicable for page loads without HTTPS RR
1752     bugs:
1753       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1754     data_reviews:
1755       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1756     data_sensitivity:
1757       - technical
1758     notification_emails:
1759       - necko@mozilla.com
1760       - kershaw@mozilla.com
1761     expires: never
1762
1763   http_channel_sub_open_to_first_sent:
1764     type: timing_distribution
1765     time_unit: millisecond
1766     description: >
1767       Time in milliseconds from AsyncOpen to first byte of request sent,
1768       applicable for sub-resource loads without HTTPS RR
1769     bugs:
1770       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1771     data_reviews:
1772       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1773     data_sensitivity:
1774       - technical
1775     notification_emails:
1776       - necko@mozilla.com
1777       - kershaw@mozilla.com
1778     expires: never
1779
1780   http_channel_page_open_to_first_sent_https_rr:
1781     type: timing_distribution
1782     time_unit: millisecond
1783     description: >
1784       Time in milliseconds from AsyncOpen to first byte of request sent,
1785       applicable for page loads with HTTPS RR
1786     bugs:
1787       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1788     data_reviews:
1789       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1790     data_sensitivity:
1791       - technical
1792     notification_emails:
1793       - necko@mozilla.com
1794       - kershaw@mozilla.com
1795     expires: never
1796
1797   http_to_https_upgrade_reason:
1798     type: labeled_counter
1799     description: >
1800       Whether a top-level HTTP request gets upgraded to HTTPS and the reason for it
1801     bugs:
1802       - https://bugzilla.mozilla.org/show_bug.cgi?id=1883954
1803       - https://bugzilla.mozilla.org/show_bug.cgi?id=1922559
1804     data_reviews:
1805       - https://bugzilla.mozilla.org/show_bug.cgi?id=1883954
1806     notification_emails:
1807       - ckerschb@mozilla.com
1808       - freddyb@mozilla.com
1809       - kershaw@mozilla.com
1810       - necko@mozilla.com
1811       - seceng-telemetry@mozilla.com
1812     expires: never
1813     labels:
1814       - not_initialized
1815       - not_initialized_https #Bug 1912222, remove eventually
1816       - no_upgrade
1817       - no_upgrade_https #Bug 1912222, remove eventually
1818       - already_https
1819       - hsts
1820       - https_only_upgrade
1821       - https_only_upgrade_downgrade
1822       - https_first_upgrade
1823       - https_first_upgrade_downgrade
1824       - https_first_schemeless_upgrade
1825       - https_first_schemeless_upgrade_downgrade
1826       - csp_uir
1827       - https_rr
1828       - web_extension_upgrade
1829       - upgrade_exception
1830       - skip_upgrade
1831
1832   https_http_or_local:
1833     type: labeled_counter
1834     description: >
1835       Whether a top-level request is HTTPS, HTTP, or HTTP for local domain
1836     bugs:
1837       - https://bugzilla.mozilla.org/show_bug.cgi?id=1933672
1838     data_reviews:
1839       - https://bugzilla.mozilla.org/show_bug.cgi?id=1933672
1840     notification_emails:
1841       - ckerschb@mozilla.com
1842       - kershaw@mozilla.com
1843       - necko@mozilla.com
1844       - seceng-telemetry@mozilla.com
1845     expires: never
1846     labels:
1847       - load_is_https
1848       - load_is_http
1849       - load_is_http_for_local_domain
1850
1851   http_channel_sub_open_to_first_sent_https_rr:
1852     type: timing_distribution
1853     time_unit: millisecond
1854     description: >
1855       Time in milliseconds from AsyncOpen to first byte of request sent,
1856       applicable for sub-resource loads with HTTPS RR
1857     bugs:
1858       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1859     data_reviews:
1860       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1861     data_sensitivity:
1862       - technical
1863     notification_emails:
1864       - necko@mozilla.com
1865       - kershaw@mozilla.com
1866     expires: never
1867
1868   transaction_wait_time_https_rr:
1869     type: timing_distribution
1870     time_unit: millisecond
1871     description: >
1872       Time from submission to dispatch of transaction when HTTPS RR is used (ms)
1873     bugs:
1874       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1875     data_reviews:
1876       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1877     data_sensitivity:
1878       - technical
1879     notification_emails:
1880       - necko@mozilla.com
1881       - kershaw@mozilla.com
1882     expires: never
1883
1884   proxy_info_type:
1885     type: labeled_counter
1886     description: >
1887       The proxies configurations created in the browser session (SOCKSv4, SOCKSv5, HTTP, HTTPS)
1888     bugs:
1889       - https://bugzilla.mozilla.org/show_bug.cgi?id=1879848
1890       - https://bugzilla.mozilla.org/show_bug.cgi?id=1928273
1891     data_reviews:
1892       - https://bugzilla.mozilla.org/show_bug.cgi?id=1879848
1893       - https://bugzilla.mozilla.org/show_bug.cgi?id=1928273
1894     data_sensitivity:
1895       - technical
1896     notification_emails:
1897       - necko@mozilla.com
1898       - vgosu@mozilla.com
1899     expires: never
1900     labels:
1901       - http
1902       - https
1903       # SOCKS4 Proxy
1904       - socks4
1905       # SOCKS4a Proxy. Proxy resolves URL hostname
1906       - socks4a
1907       # SOCKS5 Proxy
1908       - socks5
1909       # SOCKS5 Proxy. Proxy resolves URL hostname
1910       # Use convention from curl for socks5 proxies that resolve the hostname
1911       # https://curl.se/libcurl/c/CURLOPT_PROXY.html
1912       - socks5h
1913       # No proxy
1914       - direct
1915       - unknown
1916
1917   transaction_wait_time:
1918     type: timing_distribution
1919     time_unit: millisecond
1920     description: >
1921       Time from submission to dispatch of transaction without HTTPS RR (ms)
1922     bugs:
1923       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1924     data_reviews:
1925       - https://bugzilla.mozilla.org/show_bug.cgi?id=1697480
1926     data_sensitivity:
1927       - technical
1928     notification_emails:
1929       - necko@mozilla.com
1930       - kershaw@mozilla.com
1931     expires: never
1932
1933   os_socket_limit_reached:
1934     type: counter
1935     description: >
1936       Counts the number of times the os socket limit was reached. i.e. CanAttachSocket() returned false.
1937     bugs:
1938       - https://bugzilla.mozilla.org/1901855
1939     data_reviews:
1940       - https://bugzilla.mozilla.org/show_bug.cgi?id=1901855#c1
1941     data_sensitivity:
1942       - technical
1943     notification_emails:
1944       - necko@mozilla.com
1945       - acreskey@mozilla.com
1946     expires: never
1947
1948   http_3_udp_datagram_segment_size_sent:
1949     type: memory_distribution
1950     memory_unit: byte
1951     description: >
1952       HTTP3 UDP datagram segment size sent.
1953     bugs:
1954       - https://bugzilla.mozilla.org/show_bug.cgi?id=1906853
1955     data_reviews:
1956       - https://bugzilla.mozilla.org/show_bug.cgi?id=1906853
1957     data_sensitivity:
1958       - technical
1959     notification_emails:
1960       - necko@mozilla.com
1961       - minden@mozilla.com
1962     expires: never
1963
1964   http_3_udp_datagram_segment_size_received:
1965     type: memory_distribution
1966     memory_unit: byte
1967     description: >
1968       HTTP3 UDP datagram size received.
1969     bugs:
1970       - https://bugzilla.mozilla.org/show_bug.cgi?id=1906853
1971     data_reviews:
1972       - https://bugzilla.mozilla.org/show_bug.cgi?id=1906853
1973     data_sensitivity:
1974       - technical
1975     notification_emails:
1976       - necko@mozilla.com
1977       - minden@mozilla.com
1978     expires: never
1979
1980   http_3_udp_datagram_size_received:
1981     type: memory_distribution
1982     memory_unit: byte
1983     description: >
1984       HTTP3 UDP datagram size received.
1985     bugs:
1986       - https://bugzilla.mozilla.org/show_bug.cgi?id=1906853
1987     data_reviews:
1988       - https://bugzilla.mozilla.org/show_bug.cgi?id=1906853
1989     data_sensitivity:
1990       - technical
1991     notification_emails:
1992       - necko@mozilla.com
1993       - minden@mozilla.com
1994     expires: never
1995
1996   http_3_udp_datagram_segments_received:
1997     type: custom_distribution
1998     unit: integer
1999     range_min: 0
2000     # Maximum number of UDP segments per datagram.
2001     #
2002     # See e.g. Linux https://github.com/torvalds/linux/blob/20371ba120635d9ab7fc7670497105af8f33eb08/include/linux/udp.h#L111.
2003     range_max: 128
2004     bucket_count: 100
2005     histogram_type: exponential
2006     description: >
2007       HTTP3 UDP number of segments per datagram received.
2008     bugs:
2009       - https://bugzilla.mozilla.org/show_bug.cgi?id=1906853
2010     data_reviews:
2011       - https://bugzilla.mozilla.org/show_bug.cgi?id=1906853
2012     data_sensitivity:
2013       - technical
2014     notification_emails:
2015       - necko@mozilla.com
2016       - minden@mozilla.com
2017     expires: never
2018
2019 network.dns:
2020   trr_confirmation_context:
2021     type: event
2022     description: >
2023       This telemetry records the status of the TRR confirmation across.
2024       The value of the event is one of:   "ok"   "trying"
2025       This event was generated to correspond to the Legacy Telemetry event
2026       network.dns.trrConfirmation#context.
2027     bugs:
2028       - https://bugzil.la/1691408
2029       - https://bugzil.la/1694949
2030     data_reviews:
2031       - https://bugzil.la/1691408
2032       - https://bugzil.la/1694949
2033     notification_emails:
2034       - vgosu@mozilla.com
2035       - necko@mozilla.com
2036     expires: never
2037     extra_keys:
2038       value:
2039         description: >
2040           The `value` of the event. Mirrors to the Legacy Telemetry
2041           event's `value` parameter.
2042           The `ConfirmationState`.
2043         type: quantity
2044       trigger:
2045         description: >
2046           The reason why this confirmation was triggered. Values: [cp-connectivity, pref-change, context-init, retry, failed-lookups]
2047         type: string
2048       contextReason:
2049         description: >
2050           The cause of the current confirmation context. Values: [success, pref-change, network-change, shutdown]
2051         type: string
2052       attemptCount:
2053         description: >
2054           The number of NS requests that were issued for this confirmation.
2055         type: quantity
2056       results:
2057         description: >
2058           String representation of the last 32 confirmation results. Example: nnnnnnttttttttt indicates a number of network (n) failures followed by timeouts (t).
2059         type: string
2060       failedLookups:
2061         description: >
2062           When the trigger is failed-lookups, this contains the string representation of the failures that triggered the confirmation.
2063         type: string
2064       networkID:
2065         description: >
2066           The network ID for the recorded confirmation attempts
2067         type: string
2068       captivePortal:
2069         description: >
2070           One of [unknown, not_captive, unlocked, locked]
2071         type: string
2072       time:
2073         description: >
2074           Time from first confirmation attempt to event being recorded
2075         type: string
2076     telemetry_mirror: NetworkDns_Trrconfirmation_Context
2077
2078 network.sso:
2079   entra_success:
2080     type: labeled_counter
2081     description: >
2082       Counts how often Entra SSO succeeded/failed (macOS only). Labels are ordered in reverse chronological relation to SSO success, meaning the labels higher up are closer to the SSO success.
2083       device_headers_missing: only device_headers is missing in the SSO cookie.
2084       prt_headers_missing: only prt_headers is missing in the SSO cookie.
2085       both_headers_missing: both prt_headers and device_headers are missing in the SSO cookie.
2086       invalid_cookie: Failed to parse SSO cookie (could be a null cookie/format is incorrect).
2087       no_credential: ASAuthorizationSingleSignOnCredential is not present
2088       broker_error: An error from Microsoft's broker.
2089       invalid_controller_setup: ASAuthorizationController is setup incorrectly.
2090     bugs:
2091       - https://bugzilla.mozilla.org/1930742
2092     data_reviews:
2093       - https://bugzilla.mozilla.org/show_bug.cgi?id=1930742
2094     notification_emails:
2095       - necko@mozilla.com
2096     expires: never
2097     labels:
2098       - success
2099       - device_headers_missing
2100       - prt_headers_missing
2101       - both_headers_missing
2102       - invalid_cookie
2103       - no_credential
2104       - broker_error
2105       - invalid_controller_setup
2106
2107   total_entra_uses:
2108     type: counter
2109     description: >
2110       Counts how often Entra SSO is used (macOS only).
2111     bugs:
2112       - https://bugzilla.mozilla.org/1930742
2113     data_reviews:
2114       - https://bugzilla.mozilla.org/show_bug.cgi?id=1930742
2115     notification_emails:
2116       - necko@mozilla.com
2117     expires: never
2118
2119 predictor:
2120   learn_attempts:
2121     type: custom_distribution
2122     description: >
2123       Number of times nsINetworkPredictor::Learn is called and attempts to learn
2124
2125       This metric was generated to correspond to the Legacy Telemetry
2126       exponential histogram PREDICTOR_LEARN_ATTEMPTS.
2127     range_min: 1
2128     range_max: 1000000
2129     bucket_count: 50
2130     histogram_type: exponential
2131     bugs:
2132       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2133     data_reviews:
2134       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2135     notification_emails:
2136       - necko@mozilla.com
2137     expires: never
2138     telemetry_mirror: PREDICTOR_LEARN_ATTEMPTS
2139
2140   wait_time:
2141     type: timing_distribution
2142     description: >
2143       Amount of time a predictor event waits in the queue (ms)
2144
2145       This metric was generated to correspond to the Legacy Telemetry
2146       exponential histogram PREDICTOR_WAIT_TIME.
2147     time_unit: millisecond
2148     bugs:
2149       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2150     data_reviews:
2151       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2152     notification_emails:
2153       - necko@mozilla.com
2154     expires: never
2155     telemetry_mirror: PREDICTOR_WAIT_TIME
2156
2157   predict_work_time:
2158     type: timing_distribution
2159     description: >
2160       Amount of time spent doing the work for predict (ms)
2161
2162       This metric was generated to correspond to the Legacy Telemetry
2163       exponential histogram PREDICTOR_PREDICT_WORK_TIME.
2164     time_unit: millisecond
2165     bugs:
2166       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2167     data_reviews:
2168       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2169     notification_emails:
2170       - necko@mozilla.com
2171     expires: never
2172     telemetry_mirror: PREDICTOR_PREDICT_WORK_TIME
2173
2174   learn_work_time:
2175     type: timing_distribution
2176     description: >
2177       Amount of time spent doing the work for learn (ms)
2178
2179       This metric was generated to correspond to the Legacy Telemetry
2180       exponential histogram PREDICTOR_LEARN_WORK_TIME.
2181     time_unit: millisecond
2182     bugs:
2183       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2184     data_reviews:
2185       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2186     notification_emails:
2187       - necko@mozilla.com
2188     expires: never
2189     telemetry_mirror: PREDICTOR_LEARN_WORK_TIME
2190
2191   total_predictions:
2192     type: custom_distribution
2193     description: >
2194       How many actual predictions (preresolves, preconnects, ...) happen
2195
2196       This metric was generated to correspond to the Legacy Telemetry
2197       exponential histogram PREDICTOR_TOTAL_PREDICTIONS.
2198     range_min: 1
2199     range_max: 1000000
2200     bucket_count: 50
2201     histogram_type: exponential
2202     bugs:
2203       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2204     data_reviews:
2205       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2206     notification_emails:
2207       - necko@mozilla.com
2208     expires: never
2209     telemetry_mirror: PREDICTOR_TOTAL_PREDICTIONS
2210
2211   total_prefetches:
2212     type: custom_distribution
2213     description: >
2214       How many actual prefetches happen
2215
2216       This metric was generated to correspond to the Legacy Telemetry
2217       exponential histogram PREDICTOR_TOTAL_PREFETCHES.
2218     range_min: 1
2219     range_max: 1000000
2220     bucket_count: 50
2221     histogram_type: exponential
2222     bugs:
2223       - https://bugzilla.mozilla.org/show_bug.cgi?id=1016628
2224     data_reviews:
2225       - https://bugzilla.mozilla.org/show_bug.cgi?id=1016628
2226     notification_emails:
2227       - necko@mozilla.com
2228     expires: never
2229     telemetry_mirror: PREDICTOR_TOTAL_PREFETCHES
2230
2231   prefetch_use_status:
2232     type: labeled_counter
2233     description: >
2234       If and why prefetches are used/unused.
2235
2236       This metric was generated to correspond to the Legacy Telemetry
2237       categorical histogram PREDICTOR_PREFETCH_USE_STATUS.
2238     labels:
2239       - Used
2240       - Not200
2241       - Expired
2242       - WouldVary
2243       - WaitedTooLong
2244       - Etag
2245       - Auth
2246       - Redirect
2247     bugs:
2248       - https://bugzilla.mozilla.org/show_bug.cgi?id=1016628
2249       - https://bugzilla.mozilla.org/show_bug.cgi?id=1312057
2250     data_reviews:
2251       - https://bugzilla.mozilla.org/show_bug.cgi?id=1016628
2252       - https://bugzilla.mozilla.org/show_bug.cgi?id=1312057
2253     notification_emails:
2254       - necko@mozilla.com
2255     expires: never
2256     telemetry_mirror: h#PREDICTOR_PREFETCH_USE_STATUS
2257
2258   prefetch_time:
2259     type: timing_distribution
2260     description: >
2261       How long it takes from OnStartRequest to OnStopRequest for a prefetch
2262
2263       This metric was generated to correspond to the Legacy Telemetry
2264       exponential histogram PREDICTOR_PREFETCH_TIME.
2265     time_unit: millisecond
2266     bugs:
2267       - https://bugzilla.mozilla.org/show_bug.cgi?id=1016628
2268     data_reviews:
2269       - https://bugzilla.mozilla.org/show_bug.cgi?id=1016628
2270     notification_emails:
2271       - necko@mozilla.com
2272     expires: never
2273     telemetry_mirror: PREDICTOR_PREFETCH_TIME
2274
2275   total_preconnects:
2276     type: custom_distribution
2277     description: >
2278       How many actual preconnects happen
2279
2280       This metric was generated to correspond to the Legacy Telemetry
2281       exponential histogram PREDICTOR_TOTAL_PRECONNECTS.
2282     range_min: 1
2283     range_max: 1000000
2284     bucket_count: 50
2285     histogram_type: exponential
2286     bugs:
2287       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2288     data_reviews:
2289       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2290     notification_emails:
2291       - necko@mozilla.com
2292     expires: never
2293     telemetry_mirror: PREDICTOR_TOTAL_PRECONNECTS
2294
2295   total_preresolves:
2296     type: custom_distribution
2297     description: >
2298       How many actual preresolves happen
2299
2300       This metric was generated to correspond to the Legacy Telemetry
2301       exponential histogram PREDICTOR_TOTAL_PRERESOLVES.
2302     range_min: 1
2303     range_max: 1000000
2304     bucket_count: 50
2305     histogram_type: exponential
2306     bugs:
2307       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2308     data_reviews:
2309       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2310     notification_emails:
2311       - necko@mozilla.com
2312     expires: never
2313     telemetry_mirror: PREDICTOR_TOTAL_PRERESOLVES
2314
2315   predictions_calculated:
2316     type: custom_distribution
2317     description: >
2318       How many prediction calculations are performed
2319
2320       This metric was generated to correspond to the Legacy Telemetry
2321       exponential histogram PREDICTOR_PREDICTIONS_CALCULATED.
2322     range_min: 1
2323     range_max: 1000000
2324     bucket_count: 50
2325     histogram_type: exponential
2326     unit: calculations
2327     bugs:
2328       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2329     data_reviews:
2330       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2331     notification_emails:
2332       - necko@mozilla.com
2333     expires: never
2334     telemetry_mirror: PREDICTOR_PREDICTIONS_CALCULATED
2335
2336   global_degradation:
2337     type: custom_distribution
2338     description: >
2339       The global degradation calculated
2340
2341       This metric was generated to correspond to the Legacy Telemetry linear
2342       histogram PREDICTOR_GLOBAL_DEGRADATION.
2343     range_min: 1
2344     range_max: 100
2345     bucket_count: 50
2346     histogram_type: linear
2347     bugs:
2348       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2349     data_reviews:
2350       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2351     notification_emails:
2352       - necko@mozilla.com
2353     expires: never
2354     telemetry_mirror: PREDICTOR_GLOBAL_DEGRADATION
2355
2356   subresource_degradation:
2357     type: custom_distribution
2358     description: >
2359       The degradation calculated for a subresource
2360
2361       This metric was generated to correspond to the Legacy Telemetry linear
2362       histogram PREDICTOR_SUBRESOURCE_DEGRADATION.
2363     range_min: 1
2364     range_max: 100
2365     bucket_count: 50
2366     histogram_type: linear
2367     bugs:
2368       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2369     data_reviews:
2370       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2371     notification_emails:
2372       - necko@mozilla.com
2373     expires: never
2374     telemetry_mirror: PREDICTOR_SUBRESOURCE_DEGRADATION
2375
2376   base_confidence:
2377     type: custom_distribution
2378     description: >
2379       The base confidence calculated for a subresource
2380
2381       This metric was generated to correspond to the Legacy Telemetry linear
2382       histogram PREDICTOR_BASE_CONFIDENCE.
2383     range_min: 1
2384     range_max: 100
2385     bucket_count: 50
2386     histogram_type: linear
2387     bugs:
2388       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2389     data_reviews:
2390       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2391     notification_emails:
2392       - necko@mozilla.com
2393     expires: never
2394     telemetry_mirror: PREDICTOR_BASE_CONFIDENCE
2395
2396   confidence:
2397     type: custom_distribution
2398     description: >
2399       The final confidence calculated for a subresource
2400
2401       This metric was generated to correspond to the Legacy Telemetry linear
2402       histogram PREDICTOR_CONFIDENCE.
2403     range_min: 1
2404     range_max: 100
2405     bucket_count: 50
2406     histogram_type: linear
2407     bugs:
2408       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2409     data_reviews:
2410       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2411     notification_emails:
2412       - necko@mozilla.com
2413     expires: never
2414     telemetry_mirror: PREDICTOR_CONFIDENCE
2415
2416   predict_time_to_action:
2417     type: timing_distribution
2418     description: >
2419       How long it takes from the time Predict() is called to the time we take
2420       action
2421
2422       This metric was generated to correspond to the Legacy Telemetry
2423       exponential histogram PREDICTOR_PREDICT_TIME_TO_ACTION.
2424     time_unit: millisecond
2425     bugs:
2426       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2427     data_reviews:
2428       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2429     notification_emails:
2430       - necko@mozilla.com
2431     expires: never
2432     telemetry_mirror: PREDICTOR_PREDICT_TIME_TO_ACTION
2433
2434   predict_time_to_inaction:
2435     type: timing_distribution
2436     description: >
2437       How long it takes from the time Predict() is called to the time we figure
2438       out there's nothing to do
2439
2440       This metric was generated to correspond to the Legacy Telemetry
2441       exponential histogram PREDICTOR_PREDICT_TIME_TO_INACTION.
2442     time_unit: millisecond
2443     bugs:
2444       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2445     data_reviews:
2446       - https://bugzilla.mozilla.org/show_bug.cgi?id=881804
2447     notification_emails:
2448       - necko@mozilla.com
2449     expires: never
2450     telemetry_mirror: PREDICTOR_PREDICT_TIME_TO_INACTION
2451
2452   prefetch_decision_reason:
2453     type: custom_distribution
2454     description: >
2455       Why the predictor determined a particular resource was eligible for future
2456       prefetch (or not). See PrefetchDecisionReason in Predictor.cpp for value
2457       meanings
2458
2459       This metric was generated to correspond to the Legacy Telemetry enumerated
2460       histogram PREDICTOR_PREFETCH_DECISION_REASON.
2461     range_min: 0
2462     range_max: 15
2463     bucket_count: 16
2464     histogram_type: linear
2465     bugs:
2466       - https://bugzilla.mozilla.org/show_bug.cgi?id=1409542
2467       - https://bugzilla.mozilla.org/show_bug.cgi?id=1430322
2468       - https://bugzilla.mozilla.org/show_bug.cgi?id=1312057
2469     data_reviews:
2470       - https://bugzilla.mozilla.org/show_bug.cgi?id=1409542
2471       - https://bugzilla.mozilla.org/show_bug.cgi?id=1430322
2472       - https://bugzilla.mozilla.org/show_bug.cgi?id=1312057
2473     notification_emails:
2474       - necko@mozilla.com
2475     expires: never
2476     telemetry_mirror: PREDICTOR_PREFETCH_DECISION_REASON
2477
2478   prefetch_ignore_reason:
2479     type: custom_distribution
2480     description: >
2481       Why the predictor determined a particular resource that was marked
2482       eligible for prefetch should not be prefetched. See PrefetchIgnoreReason
2483       in Predictor.cpp for value meanings
2484
2485       This metric was generated to correspond to the Legacy Telemetry enumerated
2486       histogram PREDICTOR_PREFETCH_IGNORE_REASON.
2487     range_min: 0
2488     range_max: 15
2489     bucket_count: 16
2490     histogram_type: linear
2491     bugs:
2492       - https://bugzilla.mozilla.org/show_bug.cgi?id=1409542
2493       - https://bugzilla.mozilla.org/show_bug.cgi?id=1430322
2494       - https://bugzilla.mozilla.org/show_bug.cgi?id=1312057
2495     data_reviews:
2496       - https://bugzilla.mozilla.org/show_bug.cgi?id=1409542
2497       - https://bugzilla.mozilla.org/show_bug.cgi?id=1430322
2498       - https://bugzilla.mozilla.org/show_bug.cgi?id=1312057
2499     notification_emails:
2500       - necko@mozilla.com
2501     expires: never
2502     telemetry_mirror: PREDICTOR_PREFETCH_IGNORE_REASON
2503
2504 sts:
2505   poll_and_events_cycle:
2506     type: timing_distribution
2507     description: >
2508       The duraion of a socketThread cycle, including polls and pending events.
2509       (ms)
2510
2511       This metric was generated to correspond to the Legacy Telemetry
2512       exponential histogram STS_POLL_AND_EVENTS_CYCLE.
2513     time_unit: millisecond
2514     bugs:
2515       - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
2516     data_reviews:
2517       - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
2518     notification_emails:
2519       - necko@mozilla.com
2520     expires: never
2521     telemetry_mirror: STS_POLL_AND_EVENTS_CYCLE
2522     no_lint:
2523       - COMMON_PREFIX
2524
2525   poll_cycle:
2526     type: timing_distribution
2527     description: >
2528       The duration of poll. (ms)
2529
2530       This metric was generated to correspond to the Legacy Telemetry
2531       exponential histogram STS_POLL_CYCLE.
2532     time_unit: millisecond
2533     bugs:
2534       - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
2535     data_reviews:
2536       - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
2537     notification_emails:
2538       - necko@mozilla.com
2539     expires: never
2540     telemetry_mirror: STS_POLL_CYCLE
2541     no_lint:
2542       - COMMON_PREFIX
2543
2544   poll_and_event_the_last_cycle:
2545     type: timing_distribution
2546     description: >
2547       The duraion of the socketThread cycle during shutdown, including polls and
2548       pending events. (ms)
2549
2550       This metric was generated to correspond to the Legacy Telemetry
2551       exponential histogram STS_POLL_AND_EVENT_THE_LAST_CYCLE.
2552     time_unit: millisecond
2553     bugs:
2554       - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
2555     data_reviews:
2556       - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
2557     notification_emails:
2558       - necko@mozilla.com
2559     expires: never
2560     telemetry_mirror: STS_POLL_AND_EVENT_THE_LAST_CYCLE
2561     no_lint:
2562       - COMMON_PREFIX
2563
2564   poll_block_time:
2565     type: timing_distribution
2566     description: >
2567       Time spent blocked on poll (ms).
2568
2569       This metric was generated to correspond to the Legacy Telemetry
2570       exponential histogram STS_POLL_BLOCK_TIME.
2571     time_unit: millisecond
2572     bugs:
2573       - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
2574     data_reviews:
2575       - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
2576     notification_emails:
2577       - necko@mozilla.com
2578     expires: never
2579     telemetry_mirror: STS_POLL_BLOCK_TIME
2580     no_lint:
2581       - COMMON_PREFIX