View a markdown version of this page

Tracing API errors using request ID - Dynamic Image Transformation for Amazon CloudFront

Tracing API errors using request ID

Problem: Need to identify the root cause of API errors or failed image processing requests.

Solution: Each API response includes an x-amz-request-id header that can be used to trace the request in CloudWatch logs:

  1. Capture the x-amz-request-id from the API response headers

  2. Navigate to the CloudWatch console

  3. Go to Log groups

  4. Find the log group for the image processing service:

    • Lambda architecture: Look for the Lambda function log group

    • ECS architecture: Look for the ECS task log group

  5. Search for the request ID in the logs:

    • Use the CloudWatch Logs Insights query: fields @timestamp, @message | filter @message like /REQUEST_ID/

    • Replace REQUEST_ID with the actual request ID value

  6. Review the log entries to identify error messages, stack traces, or processing details

The request ID allows you to trace the complete request lifecycle and identify exactly where errors occurred during image processing.