AWS Elemental MediaConnect

Overview

AWS Elemental MediaConnect is a transport service for live video.

Enable this integration to see all your Elemental MediaConnect 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 page, ensure that MediaConnect is enabled under the Metric Collection tab.
  2. Install the Datadog - AWS Elemental MediaConnect integration.

Log collection

Enable logging

Configure AWS Elemental MediaConnect to send logs either to a S3 bucket or to CloudWatch.

Note: If you log to a S3 bucket, make sure that amazon_mediaconnect is set as Target prefix.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.

  2. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your AWS Elemental MediaConnect logs in the AWS console:

Data Collected

Metrics

aws.mediaconnect.arqrecovered
(count)
The number of dropped packets that were recovered by automatic repeat request (ARQ).
Shown as packet
aws.mediaconnect.arqrequests
(count)
The number of retransmitted packets that were requested through automatic repeat request (ARQ) and received.
Shown as request
aws.mediaconnect.bit_rate
(rate)
The average bitrate of the video in bits/sec
Shown as bit
aws.mediaconnect.bit_rate.maximum
(rate)
The maximum bitrate of the video in bits/sec
Shown as bit
aws.mediaconnect.bit_rate.minimum
(rate)
The minimum bitrate of the video in bits/sec
Shown as bit
aws.mediaconnect.caterror
(count)
The number of times that a conditional access table (CAT) error occurred.
Shown as error
aws.mediaconnect.connected
(gauge)
The status of the source (average value). A value of 1 indicates that the source is connected and a value of 0 (zero) indicates that the source is disconnected.
aws.mediaconnect.connected.maximum
(gauge)
The status of the source (maximum value). A value of 1 indicates that the source is connected and a value of 0 (zero) indicates that the source is disconnected.
aws.mediaconnect.connected.minimum
(gauge)
The status of the source (minimum value). A value of 1 indicates that the source is connected and a value of 0 (zero) indicates that the source is disconnected.
aws.mediaconnect.connected_outputs
(gauge)
The average number of outputs that are currently connected.
aws.mediaconnect.connected_outputs.maximum
(gauge)
The maximum number of outputs that are currently connected.
aws.mediaconnect.connected_outputs.minimum
(gauge)
The minimum number of outputs that are currently connected.
aws.mediaconnect.continuity_counter
(count)
The number of times that a continuity error occurred.
Shown as error
aws.mediaconnect.crcerror
(count)
The number of times that a cyclic redundancy check (CRC) error occurred.
Shown as error
aws.mediaconnect.disconnections
(count)
The number of times that the source status changed from connected to disconnected.
aws.mediaconnect.dropped_packets
(count)
The number of packets that were lost during transit. This value is measured before any error correction takes place.
Shown as packet
aws.mediaconnect.failover_switches
(count)
The total number of times the flow switches back and forth between sources when using the Failover mode for source failover.
aws.mediaconnect.fecpackets
(count)
The number of packets that were transmitted using forward error correction (FEC) and received.
Shown as packet
aws.mediaconnect.fecrecovered
(count)
The number of packets that were transmitted using forward error correction (FEC) lost during transit and recovered.
Shown as packet
aws.mediaconnect.maintenance_canceled
(gauge)
Maintenance for this flow is cancelled by MediaConnect.
aws.mediaconnect.maintenance_failed
(gauge)
Maintenance did not complete successfully for this flow.
aws.mediaconnect.maintenance_rescheduled
(gauge)
MediaConnect is unable to perform maintenance at the previously scheduled date and time. A new date and time has been automatically assigned by MediaConnect for this flow's maintenance.
aws.mediaconnect.maintenance_scheduled
(gauge)
Maintenance is scheduled for the flow.
aws.mediaconnect.maintenance_started
(gauge)
Maintenance has started and is currently in progress for this flow.
aws.mediaconnect.maintenance_succeeded
(gauge)
Maintenance completed successfully for this flow.
aws.mediaconnect.merge_active
(gauge)
The merge status of all sources on the flow. A value of 1 indicates that all sources are merged.
aws.mediaconnect.merge_latency
(gauge)
The maximum value for SourceMergeLatency.
Shown as millisecond
aws.mediaconnect.not_recovered_packets
(count)
The number of packets that were lost during transit and never recovered.
Shown as packet
aws.mediaconnect.output_connected
(gauge)
The status of the output (average value). A value of 1 indicates that the source is connected and a value of 0 (zero) indicates that the source is disconnected.
aws.mediaconnect.output_connected.maximum
(gauge)
The status of the output (maximum value). A value of 1 indicates that the source is connected and a value of 0 (zero) indicates that the source is disconnected.
aws.mediaconnect.output_connected.minimum
(gauge)
The status of the output (minimum value). A value of 1 indicates that the source is connected and a value of 0 (zero) indicates that the source is disconnected.
aws.mediaconnect.output_disconnections
(count)
The number of times that the output status changed from connected to disconnected.
aws.mediaconnect.output_dropped_payloads
(count)
Payloads that were lost during transit from MediaConnect to the output. A payload is a frame of video or an audio sample. Payloads can consist of multiple packets. Payload metrics are only applicable when using CDI.
aws.mediaconnect.output_late_payloads
(count)
Packets of a payload that arrive at the output outside of MediaConnect's internal buffer. A payload is a frame of video or an audio sample. Payloads can consist of multiple packets. Payload metrics are only applicable when using CDI.
aws.mediaconnect.output_total_bytes
(count)
Total amount of bytes transferred from MediaConnect to the output.
Shown as byte
aws.mediaconnect.output_total_payloads
(count)
Total amount of payloads delivered from MediaConnect to the output. A payload is a frame of video or an audio sample. Payloads can consist of multiple packets. Payload metrics are only applicable when using CDI.
aws.mediaconnect.overflow_packets
(count)
The number of packets that were lost in transit because the video required more buffer than was available.
Shown as packet
aws.mediaconnect.packet_loss_percent
(gauge)
The average percentage of packets that were lost during transit even if they were recovered.
Shown as percent
aws.mediaconnect.packet_loss_percent.maximum
(gauge)
The maximum percentage of packets that were lost during transit even if they were recovered.
Shown as percent
aws.mediaconnect.packet_loss_percent.minimum
(gauge)
The minimum percentage of packets that were lost during transit even if they were recovered.
Shown as percent
aws.mediaconnect.paterror
(count)
The number of times that a program association table (PAT) error occurred. This error indicates that the PAT is missing.
Shown as error
aws.mediaconnect.pcraccuracy_error
(count)
The number of times that a program clock register (PCR) accuracy error occurred.
Shown as error
aws.mediaconnect.pcrerror
(count)
The number of times that a PCR error occurred. This error happens when PCR values are not sent frequently enough.
Shown as error
aws.mediaconnect.piderror
(count)
The number of times that a packet identifier (PID) error occurred.
Shown as error
aws.mediaconnect.pmterror
(count)
The number of times that a program map table (PMT) error occurred.
Shown as error
aws.mediaconnect.ptserror
(count)
The number of times that a presentation timestamp (PTS) error occurred. This error happens when a presentation timestamp (PTS) is not received at least every 700 ms.
Shown as error
aws.mediaconnect.recovered_packets
(count)
The number of packets that were lost during transit but recovered.
Shown as packet
aws.mediaconnect.round_trip_time
(gauge)
The average amount of time it takes for the source to send a signal and receive an acknowledgement from AWS Elemental MediaConnect.
Shown as millisecond
aws.mediaconnect.round_trip_time.maximum
(gauge)
The maximum amount of time it takes for the source to send a signal and receive an acknowledgement from AWS Elemental MediaConnect MediaConnect.
Shown as millisecond
aws.mediaconnect.round_trip_time.minimum
(gauge)
The minimum amount of time it takes for the source to send a signal and receive an acknowledgement from AWS Elemental MediaConnect MediaConnect.
Shown as millisecond
aws.mediaconnect.source_arqrecovered
(count)
The number of dropped packets that were recovered by automatic repeat request (ARQ). This metric applies only to sources that use the RIST protocol or the Zixi protocol. It doesn't apply to flows that receive content from an entitlement.
Shown as packet
aws.mediaconnect.source_arqrequests
(count)
The number of retransmitted packets that were requested through automatic repeat request (ARQ) and received.
Shown as request
aws.mediaconnect.source_bit_rate
(rate)
The average bitrate of the incoming (source) video.
Shown as bit
aws.mediaconnect.source_bit_rate.maximum
(rate)
The maximum bitrate of the incoming (source) video.
Shown as bit
aws.mediaconnect.source_bit_rate.minimum
(rate)
The minimum bitrate of the incoming (source) video.
Shown as bit
aws.mediaconnect.source_caterror
(count)
The number of times that a conditional access table (CAT) error occurred.
Shown as error
aws.mediaconnect.source_connected
(gauge)
The status of the source (average value). A value of 1 indicates that the source is connected and a value of 0 (zero) indicates that the source is disconnected.
aws.mediaconnect.source_connected.maximum
(gauge)
The status of the source (maximum value). A value of 1 indicates that the source is connected and a value of 0 (zero) indicates that the source is disconnected.
aws.mediaconnect.source_connected.minimum
(gauge)
The status of the source (minimum value). A value of 1 indicates that the source is connected and a value of 0 (zero) indicates that the source is disconnected.
aws.mediaconnect.source_continuity_counter
(count)
The number of times that a continuity error occurred.
Shown as error
aws.mediaconnect.source_crcerror
(count)
The number of times that a cyclic redundancy check (CRC) error occurred.
Shown as error
aws.mediaconnect.source_disconnections
(count)
The number of times that the source status changed from connected to disconnected.
aws.mediaconnect.source_dropped_packets
(count)
The number of packets that were lost during transit. This value is measured before any error correction takes place.
Shown as packet
aws.mediaconnect.source_dropped_payloads
(count)
Payloads that were lost during transit to MediaConnect from the source. A payload is a frame of video or an audio sample. Payloads can consist of multiple packets. Payload metrics are only applicable when using CDI.
aws.mediaconnect.source_fecpackets
(count)
The number of packets that were transmitted using forward error correction (FEC) and received.
Shown as packet
aws.mediaconnect.source_fecrecovered
(count)
The number of packets that were transmitted using forward error correction (FEC) lost during transit and recovered.
Shown as packet
aws.mediaconnect.source_late_payloads
(count)
Packets of a payload that arrive outside of the configured Max sync buffer time frame. A payload is a frame of video or an audio sample. Payloads can consist of multiple packets. Payload metrics are only applicable when using CDI.
aws.mediaconnect.source_merge_active
(gauge)
An indication of the status of the source with respect to other sources. This metric is useful when the flow has multiple sources for failover and you are using the Merge failover mode. A value of 1 indicates that the flow has multiple sources and that this source is actively in use, with 2022-7 merge. A value of 0 (zero) indicates that the flow is not using the source to form the stream.
aws.mediaconnect.source_merge_latency
(gauge)
The average amount of time that this source trails the primary source. If this source is the primary source, the value is 0 (zero).
Shown as millisecond
aws.mediaconnect.source_merge_latency.maximum
(gauge)
The maximum amount of time that this source trails the primary source. If this source is the primary source, the value is 0 (zero).
Shown as millisecond
aws.mediaconnect.source_merge_latency.minimum
(gauge)
The minimum amount of time that this source trails the primary source. If this source is the primary source, the value is 0 (zero).
Shown as millisecond
aws.mediaconnect.source_merge_status_warn_mismatch
(gauge)
A status metric warning that the flow is receiving mismatched sources (average value). This means that any dropped packets will not be recovered and will result in poor network reliability. This metric only applies to sources using merge mode failover.
aws.mediaconnect.source_merge_status_warn_mismatch.maximum
(gauge)
A status metric warning that the flow is receiving mismatched sources (maximum value). This means that any dropped packets will not be recovered and will result in poor network reliability. This metric only applies to sources using merge mode failover.
aws.mediaconnect.source_merge_status_warn_mismatch.minimum
(gauge)
A status metric warning that the flow is receiving mismatched sources (minimum value). This means that any dropped packets will not be recovered and will result in poor network reliability. This metric only applies to sources using merge mode failover.
aws.mediaconnect.source_merge_status_warn_solo
(gauge)
A status metric warning that the flow is only receiving one source (average value). This means any dropped packets will not be recovered and will result in poor network reliability. This metric only applies to sources using merge mode failover.
aws.mediaconnect.source_merge_status_warn_solo.maximum
(gauge)
A status metric warning that the flow is only receiving one source (maximum value). This means any dropped packets will not be recovered and will result in poor network reliability. This metric only applies to sources using merge mode failover.
aws.mediaconnect.source_merge_status_warn_solo.minimum
(gauge)
A status metric warning that the flow is only receiving one source (minimum value). This means any dropped packets will not be recovered and will result in poor network reliability. This metric only applies to sources using merge mode failover.
aws.mediaconnect.source_missing_packets
(count)
A packet was missing from both source streams, this means the packet could not be recovered. This metric only applies to sources using merge mode failover.
Shown as packet
aws.mediaconnect.source_not_recovered_packets
(count)
The number of packets that were lost during transit and were not recovered by error correction.
Shown as packet
aws.mediaconnect.source_overflow_packets
(count)
The number of packets that were lost in transit because the video required more buffer than was available.
Shown as packet
aws.mediaconnect.source_packet_loss_percent
(gauge)
The average percentage of packets that were lost during transit even if they were recovered.
Shown as percent
aws.mediaconnect.source_packet_loss_percent.maximum
(gauge)
The maximum percentage of packets that were lost during transit even if they were recovered.
Shown as percent
aws.mediaconnect.source_packet_loss_percent.minimum
(gauge)
The minimum percentage of packets that were lost during transit even if they were recovered.
Shown as percent
aws.mediaconnect.source_paterror
(count)
The number of times that a program association table (PAT) error occurred. This error indicates that the PAT is missing.
Shown as error
aws.mediaconnect.source_pcraccuracy_error
(count)
The number of times that a program clock register (PCR) accuracy error occurred.
Shown as error
aws.mediaconnect.source_pcrerror
(count)
The number of times that a PCR error occurred. This error happens when PCR values are not sent frequently enough.
Shown as error
aws.mediaconnect.source_piderror
(count)
The number of times that a packet identifier (PID) error occurred.
Shown as error
aws.mediaconnect.source_pmterror
(count)
The number of times that a program map table (PMT) error occurred.
Shown as error
aws.mediaconnect.source_ptserror
(count)
The number of times that a presentation timestamp (PTS) error occurred. This error happens when a presentation timestamp (PTS) is not received at least every 700 ms.
Shown as error
aws.mediaconnect.source_recovered_packets
(count)
The number of packets that were lost during transit but recovered.
Shown as packet
aws.mediaconnect.source_round_trip_time
(gauge)
The average amount of time it takes for the source to send a signal and receive an acknowledgement from AWS Elemental MediaConnect.
Shown as millisecond
aws.mediaconnect.source_round_trip_time.maximum
(gauge)
The maximum amount of time it takes for the source to send a signal and receive an acknowledgement from AWS Elemental MediaConnect MediaConnect.
Shown as millisecond
aws.mediaconnect.source_round_trip_time.minimum
(gauge)
The minimum amount of time it takes for the source to send a signal and receive an acknowledgement from AWS Elemental MediaConnect MediaConnect.
Shown as millisecond
aws.mediaconnect.source_selected
(gauge)
An indication if a source is being used as the input for flow ingest.
aws.mediaconnect.source_total_bytes
(count)
Total amount of bytes transferred to MediaConnect from the source.
Shown as byte
aws.mediaconnect.source_total_packets
(count)
The total number of packets that were received.
Shown as packet
aws.mediaconnect.source_total_payloads
(count)
Total amount of payloads delivered to MediaConnect from the source. A payload is a frame of video or an audio sample. Payloads can consist of multiple packets. Payload metrics are only applicable when using CDI.
aws.mediaconnect.source_transport_error
(count)
The number of times that a primary transport error occurred.
Shown as error
aws.mediaconnect.source_tsbyte_error
(count)
The number of times that a transport stream (TS) byte error occurred.
Shown as error
aws.mediaconnect.source_tssync_loss
(count)
The number of times that a TS sync loss error occurred.
Shown as error
aws.mediaconnect.total_packets
(count)
The total number of packets that were received.
Shown as packet
aws.mediaconnect.transport_error
(count)
The number of times that a primary transport error occurred.
Shown as error
aws.mediaconnect.tsbyte_error
(count)
The number of times that a transport stream (TS) byte error occurred.
Shown as error
aws.mediaconnect.tssync_loss
(count)
The number of times that a TS sync loss error occurred.
Shown as error

Events

The AWS Elemental MediaConnect integration does not include any events.

Service Checks

The AWS Elemental MediaConnect integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.