Tracing Amazon S3 requests using Amazon X-Ray - Amazon Simple Storage Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Tracing Amazon S3 requests using Amazon X-Ray

Amazon X-Ray collects data about requests that your application serves. You can then view and filter the data to identify and troubleshoot performance issues and errors in your distributed applications and micro-services architecture. For any traced request to your application, it shows you detailed information about the request, the response, and the calls that your application makes to downstream Amazon resources, micro-services, databases, and HTTP web APIs.

For more information, see What is Amazon X-Ray? in the Amazon X-Ray Developer Guide.

How X-Ray works with Amazon S3

Amazon X-Ray supports trace context propagation for Amazon S3, so you can view end-to-end requests as they travel through your entire application. X-Ray aggregates the data that is generated by the individual services such as Amazon S3, Amazon Lambda, and Amazon EC2, and the many resources that make up your application. It provides you with an overall view of how your application is performing.

Amazon S3 integrates with X-Ray to propagate trace context and give you one request chain with upstream and downstream nodes. If an upstream service includes a valid-formatted trace header with its S3 request, Amazon S3 passes the trace header when delivering event notifications to downstream services such as Lambda, Amazon SQS, and Amazon SNS. If you have all these services actively integrated with X-Ray, they are linked in one request chain to give you the complete details of your Amazon S3 requests.

To send X-Ray trace headers through Amazon S3, you must include a formatted X-Amzn-Trace-Id in your requests. You can also instrument the Amazon S3 client using the Amazon X-Ray SDKs. For a list of the supported SDKs, see the Amazon X-Ray documentation.

Service maps

X-Ray service maps show you the relationships between Amazon S3 and other Amazon services and resources in your application in near-real time. To see the end-to-end requests using the X-Ray service maps, you can use the X-Ray console to view a map of the connections between Amazon S3 and other services that your application uses. You can easily detect where high latency is occurring, visualize node distribution for these services, and then drill down into the specific services and paths impacting application performance.

X-Ray Analytics

You can also use the X-Ray Analytics console to analyze traces, view metrics such as latency and failure rates, and generate insights to help you identify and troubleshoot issues. This console also shows you metrics such as average latency and failure rates. For more information, see Amazon X-Ray console in the Amazon X-Ray Developer Guide.

Available Regions

Amazon X-Ray support for Amazon S3 is available in all Amazon X-Ray Regions. For more information, see Amazon S3 and Amazon X-Ray in the Amazon X-Ray Developer Guide.