Source code
Revision control
Copy as Markdown
Other Tools
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# Adding a new metric? We have docs for that!
---
$tags:
- 'Core :: Networking: HTTP'
netwerk:
parent_connect_timeout:
type: counter
description: >
Counts how often the parent-connect-timeout timer is necessary to clear up EarlyHintPreloader
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- manuel@mozilla.com
expires: never
http3_0rtt_state:
type: labeled_counter
description: >
Gather the outcome of 0-RTT usage:
- "not_used": 0RTT_NOT_USED
- "succeeded": 0RTT_USED_SUCCESS
- "rejected": 0RTT_USED_REJECT
- "conn_error": 0RTT_USED_CONN_ERROR
- "conn_closed_by_necko": 0RTT_CONN_CLOSED_BY_NECKO
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
expires: never
labels:
- not_used
- succeeded
- rejected
- conn_error
- conn_closed_by_necko
http3_0rtt_state_duration:
type: labeled_timing_distribution
time_unit: millisecond
description: >
The time a connection was in the 0-RTT state
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
labels:
- succeeded
- rejected
- conn_error
- conn_closed_by_necko
- not_used
expires: never
network:
byte_range_request:
type: labeled_counter
labels:
- cacheable
- not_cacheable
description: >
Counts of cacheable/non-cacheable byte-range requests
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
expires: never
cache_read_time:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from connection cache read start to cache read end.
Corresponds to Legacy histogram HTTP_PAGE_CACHE_READ_TIME_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_PAGE_CACHE_READ_TIME_V2
expires: never
complete_load:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from connection open to complete load (cache read end/until the last byte received)
Corresponds to Legacy histogram HTTP_PAGE_COMPLETE_LOAD_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_PAGE_COMPLETE_LOAD_V2
expires: never
complete_load_cached:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from connection open to cache read end.
Corresponds to Legacy histogram HTTP_PAGE_COMPLETE_LOAD_CACHED_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_PAGE_COMPLETE_LOAD_CACHED_V2
expires: never
complete_load_net:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from connection open to the last byte received.
Corresponds to Legacy histogram HTTP_PAGE_COMPLETE_LOAD_NET_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_PAGE_COMPLETE_LOAD_NET_V2
expires: never
cors_authorization_header:
type: labeled_counter
labels:
- allowed
- disallowed
- covered_by_wildcard
description: >
Count how many times we see `Authorization` header in
`Access-Control-Request-Headers` header and the possible outcomes.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- kershaw@mozilla.com
expires: 140
cache_hit_time:
type: timing_distribution
time_unit: millisecond
telemetry_mirror: NETWORK_CACHE_V2_HIT_TIME_MS
description: >
Time to open existing cache entry file.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
expires: never
font_download_end:
type: timing_distribution
time_unit: millisecond
telemetry_mirror: WEBFONT_DOWNLOAD_TIME_AFTER_START
description: >
Time after navigationStart that all webfont downloads are completed.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- perf-telemetry-alerts@mozilla.com
- necko@mozilla.com
- bdekoz@mozilla.com
expires: never
first_from_cache:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from connection open to cache read start.
Corresponds to Legacy histogram HTTP_PAGE_OPEN_TO_FIRST_FROM_CACHE_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_PAGE_OPEN_TO_FIRST_FROM_CACHE_V2
expires: never
tcp_connection:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from the TCP SYN packet is received to
the connection is established and ready for HTTP.
Corresponds to Legacy histogram HTTP_PAGE_TCP_CONNECTION_2 in Desktop
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
telemetry_mirror: HTTP_PAGE_TCP_CONNECTION_2
expires: never
dns_start:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from connection open to the DNS request
being issued.
Corresponds to Legacy histogram HTTP_PAGE_DNS_ISSUE_TIME in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
telemetry_mirror: HTTP_PAGE_DNS_ISSUE_TIME
expires: never
dns_end:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from the DNS request being issued to
the response.
Corresponds to Legacy histogram HTTP_PAGE_DNS_LOOKUP_TIME in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
telemetry_mirror: HTTP_PAGE_DNS_LOOKUP_TIME
expires: never
http_revalidation:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time for positive cache validation
Corresponds to Legacy histogram HTTP_PAGE_REVALIDATION in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_PAGE_REVALIDATION
expires: never
first_sent_to_last_received:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from first byte of request sent to the last byte received.
Corresponds to Legacy histogram HTTP_PAGE_FIRST_SENT_TO_LAST_RECEIVED in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror:
HTTP_PAGE_FIRST_SENT_TO_LAST_RECEIVED
expires: never
open_to_first_sent:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from connection open to the first byte of requst sent.
Corresponds to Legacy histogram HTTP_PAGE_OPEN_TO_FIRST_SENT in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror:
HTTP_PAGE_OPEN_TO_FIRST_SENT
expires: never
open_to_first_received:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel,time from connection open to the first byte received.
Corresponds to Legacy histogram HTTP_PAGE_OPEN_TO_FIRST_RECEIVED in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror:
HTTP_PAGE_OPEN_TO_FIRST_RECEIVED
expires: never
sub_cache_read_time:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from connection cache read start to cache read end.
Corresponds to Legacy histogram HTTP_SUB_CACHE_READ_TIME_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_CACHE_READ_TIME_V2
expires: never
sub_complete_load:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from connection open to complete load (cache read end/until the last byte received)
Corresponds to Legacy histogram HTTP_SUB_COMPLETE_LOAD_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_COMPLETE_LOAD_V2
expires: never
sub_complete_load_cached:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from connection open to cache read end.
Corresponds to Legacy histogram HTTP_SUB_COMPLETE_LOAD_CACHED_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_COMPLETE_LOAD_CACHED_V2
expires: never
sub_complete_load_net:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from connection open to the last byte received.
Corresponds to Legacy histogram HTTP_SUB_COMPLETE_LOAD_NET_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_COMPLETE_LOAD_NET_V2
expires: never
sub_dns_start:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from connection open to the DNS request
being issued.
Corresponds to Legacy histogram HTTP_SUB_DNS_ISSUE_TIME in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_DNS_ISSUE_TIME
expires: never
sub_dns_end:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from the DNS request being issued to
the response.
Corresponds to Legacy histogram HTTP_SUB_DNS_LOOKUP_TIME in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_DNS_LOOKUP_TIME
expires: never
sub_first_from_cache:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from connection open to cache read start.
Corresponds to Legacy histogram HTTP_SUB_OPEN_TO_FIRST_FROM_CACHE_V2 in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_OPEN_TO_FIRST_FROM_CACHE_V2
expires: never
sub_first_sent_to_last_received:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from first byte of request sent to the last byte received.
Corresponds to Legacy histogram HTTP_SUB_FIRST_SENT_TO_LAST_RECEIVED in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror:
HTTP_SUB_FIRST_SENT_TO_LAST_RECEIVED
expires: never
sub_http_revalidation:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time for positive cache validation
Corresponds to Legacy histogram HTTP_SUB_REVALIDATION in
Desktop.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_REVALIDATION
expires: never
sub_open_to_first_sent:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from connection open to the first byte of requst sent.
Corresponds to Legacy histogram HTTP_SUB_OPEN_TO_FIRST_SENT in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror:
HTTP_SUB_OPEN_TO_FIRST_SENT
expires: never
sub_open_to_first_received:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from connection open to the first byte received.
Corresponds to Legacy histogram HTTP_SUB_OPEN_TO_FIRST_RECEIVED in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror:
HTTP_SUB_OPEN_TO_FIRST_RECEIVED
expires: never
sub_tls_handshake:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from after the TCP SYN packet is
received to the secure connection is established and ready for HTTP.
Corresponds to Legacy histogram HTTP_SUB_TLS_HANDSHAKE in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_TLS_HANDSHAKE
expires: never
sub_tcp_connection:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP subitem channel, time from the TCP SYN packet is received to
the connection is established and ready for HTTP.
Corresponds to Legacy histogram HTTP_SUB_TCP_CONNECTION_2 in Desktop
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
telemetry_mirror: HTTP_SUB_TCP_CONNECTION_2
expires: never
tls_early_data_negotiated:
type: labeled_counter
labels:
- not_available
- available_and_used
- available_but_not_used
description: >
Sending TLS early data was not possible, possible and used, or possible but not used.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
expires: never
tls_early_data_accepted:
type: labeled_counter
labels:
- accepted
- rejected
description: >
TLS early data was used and it was accepted or rejected by the remote host.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
expires: never
tls_early_data_bytes_written:
type: custom_distribution
unit: byte
range_min: 0
range_max: 60000
bucket_count: 100
histogram_type: exponential
description: >
Amount of bytes sent using TLS early data at the start of a TLS connection for a given channel.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
expires: never
telemetry_mirror: TLS_EARLY_DATA_BYTES_WRITTEN
tls_handshake:
type: timing_distribution
time_unit: millisecond
description: >
In the HTTP page channel, time from after the TCP SYN packet is
received to the secure connection is established and ready for HTTP.
Corresponds to Legacy histogram HTTP_PAGE_TLS_HANDSHAKE in Desktop.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
telemetry_mirror: HTTP_PAGE_TLS_HANDSHAKE
expires: never
http3_tls_handshake: &http3_tls_handshake
type: labeled_timing_distribution
time_unit: millisecond
description: >
In the HTTP channel (keys: uses_http3_page, uses_http3_sub, supports_http3_page, supports_http3_sub), time from secure connection start (after TCP SYN) to ready for HTTP
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
labels:
- uses_http3_page
- uses_http3_sub
- supports_http3_page
- supports_http3_sub
telemetry_mirror: HTTP3_TLS_HANDSHAKE
expires: never
sup_http3_tcp_connection:
<<: *http3_tls_handshake
description: >
In the HTTP channel (keys: supports_http3_page, supports_http3_sub), time from TCP SYN to ready for HTTP
labels:
- supports_http3_page
- supports_http3_sub
telemetry_mirror: SUP_HTTP3_TCP_CONNECTION
expires: never
http3_open_to_first_sent:
<<: *http3_tls_handshake
description: >
In the HTTP channel (keys: uses_http3_page, uses_http3_sub, supports_http3_page, supports_http3_sub), time from open to first byte of request
labels:
- uses_http3_page
- uses_http3_sub
- supports_http3_page
- supports_http3_sub
telemetry_mirror: HTTP3_OPEN_TO_FIRST_SENT
expires: never
http3_first_sent_to_last_received:
<<: *http3_tls_handshake
description: >
In the HTTP channel (keys: uses_http3_page, uses_http3_sub, supports_http3_page, supports_http3_sub), time from first byte of request sent to last byte of response received
labels:
- uses_http3_page
- uses_http3_sub
- supports_http3_page
- supports_http3_sub
telemetry_mirror: HTTP3_FIRST_SENT_TO_LAST_RECEIVED
expires: never
http3_open_to_first_received:
<<: *http3_tls_handshake
description: >
In the HTTP channel (keys: uses_http3_page, uses_http3_sub, supports_http3_page, supports_http3_sub), time from open to first byte of reply received
labels:
- uses_http3_page
- uses_http3_sub
- supports_http3_page
- supports_http3_sub
telemetry_mirror: HTTP3_OPEN_TO_FIRST_RECEIVED
expires: never
http3_complete_load:
<<: *http3_tls_handshake
description: >
In the HTTP channel (keys: uses_http3_page, uses_http3_sub, supports_http3_page, supports_http3_sub), overall load time
labels:
- uses_http3_page
- uses_http3_sub
- supports_http3_page
- supports_http3_sub
telemetry_mirror: HTTP3_COMPLETE_LOAD
expires: never
system_channel_success_or_failure: &system_channel_success_or_failure
type: labeled_counter
description: >
Counts the number of succeeded and failed channels with a system principal to a mozilla domain. Label contains ok or failure reason.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
expires: never
labels:
- ok
- offline
- connectivity
- dns
- connect_fail
- tls_fail
- http_status
- cancel
- timeout
- reset
- refused
- partial
- other
system_channel_update_status:
<<: *system_channel_success_or_failure
description: >
Counts the status of succeeded and failed requests to aus5.mozilla.org
system_channel_addonversion_status:
<<: *system_channel_success_or_failure
description: >
Counts the status of succeeded and failed requests to *.addons.mozilla.org
system_channel_addon_status:
<<: *system_channel_success_or_failure
description: >
Counts the status of succeeded and failed requests to addons.mozilla.org
system_channel_remote_settings_status:
<<: *system_channel_success_or_failure
description: >
Counts the status of succeeded and failed requests to firefox.settings.services.mozilla.com
system_channel_telemetry_status:
<<: *system_channel_success_or_failure
description: >
Counts the status of succeeded and failed requests to incoming.telemetry.mozilla.org
system_channel_other_status:
<<: *system_channel_success_or_failure
description: >
Counts the status of succeeded and failed requests to other mozilla.org domains
networking:
http3_enabled:
type: boolean
description: >
True if HTTP3 is enabled at the start of a session.
This metric was generated to correspond to the Legacy Telemetry
scalar networking.http3_enabled.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- ddamjanovic@mozilla.com
expires: never
telemetry_mirror: NETWORKING_HTTP3_ENABLED
https_rr_prefs_usage:
type: quantity
description: >
A bitfield representation for the usage of HTTPS RR prefs.
bit 0: network.dns.upgrade_with_https_rr is enabled or not.
bit 1: network.dns.use_https_rr_as_altsvc is enabled or not.
bit 2: network.dns.echconfig.enabled is enabled or not.
This metric was generated to correspond to the Legacy Telemetry
scalar networking.https_rr_prefs_usage.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- kershaw@mozilla.com
expires: never
unit: bitfield
telemetry_mirror: NETWORKING_HTTPS_RR_PREFS_USAGE
trr_connection_cycle_count:
type: labeled_counter
description: >
Number of times we cycled the TRR connection during a subsession.
Keyed by TRR provider URL.
This metric was generated to correspond to the Legacy Telemetry
scalar networking.trr_connection_cycle_count.
bugs:
data_reviews:
notification_emails:
- necko@mozilla.com
- nhnt11@mozilla.com
expires: never
telemetry_mirror: NETWORKING_TRR_CONNECTION_CYCLE_COUNT
data_transferred_v3_kb:
type: labeled_counter
description: >
How many KB of HTTP data transferred by type, there are some categories
separated by keys based on 5 parameters:
1. normal browsing or private browsing
2. system principal or not
3. first party or third party
4. class of service (Leader/Background/Others)
5. tracking classification (Basic/Content/FingerprintingContent)
Available keys are:
"Y0_N1Sys",
"Y1_N1",
"Y2_N3Oth",
"Y3_N3BasicLead",
"Y4_N3BasicBg",
"Y5_N3BasicOth",
"Y6_N3ContentLead",
"Y7_N3ContentBg",
"Y8_N3ContentOth",
"Y9_N3FpLead",
"Y10_N3FpBg",
"Y11_N3FpOth",
"Y12_P1Sys",
"Y13_P1",
"Y14_P3Oth",
"Y15_P3BasicLead",
"Y16_P3BasicBg",
"Y17_P3BasicOth",
"Y18_P3ContentLead",
"Y19_P3ContentBg",
"Y20_P3ContentOth",
"Y21_P3FpLead",
"Y22_P3FpBg",
"Y23_P3FpOth"
This metric was generated to correspond to the Legacy Telemetry
scalar networking.data_transferred_v3_kb.
bugs:
data_reviews:
notification_emails:
- arthur@mozilla.com
- tanvi@mozilla.com
- tihuang@mozilla.com
expires: never
telemetry_mirror: NETWORKING_DATA_TRANSFERRED_V3_KB
opaque.response.blocking:
javascript_validation_count:
type: counter
description: >
The number of times we run the JS validator.
This metric was generated to correspond to the Legacy Telemetry
scalar opaque.response.blocking.javascript_validation_count.
bugs:
data_reviews:
notification_emails:
- farre@mozilla.com
expires: never
telemetry_mirror: OPAQUE_RESPONSE_BLOCKING_JAVASCRIPT_VALIDATION_COUNT
cross_origin_opaque_response_count:
type: counter
description: >
The number of loads of cross origin opaque resources.
This metric was generated to correspond to the Legacy Telemetry
scalar opaque.response.blocking.cross_origin_opaque_response_count.
bugs:
data_reviews:
notification_emails:
- farre@mozilla.com
expires: never
telemetry_mirror: OPAQUE_RESPONSE_BLOCKING_CROSS_ORIGIN_OPAQUE_RESPONSE_COUNT