Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

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

提供的指标

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

调用指标

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

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

使用情况指标

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

查看网关 CloudWatch 指标

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

在控制台中查看网关指标

设置 CloudWatch 警报

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

以下示例向您展示如何使用 Amazon 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 志、亚马逊 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 Bedrock Gateway 的高级功能和主题。 AgentCore

日志示例：

{
    "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 标准的供应商跨度，可用于跟踪正在使用的不同原语之间的调用。

工具调用的销售跨度示例：

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

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