AgentCore 生成的网关可观测性数据

以下各节描述了向 Amazon CloudWatch 输出的 AgentCore 网关指标、日志和跨度。这些指标在 CloudWatch 生成式 AI 可观测性页面上不可用。网关指标每隔一分钟进行批处理。要了解有关查看网关指标的更多信息，请参阅查看 Amazon Bedrock AgentCore 代理的可观测性数据。

提供的指标

Gateway 向发布调用和使用情况指标。 CloudWatch您可以查看这些指标，也可以设置警报，以便在某些指标超过阈值时提醒您。要了解更多信息，请选择一个主题：

调用指标

这些指标提供有关 API 调用、性能和错误的信息。

对于这些指标，使用以下维度：

使用情况指标

这些指标提供有关您的网关使用情况的信息。

查看网关 CloudWatch 指标

有关查看 CloudWatch 指标的更多信息，请参阅 Amazon CloudWatch 用户指南中的查看可用指标。以下过程向您展示如何查看网关的指标：

在控制台中查看网关指标

设置 CloudWatch 警报

您可以使用 PutMetricAlarmAPI 操作设置 CloudWatch 警报，以便在某些指标超过阈值时提醒您。例如，您可能希望在错误率超过 5% 或延迟超过 1 秒时收到通知。

以下示例说明如何使用 AWS CLI 创建错误率高的警报：

aws cloudwatch put-metric-alarm \
  --alarm-name "HighErrorRate" \
  --alarm-description "Alarm when error rate exceeds 5%" \
  --metric-name "SystemErrors" \
  --namespace "AWS/Bedrock-AgentCore" \
  --statistic "Sum" \
  --dimensions "Name=Resource,Value=my-gateway-arn" \
  --period 300 \
  --evaluation-periods 1 \
  --threshold 5 \
  --comparison-operator "GreaterThanThreshold" \
  --alarm-actions "arn:aws:sns:us-west-2:123456789012:my-topic"

当系统错误数在 5 分钟内超过 5 时，将触发此警报。当警报触发时，它将向指定的 SNS 主题发送通知。

提供的日志数据

AgentCore 提供日志，可帮助您监控关键 AgentCore 网关资源进程并对其进行故障排除。要启用此日志数据，您需要创建一个日志目标。

AgentCore 可以将日志输出到日 CloudWatch 志、Amazon S3 或 Firehose 流。如果您使用 CloudWatch 日志目标，则这些日志将存储在默认日志组下/aws/vendedlogs/bedrock-agentcore/gateway/APPLICATION_LOGS/{gateway_id}或以开头的自定义日志组下/aws/vendedlogs/。要了解更多信息，请参阅为 AgentCore 运行时、内存、网关、内置工具和身份资源启用可观察性。

AgentCore 记录网关资源的以下信息：

在网关上执行任何 MCP 操作时，您还可以将请求和响应正文作为 Vended Logs 集成的一部分。他们可以对这些日志进行进一步分析，使用span_id和trace_id字段来连接已发送的跨度和正在发出的日志。有关使用客户管理的 KMS 密钥加密网关的更多信息，请参阅 Amazon Bedro AgentCore ck Gateway 的高级功能和主题。

日志示例：

{
    "resource_arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/<gatewayid>",
    "event_timestamp": 1759370851622,
    "body": {
        "isError": false,
        "log": "Started processing request with requestId: 1",
        "requestBody": "{id=1, jsonrpc=2.0, method=tools/call, params={name=target-quick-start-f9scus___LocationTool, arguments={location=seattle}}}",
        "id": "1"
    },
    "account_id": "123456789012",
    "request_id": "12345678-1234-1234-1234-123456789012",
    "trace_id": "160fc209c3befef4857ab1007d041db0",
    "span_id": "81346de89c725310"
}

包含响应正文的示例日志：

{
    "resource_arn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/<gatewayid>",
    "event_timestamp": 1759370853807,
    "body": {
        "isError": false,
        "responseBody": "{jsonrpc=2.0, id=1, result={isError=false, content=[{type=text, text=\"good\"}]}}",
        "log": "Successfully processed request with requestId: 2",
        "id": "1"
    },
    "account_id": "123456789012",
    "request_id": "12345678-1234-1234-1234-123456789012",
    "trace_id": "160fc209c3befef4857ab1007d041db0",
    "span_id": "81346de89c725310"
}

提供的跨度

AgentCore 支持符合 OTEL 标准的 vended span，您可以使用这些跨度来跟踪正在使用的不同基元间的调用。

工具调用的卖出跨度示例：

对于其他 MCP 方法调用，仅发出kind:SERVER跨度。

当这些跨度发出指标时，要调查特定跨度发生故障的原因，Gateway 用户必须检查已出售的日志。例如，spanId各种字段aws.request.id可以帮助将这些跨度和日志拼接在一起。