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).

Amazon Bedrock AgentCore and Amazon X-Ray

Amazon Bedrock AgentCore integrates with Amazon X-Ray to provide distributed tracing capabilities for your AI agents and tools. This integration allows you to track requests as they flow through your agent applications, helping you identify performance bottlenecks and troubleshoot issues.

AgentCore supports distributed tracing through X-Ray integration, allowing you to monitor the performance of your AI agents and tools. When you enable observability for your AgentCore resources, you can propagate trace context across service boundaries and gain visibility into how your agents interact with other Amazon services. For more information, see Amazon Bedrock AgentCore.

AgentCore supports the following X-Ray features:

Setting up X-Ray with AgentCore

To use X-Ray with AgentCore, you need to enable CloudWatch Transaction Search in your Amazon account. This is a one-time setup that allows AgentCore to send trace data to X-Ray. For more information, see Enable transaction search .

For more information about setting up observability for AgentCore, see Add observability to your Amazon Bedrock AgentCore agent or tool .

Using trace headers with AgentCore

AgentCore supports the X-Ray trace header format for distributed tracing. You can include the X-Amzn-Trace-Id header in your requests to AgentCore to maintain trace context across service boundaries.