User Guide

Using CloudWatch Events to Monitor AWS Elemental MediaConvert Jobs

You can use Amazon CloudWatch Events to notify you when your job status changes, to receive information about completed jobs, and to trigger automated actions in other AWS services when these events happen. Here are some examples of what you can do with CloudWatch Events:

  • You can use CloudWatch Events to monitor the progress of your job.

    STATUS_UPDATE events provide information about what phase your job is in (PROBING, TRANSCODING, and UPLOADING). For some jobs, AWS Elemental MediaConvert provides an estimate of how far your job has progressed, shown as a percentage of the total time from when your job leaves its queue to when your output files appear in your output Amazon S3 bucket.

  • You can set up CloudWatch Events to notify you through email if one of your AWS Elemental MediaConvert jobs fails.

    For a tutorial on setting up this CloudWatch Events event rule, see Tutorial: Setting Up Email Notifications for Failed Jobs.

  • You can use COMPLETE events to programmatically receive the file name and location of the job's outputs.

    For more information, see Output File Names and Paths.

  • You can set up CloudWatch Events so that a Lambda function initiates your post-processing code after your job finishes.

    For more information about using AWS Lambda with MediaConvert, see one of these resources:

    • For experienced cloud architects, see the Video on Demand on AWS post on the AWS Answers blog.

    • For developers new to MediaConvert and Lambda, see the Automating MediaConvert Jobs with Lambda tutorial on GitHub. This tutorial is part of the Simple VOD Workflow series of tutorials on using MediaConvert to create video on demand (VOD).

To set up CloudWatch Events, you create a rule that links MediaConvert and the service that responds to your job status change, such as Amazon Simple Notification Service (SNS) or AWS Lambda. The following illustration shows these two parts of CloudWatch Events rules.

                CloudWatch Events rules bring together an event source and a target.

For more information about the events that MediaConvert can send in the CloudWatch Events event stream, see AWS Elemental MediaConvert Events.