Amazon MediaLive

Overview

AWS Elemental MediaLive is a broadcast-grade live video processing service.

Enable this integration to see all your MediaLive metrics in Datadog.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. In the AWS integration tile, ensure that MediaLive is checked under metric collection.
  2. Install the Datadog - MediaLive integration.

Data Collected

Metrics

aws.medialive.active_alerts
(gauge)
The average number of alerts that are active.
aws.medialive.active_alerts.maximum
(gauge)
The maximum number of alerts that are active.
aws.medialive.active_alerts.minimum
(gauge)
The minimum number of alerts that are active.
aws.medialive.fec_row_packets_received
(count)
The number of forward error correction (FEC) row packets received on both FEC streams (port 5002 and port 5004). A non-zero value indicates that FEC is functioning. This metric is useful only if the channel has an RTP input that includes FEC.
Shown as packet
aws.medialive.fec_column_packets_received
(count)
The number of FEC column packets received on both FEC streams (port 5002 and port 5004). A non-zero value indicates that FEC is functioning. This metric is useful only if the channel has an RTP input that includes FEC.
Shown as packet
aws.medialive.input_timecodes_present
(gauge)
Average value of an indicator of whether a pipeline is receiving input that includes embedded timecodes. The embedded timecode might be embedded in the source, or it might be embedded in SMPTE-2038 ancillary data. 0 (false) means it isn't present. 1 (true) means it is present.
aws.medialive.input_timecodes_present.maximum
(gauge)
Maximum value of an indicator of whether a pipeline is receiving input that includes embedded timecodes. The embedded timecode might be embedded in the source, or it might be embedded in SMPTE-2038 ancillary data. 0 (false) means it isn't present. 1 (true) means it is present.
aws.medialive.input_timecodes_present.minimum
(gauge)
Minimum value of an indicator of whether a pipeline is receiving input that includes embedded timecodes. The embedded timecode might be embedded in the source, or it might be embedded in SMPTE-2038 ancillary data. 0 (false) means it isn't present. 1 (true) means it is present.
aws.medialive.input_video_frame_rate
(rate)
The average frame rate of the source video. This metric is an indicator of the health of the input. If the value isn't stable, investigate to determine any problems with your source or the network between MediaLive and the upstream system.
aws.medialive.input_video_frame_rate.maximum
(rate)
The maximum frame rate of the source video. This metric is an indicator of the health of the input. If the value isn't stable, investigate to determine any problems with your source or the network between MediaLive and the upstream system.
aws.medialive.input_video_frame_rate.minimum
(rate)
The minimum frame rate of the source video. This metric is an indicator of the health of the input. If the value isn't stable, investigate to determine any problems with your source or the network between MediaLive and the upstream system.
aws.medialive.network_in
(gauge)
The average rate of traffic coming into MediaLive. This number includes all traffic received into MediaLive-push inputs, pull inputs, responses from the upstream system of a pull input, responses from the downstream system for any output, and instance traffic such as DNS resolution and NTP. Even when a channel is not ingesting, there is some traffic.
aws.medialive.network_in.maximum
(gauge)
The maximum rate of traffic coming into MediaLive. This number includes all traffic received into MediaLive-push inputs, pull inputs, responses from the upstream system of a pull input, responses from the downstream system for any output, and instance traffic such as DNS resolution and NTP. Even when a channel is not ingesting, there is some traffic.
aws.medialive.network_in.minimum
(gauge)
The minimum rate of traffic coming into MediaLive. This number includes all traffic received into MediaLive-push inputs, pull inputs, responses from the upstream system of a pull input, responses from the downstream system for any output, and instance traffic such as DNS resolution and NTP. Even when a channel is not ingesting, there is some traffic.
aws.medialive.primary_input_active
(gauge)
Average value of an indicator of whether the primary input in an automatic input failover pair is active. A value of 1 means that the primary input is active and is therefore healthy. A value of 0 means that it is inactive.
aws.medialive.primary_input_active.maximum
(gauge)
Maximum value of an indicator of whether the primary input in an automatic input failover pair is active. A value of 1 means that the primary input is active and is therefore healthy. A value of 0 means that it is inactive.
aws.medialive.primary_input_active.minimum
(gauge)
Minimum value of an indicator of whether the primary input in an automatic input failover pair is active. A value of 1 means that the primary input is active and is therefore healthy. A value of 0 means that it is inactive.
aws.medialive.rtp_packets_lost
(count)
The number of RTP packets that are lost in the incoming transmission. Lost means packets that couldn't be recovered by FEC.
Shown as packet
aws.medialive.rtp_packets_received
(count)
The number of RTP packets received in an RTP input. This number includes the main RTP source (port 5000) and the FEC data (ports 5002 and 5004).
Shown as packet
aws.medialive.rtp_packets_recovered_via_fec
(count)
The number of RTP packets recovered through FEC.
Shown as packet
aws.medialive.udp_input_loss_seconds
(count)
The number of seconds (the input loss period) for which the channel has not received packets from the source of an RTP or MediaConnect input. Each datapoint has a value between 0 and 10 seconds.
Shown as second
aws.medialive.channel_input_error_seconds
(count)
The number of seconds in which the channel input contained one or more unrecoverable packets.
Shown as second
aws.medialive.active_outputs
(gauge)
The average number of outputs that are being produced and successfully written to the destination.
aws.medialive.active_outputs.maximum
(gauge)
The maximum number of outputs that are being produced and successfully written to the destination.
aws.medialive.active_outputs.minimum
(gauge)
The minimum number of outputs that are being produced and successfully written to the destination.
aws.medialive.fill_msec
(gauge)
The average current length of time (the fill period) during which MediaLive has filled the video output with fill frames. The fill period starts when the pipeline does not receive content from the input within the expected time.
Shown as millisecond
aws.medialive.fill_msec.maximum
(gauge)
The maximum current length of time (the fill period) during which MediaLive has filled the video output with fill frames. The fill period starts when the pipeline does not receive content from the input within the expected time.
Shown as millisecond
aws.medialive.fill_msec.minimum
(gauge)
The minimum current length of time (the fill period) during which MediaLive has filled the video output with fill frames. The fill period starts when the pipeline does not receive content from the input within the expected time.
Shown as millisecond
aws.medialive.output_audio_level_dbfs
(gauge)
The average output audio level in decibels relative to full scale (dBFS).
aws.medialive.output_audio_level_dbfs.maximum
(gauge)
The maximum output audio level in decibels relative to full scale (dBFS).
aws.medialive.output_audio_level_dbfs.minimum
(gauge)
The minimum output audio level in decibels relative to full scale (dBFS).
aws.medialive.output_audio_level_lkfs
(gauge)
The average output audio level in loudness, K-weighted, relative to full scale (LKFS).
aws.medialive.output_audio_level_lkfs.maximum
(gauge)
The maximum output audio level in loudness, K-weighted, relative to full scale (LKFS).
aws.medialive.output_audio_level_lkfs.minimum
(gauge)
The minimum output audio level in loudness, K-weighted, relative to full scale (LKFS).
aws.medialive.network_out
(gauge)
The average rate of traffic out of MediaLive. This number includes all traffic sent from MediaLive - the media output, HTTP GET requests for pull inputs, NTP traffic, and DNS traffic. Even when a channel is not delivering output, there is some traffic.
aws.medialive.network_out.maximum
(gauge)
The maximum rate of traffic out of MediaLive. This number includes all traffic sent from MediaLive - the media output, HTTP GET requests for pull inputs, NTP traffic, and DNS traffic. Even when a channel is not delivering output, there is some traffic.
aws.medialive.network_out.minimum
(gauge)
The minimum rate of traffic out of MediaLive. This number includes all traffic sent from MediaLive - the media output, HTTP GET requests for pull inputs, NTP traffic, and DNS traffic. Even when a channel is not delivering output, there is some traffic.
aws.medialive.output_4xx_errors
(count)
The number of 4xx HTTP errors that have been received from the destination while delivering output.
Shown as error
aws.medialive.output_5xx_errors
(count)
The number of 5xx HTTP errors that have been received from the destination while delivering output.
Shown as error
aws.medialive.using_sdi
(gauge)
Indicates if SDI is the currently selected input for the device. Average value over time period.
aws.medialive.using_sdi.maximum
(gauge)
Indicates if SDI is the currently selected input for the device. Maximum value over time period.
aws.medialive.using_sdi.minimum
(gauge)
Indicates if SDI is the currently selected input for the device. Minimum value over time period.
aws.medialive.using_hdmi
(gauge)
Indicates if HDMI is the currently selected input for the device. Average value over time period.
aws.medialive.using_hdmi.maximum
(gauge)
Indicates if HDMI is the currently selected input for the device. Maximum value over time period.
aws.medialive.using_hdmi.minimum
(gauge)
Indicates if HDMI is the currently selected input for the device. Minimum value over time period.
aws.medialive.input_locked
(gauge)
Indicates if the device has successfully locked on to the input signal. Average value of indicator over time.
aws.medialive.input_locked.maximum
(gauge)
Indicates if the device has successfully locked on to the input signal (maximum value of indicator over time).
aws.medialive.input_locked.minimum
(gauge)
Indicates if the device has successfully locked on to the input signal (minimum value of indicator over time).
aws.medialive.encoder_running
(gauge)
Indicator of whether the encoder is successfully processing the input signal (average value over time).
aws.medialive.encoder_running.maximum
(gauge)
Indicator of whether the encoder is successfully processing the input signal (maximum value over time).
aws.medialive.encoder_running.minimum
(gauge)
Indicator of whether the encoder is successfully processing the input signal (minimum value over time).
aws.medialive.linked_to_stream_endpoint
(gauge)
The device is connected to the streaming endpoint in AWS (average value over time).
aws.medialive.linked_to_stream_endpoint.maximum
(gauge)
The device is connected to the streaming endpoint in AWS (maximum value over time).
aws.medialive.linked_to_stream_endpoint.minimum
(gauge)
The device is connected to the streaming endpoint in AWS (minimum value over time).
aws.medialive.streaming
(gauge)
The device is successfully streaming the input signal to MediaLive (average value over time).
aws.medialive.streaming.maximum
(gauge)
The device is successfully streaming the input signal to MediaLive (maximum value over time).
aws.medialive.streaming.minimum
(gauge)
The device is successfully streaming the input signal to MediaLive (minimum value over time).
aws.medialive.temperature
(gauge)
The average device temperature in degrees Celsius. Consult your device's documentation for recommended operating conditions.
Shown as degree celsius
aws.medialive.temperature.maximum
(gauge)
The maximum device temperature in degrees Celsius. Consult your device's documentation for recommended operating conditions.
Shown as degree celsius
aws.medialive.temperature.minimum
(gauge)
The minimum device temperature in degrees Celsius. Consult your device's documentation for recommended operating conditions.
Shown as degree celsius
aws.medialive.configured_bitrate
(rate)
The average configured Maximum bitrate.
Shown as bit
aws.medialive.configured_bitrate.p90
(rate)
The 90th percentile configured Maximum bitrate.
Shown as bit
aws.medialive.encoder_bitrate
(rate)
The average actively encoded bitrate.
Shown as bit
aws.medialive.encoder_bitrate.p90
(rate)
The 90th percentile actively encoded bitrate.
Shown as bit
aws.medialive.configured_bitrate_available
(gauge)
The average portion of Configured bitrate that the device can satisfy based on network conditions.
Shown as percent
aws.medialive.configured_bitrate_available.p90
(gauge)
The 90th percentile of the portion of Configured bitrate that the device can satisfy based on network conditions.
Shown as percent
aws.medialive.total_packets
(count)
The total number of packets that were successfully delivered to the AWS streaming endpoint.
Shown as packet
aws.medialive.recovered_packets
(count)
The number of packets that were lost during transit, but recovered by error correction.
Shown as packet
aws.medialive.not_recovered_packets
(count)
The number of packets that were lost during transit and were not recovered by error correction.
Shown as packet
aws.medialive.error_seconds
(count)
The number of seconds in which one or more packets were dropped and not recovered.
Shown as second
aws.medialive.pipelines_locked
(gauge)
Average value of an indicator of whether the two pipelines are synchronized with each other. This metric applies only to standard channels and only to HLS, MediaPackage, Microsoft Smooth, and UDP outputs in that channel. MediaLive uses pipeline locking to ensure that the two pipelines are synchronized with each other.
aws.medialive.pipelines_locked.maximum
(gauge)
Maximum value of an indicator of whether the two pipelines are synchronized with each other. This metric applies only to standard channels and only to HLS, MediaPackage, Microsoft Smooth, and UDP outputs in that channel. MediaLive uses pipeline locking to ensure that the two pipelines are synchronized with each other.
aws.medialive.pipelines_locked.minimum
(gauge)
Minimum value of an indicator of whether the two pipelines are synchronized with each other. This metric applies only to standard channels and only to HLS, MediaPackage, Microsoft Smooth, and UDP outputs in that channel. MediaLive uses pipeline locking to ensure that the two pipelines are synchronized with each other.
aws.medialive.output_video_frame_rate
(rate)
Average frame rate of the output video.
aws.medialive.output_video_frame_rate.maximum
(rate)
Maximum frame rate of the output video.
aws.medialive.output_video_frame_rate.minimum
(rate)
Minimum frame rate of the output video.
aws.medialive.svq_time
(gauge)
The percentage of time, averaged over the last 10 seconds, that the encoder has reduced quality optimizations to speed up the encode process so MediaLive can continue running in real time.
Shown as percent

Events

The MediaLive integration does not include any events.

Service Checks

The MediaLive integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.