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

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

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

提供的指标

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

调用指标

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

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

使用情况指标

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

查看网关 CloudWatch 指标

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

在控制台中查看网关指标

设置 CloudWatch 警报

您可以使用 PutMetricAlarm API 操作设置 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 志、亚马逊 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可以帮助将这些跨度和日志拼接在一起。