# Amazon Bedrock AgentCore エージェントのオブザーバビリティデータを表示する
<a name="observability-view"></a>

エージェントにオブザーバビリティを実装した後、CloudWatch コンソールの生成 AI オブザーバビリティページと CloudWatch Logs の両方で、収集されたメトリクスとトレースを表示できます。エージェントのメトリクスを表示する方法については、以下のセクションを参照してください。

## Amazon CloudWatch で生成 AI オブザーバビリティを使用してデータを表示する
<a name="observability-view-console"></a>

CloudWatch の生成 AI オブザーバビリティページには、AgentCore エージェントランタイムによって出力されるサービス提供のすべてのメトリクスと、エージェントコードで計測を有効にしている場合のスパンおよびトレース派生データが表示されます。CloudWatch でオブザーバビリティダッシュボードを表示するには、[Amazon CloudWatch GenAi Observability](https://console.aws.amazon.com/cloudwatch/home#gen-ai-observability) ページを開きます。

CloudWatch の生成 AI オブザーバビリティを使用すると、データのグラフやその他の視覚化、エラーの内訳、トレースの視覚化などを使用して、カスタマイズされたダッシュボードを表示できます。CloudWatch での生成 AI オブザーバビリティの使用の詳細については、Amazon *Amazon CloudWatch ユーザーガイド*の[「Amazon Bedrock AgentCore エージェント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AgentCore-Agents.html)」を参照してください。

## CloudWatch で他のデータを表示する
<a name="observability-view-cw"></a>

サービスが提供するすべてのメトリクスとスパンは、計測されたエージェントコードが出力するメトリクスとともに CloudWatch で表示することもできます。

このデータを表示するには、以下のセクションを参照してください。

### ログ
<a name="observability-view-cw-logs"></a>

1. [CloudWatch コンソール](https://console.aws.amazon.com/cloudwatch/home)を開きます。

1. 左側のナビゲーションペインで、**ログ**を展開し、**ロググループ**を選択します。

1. 検索フィールドを使用して、エージェント、メモリ、またはゲートウェイリソースのロググループを検索します。

   AgentCore エージェントロググループの形式は次のとおりです。
   +  **標準ログ** - stdout/stderr 出力
     +  **場所** : /aws/bedrock-agentcore/runtimes/<agent\_id>-<endpoint\_name>/[runtime-logs] <UUID>
     +  **を含む**: ランタイムエラー、アプリケーションログ、デバッグステートメント
     +  **使用例**:
       + print("Processing request...") \# 標準ログに表示されます
       + logging.info("Request processed successfully") \# 標準ログに表示されます
   +  **OTEL 構造化ログ** - 詳細なオペレーション情報
     +  **場所** : /aws/bedrock-agentcore/runtimes/<agent\_id>-<endpoint\_name>/otel-rt-logs
     +  **を含む**: 実行の詳細、エラー追跡、パフォーマンスデータ
     +  **自動収集** : ADOT 計測によって生成される追加のコードは必要ありません
     +  **利点**: ログを関連するトレースにリンクする相関 IDs を含めることができます

### トレースとスパン
<a name="observability-view-cw-spans"></a>

トレースは、エージェントを介したリクエスト実行パスを可視化します。
+ 場所: エージェントの`spans`ロググループ内のログストリーム (`/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>`)`default`、または共有スパン送信先を使用するエージェントの`aws/spans`ロググループ内のログストリーム。詳細については、[「Amazon Bedrock AgentCore ランタイムでホストされているエージェントのスパン送信先](observability-configure.md#observability-configure-unified-traces)」を参照してください。
+ 経由のアクセス: CloudWatch トランザクション検索コンソール
+ 要件: CloudWatch トランザクション検索を有効にする必要があります

トレースは以下を自動的にキャプチャします。
+ エージェント呼び出しシーケンス
+ フレームワークコンポーネントとの統合 (LangChain など)
+ LLM 呼び出しとレスポンス
+ ツールの呼び出しと結果
+ エラーパスと例外

サービス間の分散トレースでは、標準の HTTP ヘッダーを使用できます。
+  AWS X-Ray 形式: `X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1` 
+ W3C 形式: `traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01` 

トレースを表示するには:
+ CloudWatch コンソールに移動する
+ 左側のナビゲーションから**トランザクション検索**を選択する
+ サービス名またはその他の基準でフィルタリングする
+ トレースを選択して詳細な実行グラフを表示する

### メトリクス
<a name="observability-view-cw-metrics"></a>

エージェント[AgentCoreオブザーバビリティの有効化 の説明に従ってエージェントコードを計測してオブザーバビリティ](observability-configure.md#observability-configure-builtin)を有効にしている場合、エージェントは OTEL メトリクスを自動的に生成し、拡張メトリクス形式 (EMF) を使用して CloudWatch に送信されます。
+ 名前空間: `bedrock-agentcore` 
+ 経由のアクセス: CloudWatch Metrics コンソール
+ コンテンツ: エージェントコードとフレームワークによって生成されたカスタムメトリクス
+ 自動収集: 追加コードは不要 - ADOT 計測によって生成

エージェントによって発行されたメトリクスに加えて、AgentCore サービスは標準のサービスメトリクスを CloudWatch に発行します。これらのメトリクスのリストについては、[AgentCore が生成したランタイムオブザーバビリティデータ](observability-runtime-metrics.md)を参照してください。