Select Language:
How to Understand MediaConvert Error Events and Find Out What Failed
If you’re using AWS MediaConvert and your job encounters an error, you’ll receive an event with the status “ERROR.” However, knowing what this event contains and how to interpret it can be tricky. Here’s a simple guide to help you understand these events and find the details you need to troubleshoot effectively.
When MediaConvert reports an error, the event typically has a basic structure. It includes general information like version, event ID, source, account, timestamp, and region. In addition, it lists the job’s Amazon Resource Name (ARN) and provides details about the error itself—like the error code and an error message. This information helps you understand what went wrong at a high level.
One important thing to remember is that this error event doesn’t usually include detailed information about individual output files. It doesn’t show which outputs were successful or provide file paths for completed outputs. Instead, it simply states that there was a problem with the job overall. This means that if some parts of your job finished successfully, you might not see that detail within the error event.
Additionally, the event does not break down the status for each individual output. The “ERROR” status applies to the entire job. So, even if some outputs processed correctly, the job will still be marked as failed if one output encounters an error.
When a MediaConvert job fails, no output files are saved to your Amazon S3 bucket. This is because MediaConvert follows an all-or-nothing approach—if there’s an error, none of the outputs are stored, even if parts of the job actually finished successfully before the error happened.
To get more detailed information about which outputs failed or succeeded, you need to use the MediaConvert API. By querying additional job details through the API, you can see specific output statuses, error details for individual files, and troubleshoot more precisely.
If you want to learn more, check the official AWS MediaConvert documentation. It provides extensive guidance on error events and how to monitor job progress, helping you troubleshoot any issues more efficiently.
Add us on ChatGPT
Add us on Perplexity
