View a markdown version of this page

Amazon Bedrock AgentCore エージェントのオブザーバビリティデータを表示する - Amazon Bedrock AgentCore
Amazon CloudWatch で生成 AI オブザーバビリティを使用してデータを表示するCloudWatch で他のデータを表示する

Amazon Bedrock AgentCore エージェントのオブザーバビリティデータを表示する

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

Amazon CloudWatch で生成 AI オブザーバビリティを使用してデータを表示する

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

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

CloudWatch で他のデータを表示する

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

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

ログ

  1. CloudWatch コンソールを開きます。

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

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

    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 を含めることができます

トレースとスパン

トレースは、エージェントを介したリクエスト実行パスを可視化します。

  • 場所: エージェントのspansロググループ内のログストリーム (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>)default、または共有スパン送信先を使用するエージェントのaws/spansロググループ内のログストリーム。詳細については、「Amazon Bedrock AgentCore ランタイムでホストされているエージェントのスパン送信先」を参照してください。

  • 経由のアクセス: 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 コンソールに移動する

  • 左側のナビゲーションからトランザクション検索を選択する

  • サービス名またはその他の基準でフィルタリングする

  • トレースを選択して詳細な実行グラフを表示する

メトリクス

エージェントAgentCoreオブザーバビリティの有効化 の説明に従ってエージェントコードを計測してオブザーバビリティを有効にしている場合、エージェントは OTEL メトリクスを自動的に生成し、拡張メトリクス形式 (EMF) を使用して CloudWatch に送信されます。

  • 名前空間: bedrock-agentcore

  • 経由のアクセス: CloudWatch Metrics コンソール

  • コンテンツ: エージェントコードとフレームワークによって生成されたカスタムメトリクス

  • 自動収集: 追加コードは不要 - ADOT 計測によって生成

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