--- title: Amazon MediaConvert description: Formats & compresses video content for televisions and connected devices breadcrumbs: Docs > Integrations > Amazon MediaConvert --- # Amazon MediaConvert Integration version1.1.0 {% callout %} # Important note for users on the following Datadog sites: us2.ddog-gov.com {% alert level="info" %} To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator. To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com). {% /alert %} {% /callout %} ## Overview{% #overview %} AWS Elemental MediaConvert is a service that formats and compresses offline video content for delivery to televisions or connected devices. Enable this integration to see all your Elemental MediaConvert metrics in Datadog. ## Setup{% #setup %} ### Installation{% #installation %} If you haven't already, set up the [Amazon Web Services integration](https://docs.datadoghq.com/integrations/amazon_web_services.md) first. ### Metric collection{% #metric-collection %} 1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `MediaConvert` is enabled under the `Metric Collection` tab. 1. Install the [Datadog - AWS Elemental MediaConvert integration](https://app.datadoghq.com/integrations/amazon-mediaconvert). ### Log collection{% #log-collection %} #### Enable logging{% #enable-logging %} Configure AWS Elemental MediaConvert to send logs to either an S3 bucket or to CloudWatch. **Note**: If you log to an S3 bucket, make sure that `amazon_mediaconvert` is set as *Target prefix*. #### Send logs to Datadog{% #send-logs-to-datadog %} 1. If you haven't already, set up the [Datadog Forwarder Lambda function](https://docs.datadoghq.com/logs/guide/forwarder.md). 1. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your AWS Elemental MediaConvert logs in the AWS console: - [Add a manual trigger on the S3 bucket](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md#collecting-logs-from-s3-buckets) - [Add a manual trigger on the CloudWatch Log Group](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md#collecting-logs-from-cloudwatch-log-group) ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} | | | | | **aws.mediaconvert.8k\_output\_duration**(count) | The number of milliseconds of 8K output for a queue.*Shown as millisecond* | | **aws.mediaconvert.audio\_output\_duration**(count) | The number of milliseconds of audio-only output for a queue.*Shown as millisecond* | | **aws.mediaconvert.avg\_bitrate\_bottom**(gauge) | The average bitrate of the lowest bitrate output in the output group.*Shown as bit* | | **aws.mediaconvert.avg\_bitrate\_top**(gauge) | The average bitrate of the highest bitrate output in the output group.*Shown as bit* | | **aws.mediaconvert.black\_video\_detected**(count) | The total duration of black video frames in your output that are also present in your input, in milliseconds. Does not include black frames inserted by MediaConvert.*Shown as millisecond* | | **aws.mediaconvert.black\_video\_detected\_ratio**(gauge) | The ratio of black video frames to the total duration of your output. Higher ratios indicate outputs with more black frames.*Shown as fraction* | | **aws.mediaconvert.errors**(count) | The number of errors caused by invalid operation parameters such as a request for a job status that does not include the job ID.*Shown as error* | | **aws.mediaconvert.hdoutput\_duration**(count) | The number of milliseconds of high-definition (HD) output for a queue.*Shown as millisecond* | | **aws.mediaconvert.jobs\_canceled\_count**(count) | The number of jobs canceled in a queue.*Shown as job* | | **aws.mediaconvert.jobs\_completed\_count**(count) | The number of jobs completed in this queue.*Shown as job* | | **aws.mediaconvert.jobs\_errored\_count**(count) | The number of jobs that failed because of invalid inputs.*Shown as job* | | **aws.mediaconvert.longest\_black\_segment\_detected**(gauge) | The longest continuous segment of black video frames in your output, in milliseconds.*Shown as millisecond* | | **aws.mediaconvert.qvbr\_avg\_quality\_high\_bitrate**(gauge) | The average QVBR quality score of the highest bitrate output in the output group. | | **aws.mediaconvert.qvbr\_avg\_quality\_low\_bitrate**(gauge) | The average QVBR quality score of the lowest bitrate output in the output group. | | **aws.mediaconvert.qvbr\_min\_quality\_high\_bitrate**(gauge) | The minimum QVBR quality score of the highest bitrate output in the output group. | | **aws.mediaconvert.qvbr\_min\_quality\_low\_bitrate**(gauge) | The minimum QVBR quality score of the lowest bitrate output in the output group. | | **aws.mediaconvert.sdoutput\_duration**(count) | The number of milliseconds of standard definition (SD) output for a queue.*Shown as millisecond* | | **aws.mediaconvert.standby\_time**(count) | The number of milliseconds before AWS Elemental MediaConvert starts transcoding a job.*Shown as millisecond* | | **aws.mediaconvert.standby\_time.average**(gauge) | The average number of milliseconds before AWS Elemental MediaConvert starts transcoding a job.*Shown as millisecond* | | **aws.mediaconvert.transcoding\_time**(count) | The number of milliseconds for AWS Elemental MediaConvert to complete transcoding.*Shown as millisecond* | | **aws.mediaconvert.transcoding\_time.average**(gauge) | The average number of milliseconds for AWS Elemental MediaConvert to complete transcoding.*Shown as millisecond* | | **aws.mediaconvert.uhdoutput\_duration**(count) | The number of milliseconds of ultra-high-definition (UHD) output for a queue.*Shown as millisecond* | | **aws.mediaconvert.video\_padding\_inserted**(count) | The total duration of blank frames MediaConvert inserted across all outputs in your job, in milliseconds.*Shown as millisecond* | | **aws.mediaconvert.video\_padding\_inserted\_ratio**(gauge) | The ratio of blank frames MediaConvert inserted to the overall duration of your output. Higher ratios may signal audio and video sync issues in your input.*Shown as fraction* | ### Events{% #events %} The AWS Elemental MediaConvert integration does not include any events. ### Service Checks{% #service-checks %} The AWS Elemental MediaConvert integration does not include any service checks. ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).