AgentCore provided runtime metrics - Amazon Bedrock AgentCore
Error types

Amazon Bedrock AgentCore is in preview release and is subject to change.

AgentCore provided runtime metrics

The runtime metrics provided by AgentCore give you visibility into your agent execution activity levels, processing latency, resource utilization, and error rates. AgentCore also provides aggregated metrics for total invocations and sessions.

The following list describes the runtime metrics provided by AgentCore. Runtime metrics are batched at one minute intervals. To learn more about viewing runtime metrics, see View observability data for your Amazon Bedrock AgentCore agents.

Invocations

Shows the total number of requests made to the Data Plane API. Each API call counts as one invocation, regardless of the request payload size or response status.

Invocations (aggregated)

Shows the total number of invocations across all resources

Throttles

Displays the number of requests throttled by the service due to exceeding allowed TPS (Transactions Per Second) or quota limits. These requests return ThrottlingException with HTTP status code 429. Monitor this metric to determine if you need to review your service quotas or optimize request patterns.

System Errors

Shows the number of server-side errors encountered by AgentCore during request processing. High levels of server-side errors can indicate potential infrastructure or service issues that require investigation. See Error types for a list of possible error codes.

User Errors

Represents the number of client-side errors resulting from invalid requests. These require user action to resolve. High levels of client-side errors can indicate issues with request formatting or permissions that need to be addressed. See Error types for a list of possible error codes.

Latency

The total time elapsed between receiving the request and sending the final response token. Represents complete end-to-end processing time of the request.

Total Errors

The total number of system and user errors. In the Amazon Bedrock AgentCore console, this metric displays the number of errors as a percentage of the total number of invocations.

Session Count

Shows the total number of agent sessions. Useful for monitoring overall platform usage, capacity planning, and understanding user engagement patterns.

Sessions (aggregated)

Shows the total number of sessions across all resources.

Error types

The following list defines the possible error types for user, system, and throttling errors.

User error codes

  • InvocationError.Validation - Client provided invalid input (400)

  • InvocationError.ResourceNotFound - Requested resource doesn't exist (404)

  • InvocationError.AccessDenied - Client lacks permissions (403)

  • InvocationError.Conflict - Resource conflict (409)

System error codes

  • InvocationError.Internal - Internal server error (500)

Throttling error codes

  • InvocationError.Throttling - Rate limiting (429)

  • InvocationError.ServiceQuota - Service-side quota/limit reached (402)