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 :: Audio/Video'
gmp:
update_xml_fetch_result:
type: labeled_counter
labels:
- cert_pin_success
- cert_pin_net_request_error
- cert_pin_net_timeout
- cert_pin_abort
- cert_pin_missing_data
- cert_pin_failed
- cert_pin_invalid
- cert_pin_xml_parse_error
- cert_pin_unknown_error
- content_sig_success
- content_sig_net_request_error
- content_sig_net_timeout
- content_sig_abort
- content_sig_missing_data
- content_sig_failed
- content_sig_invalid
- content_sig_xml_parse_error
- content_sig_unknown_error
description: >
The result of Gecko fetching an update.xml from Balrog.
This captures 3 different data points: success or failure of the request,
if cert pinning or content signatures were used to verify the result, and
the reason for failure, if the request failed.
metadata:
tags:
- 'Core :: Audio/Video: GMP'
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- media-alerts@mozilla.com
expires: never
media.audio:
init_failure:
type: labeled_counter
labels:
- first
- other
description: >
Failure occurs when initializing the audio stream.
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- media-alerts@mozilla.com
expires: never
backend:
type: labeled_counter
labels:
- unknown
- audiounit
- audiounit-rust
- aaudio
- opensl
- wasapi
- winmm
- alsa
- jack
- oss
- pulse
- pulse-rust
- sndio
- sunaudio
description: >
The operating system audio backend
(Migrated from the geckoview metric of the same name).
bugs:
data_reviews:
notification_emails:
- media-alerts@mozilla.com
expires: never
media.playback:
first_frame_loaded:
type: event
description:
The time that the media pipeline takes to load the first video frame.
metadata:
tags:
- 'Core :: Audio/Video: Playback'
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- media-alerts@mozilla.com
extra_keys:
first_frame_loaded_time:
description:
How long (in milliseconds) does the our media pipeline take to load
the first video frame from "the creation of MDSM" to "the first frame
loaded".
type: quantity
metadata_loaded_time:
description:
How long (in milliseconds) does the our media pipeline take to load
the metadata, which happens before finishing loading the first frame.
type: quantity
total_waiting_data_time:
description:
How long (in milliseconds) does the our media pipeline has been in a
state of waiting video data due to lacking of data before the first
frame is loaded.
type: quantity
buffering_time:
description:
How long (in milliseconds) does the our media pipeline has been spent
on the buffering state before the first frame is loaded.
type: quantity
playback_type:
description:
The type of the playback. The value could be one of following
(1) Non-MSE playback
(2) MSE playback
(3) EME playback
// Following are Windows-only
(4) Non-MSE media-engine playback
(5) MSE media-engine playback
(6) EME media-engine playback
type: string
video_codec:
description: The video codec used for playback
type: string
resolution:
description: The video resolution used for playback
type: string
key_system:
description: The key system used for the EME playback if exists
type: string
hls_decoder:
description:
This value will only be set on Android. It tells that whether playback
is performed by the HLS decoder, which utilizes the external player to
play video.
type: boolean
is_hardware_decoding:
description: True if the first frame is decoded by a hardware decoder.
type: boolean
expires: never
device_hardware_decoder_support:
type: labeled_boolean
description:
The results of hardware decoder support for different video codecs. True
means that codec can be decoded by hardware on user's device.
metadata:
tags:
- 'Core :: Audio/Video: Playback'
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- media-alerts@mozilla.com
expires: never
labels:
- h264
- vp8
- vp9
- av1
- hevc
telemetry_mirror: MEDIA_DEVICE_HARDWARE_DECODING_SUPPORT
not_supported_video_per_mime_type:
type: labeled_counter
description:
Count the amount of times where video playback is failed to start due to the mime type is not supported by Firefox. The result is accumulated per mime type, eg. video/hevc.
bugs:
data_reviews:
notification_emails:
- media-alerts@mozilla.com
expires: never
decode_error:
type: event
description: >
Record the decode error details.
metadata:
tags:
- 'Core :: Audio/Video: Playback'
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- media-alerts@mozilla.com
extra_keys:
mime_type:
description: The mime type of the media track when the error occurred.
type: string
error_name:
description: The name of the error.
type: string
key_system:
description: >
The value indicates the key system in use when the error occurred. It
will be null if the error is related to non-EME playback.
type : string
expires: never
media:
element_in_page_count:
type: counter
description: >
The number of times a document hierarchy contained at least one
HTMLMediaElement. In addition, the telemetry probe
'MIXED_CONTENT_UNBLOCK_COUNTER' records the total number of loaded
top level content documents, which can help us calculate the result
of the percentage of documents using media.
This metric was generated to correspond to the Legacy Telemetry
scalar media.element_in_page_count.
bugs:
data_reviews:
notification_emails:
- media-alerts@mozilla.com
expires: never
telemetry_mirror: MEDIA_ELEMENT_IN_PAGE_COUNT
video_hardware_decoding_support:
type: labeled_boolean
description: >
Record whether hardware decoding is supported for the specific video
codec. The key is the type of video codec, eg. video/vp9.
This metric was generated to correspond to the Legacy Telemetry
scalar media.video_hardware_decoding_support.
metadata:
permit_non_commutative_operations_over_ipc: true
bugs:
data_reviews:
notification_emails:
- media-alerts@mozilla.com
expires: never
telemetry_mirror: MEDIA_VIDEO_HARDWARE_DECODING_SUPPORT
video_hd_hardware_decoding_support:
type: labeled_boolean
description: >
Record whether hardware decoding is supported for the specific video
codec, this only records video in HD (1280*720) or higher resultion.
The key is the type of video codec, eg. video/vp9.
This metric was generated to correspond to the Legacy Telemetry
scalar media.video_hd_hardware_decoding_support.
metadata:
permit_non_commutative_operations_over_ipc: true
bugs:
data_reviews:
notification_emails:
- media-alerts@mozilla.com
expires: never
telemetry_mirror: MEDIA_VIDEO_HD_HARDWARE_DECODING_SUPPORT
error:
type: event
description: >
Record the error details happened on a media element.
metadata:
tags:
- 'Core :: Audio/Video: Playback'
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- media-alerts@mozilla.com
extra_keys:
error_type:
description: The error type defined in MediaError.webidl.
type: string
error_name:
description: The name of the internal error.
type: string
key_system:
description: >
The value indicates the key system in use when the error occurred. It
will be null if the error is related to non-EME playback.
type : string
expires: never