AgentCore が生成したゲートウェイオブザーバビリティデータ

以下のセクションでは、ゲートウェイメトリクス、ログ、および AgentCore から Amazon CloudWatch への出力範囲について説明します。これらのメトリクスは、CloudWatch の生成 AI オブザーバビリティページでは使用できません。ゲートウェイメトリクスは 1 分間隔でバッチ処理されます。ゲートウェイメトリクスの表示の詳細については、「Amazon Bedrock AgentCore エージェントのオブザーバビリティデータを表示する」を参照してください。

提供されたメトリクス

Gateway は、呼び出しメトリクスと使用状況メトリクスを CloudWatch に発行します。これらのメトリクスを表示したり、特定のメトリクスがしきい値を超えたときに警告するようにアラームを設定したりできます。詳細については、トピックを選択してください。

呼び出しメトリクス

これらのメトリクスは、API 呼び出し、パフォーマンス、エラーに関する情報を提供します。

これらのメトリクスには、次のディメンションが使用されます。

使用状況メトリクス

これらのメトリクスは、ゲートウェイの使用方法に関する情報を提供します。

ゲートウェイ CloudWatch メトリクスを表示する

CloudWatch メトリクスの表示の詳細については、Amazon 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 Logs、Amazon S3、または Firehose ストリームにログを出力できます。CloudWatch Logs の送信先を使用する場合、これらのログはデフォルトのロググループ/aws/vendedlogs/bedrock-agentcore/gateway/APPLICATION_LOGS/{gateway_id}または /aws/vendedlogs/ で始まるカスタムロググループの下に保存されます。詳細については、AgentCore ランタイム、メモリ、ゲートウェイ、組み込みツール、アイデンティティリソースのオブザーバビリティの有効化」を参照してください。

AgentCore は、ゲートウェイリソースの次の情報をログに記録します。

また、いずれかの MCP オペレーションが Gateway で実行されている場合、Vended Logs 統合の一部としてリクエスト本文とレスポンス本文を表示することもできます。これらのログをさらに分析するには、 フィールドspan_idと trace_idフィールドを使用して、発行されたスパンとログを接続できます。カスタマーマネージド KMS キーによるゲートウェイの暗号化の詳細については、「Amazon Bedrock AgentCore 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 準拠の供給スパンをサポートしています。

ツール呼び出し用に提供されたスパンの例:

他の MCP メソッド呼び出しでは、kind:SERVERスパンのみが出力されます。

これらのスパンはメトリクスを出力しますが、特定のスパンで障害が発生した理由を調査するために、Gateway ユーザーは提供されたログを確認する必要があります。たとえば、 spanIdや などのさまざまなフィールドaws.request.idは、これらのスパンとログを結合するのに役立ちます。