エージェントビュー - Amazon CloudWatch

エージェントビュー

[エージェントビュー] には、アカウントのエージェント用に厳選されたダッシュボードが表示されます。AgentCore ランタイム、Lambda、Amazon EC2 などの AWS ネイティブサービスでホストされているエージェントのデータを表示できます。ビューには、CloudWatch にテレメトリを出力するエージェントも表示されます。

概要

メトリクスとダッシュボードには、サンプリングされたエージェントスパンのデータが表示されます。エージェントスパンの詳細については、「Spans」を参照してください。

以下のエージェントメトリクスがサポートされています。

  • エージェント/エイリアス – スパンを出力する計測されたエージェントとエイリアスの数

  • セッション – スパンを出力する計測されたエージェントが作成したセッションの数。セッションは会話に似ており、幅広いコンテキストが含まれています

  • トレース – スパンを出力する計測されたエージェントが作成したトレースの数。トレースは、セッション内の個々のリクエスト/レスポンスサイクルです

  • エラー率 – エージェントインタラクションのエラーの割合

  • スロットリングレート – スロットリングされたエージェントのインタラクションの割合

[詳細を表示] を選択して、エージェントメトリクスをグラフで表示します。

エージェントビュー

ランタイムメトリクス

ランタイムメトリクスとダッシュボードには、ランタイムプリミティブのデータが表示されます。このプリミティブを使用すると、Amazon Bedrock AgentCore ランタイムでエージェントをホストできます。詳細については、「Creating an AgentCore Runtime」を参照してください。

AgentCore ランタイムはこれらのメトリクスをサポートします

  • ランタイムエージェント/エイリアス – AgentCore ランタイムでホストされているエージェントとエイリアスの数を追跡します

  • ランタイムセッション – AgentCore ランタイムで実行されているエージェントが作成したセッションの数を追跡します。セッションは会話に似ており、インタラクションフロー全体の広範なコンテキストが含まれています。プラットフォームの全体的な使用状況のモニタリング、キャパシティプランニング、ユーザーエンゲージメントパターンの理解に役立ちます

  • ランタイム呼び出し – データプレーン API に対して行われたリクエストの合計数。リクエストペイロードサイズやレスポンスステータスに関係なく、各 API コールは 1 回の呼び出しとしてカウントされます

  • ランタイムエラー – システムエラーとユーザーエラーの数。システムおよびユーザーのエラー定義については、「AgentCore provided runtime metrics」を参照してください

  • ランタイムスロットリング – 許可された TPS (1 秒あたりのトランザクション) を超えたためにサービスによってスロットリングされたリクエストの数。これらのリクエストは、HTTP ステータスコード 429 の ThrottlingException を返します。このメトリクスをモニタリングして、サービスクォータの確認やリクエストパターンの最適化が必要かどうかを判断します

デフォルトのダッシュボードで、時間の経過に伴うメトリクスの変化を表示します。[詳細を表示] を展開してメトリクスグラフを表示します。

ランタイムビュー

[エージェント]

エージェントは、アプリケーションからモニタリングデータを収集して送信するコンポーネントです。エージェントテーブルには、アカウントで設定されたすべてのエージェントが表示されます。これらのエージェントは、AgentCore ランタイム、Lambda、Amazon EC2 などの AWS ネイティブサービスでホストできます。このテーブルには、テレメトリを CloudWatch に出力するように計測された他のエージェントも表示されます。

[エージェントをフィルタリング] を使用して、深く掘り下げたい特定のエージェントを見つけたり、列名を使用してエージェントをソートし必要なエージェントを見つけることもできます。歯車アイコンを選択して、追加の列を表示または非表示にします。

ランタイムエージェントビュー

エージェント名を展開することで、エージェントの詳細を表示できます。

ランタイムエージェントの概要

エージェントの詳細 - 概要

[概要] タブには、エージェントメトリクスの自動ダッシュボードが表示されます。これらのメトリクスは、サンプリングされたスパンとランタイムメトリクス (エージェントが AgentCore ランタイムを使用する場合) から取得されます。

[エージェントのメトリクス] ダッシュボードには、サンプリングされたスパンから派生した以下のメトリクスが含まれています。

  • セッションとトレース — このエージェントのセッションとトレースの数

  • FM トークンの使用 – 基礎モデルトークン消費の合計数。チャートを特定の基礎モデルにフィルタリングできます

  • システムエラーとクライアントエラー – リクエスト処理中のシステムエラーの数。サーバー側のエラーレベルが高い場合は、調査が必要な潜在的なインフラストラクチャまたはサービスの問題がある可能性があります。クライアントエラーは、無効なリクエストに起因するエラーです。クライアント側のエラーレベルが高い場合は、リクエストのフォーマットやアクセス許可に問題がある可能性があります

  • スパン別のエラーとレイテンシー – 特定のスパン別のエラー率とレイテンシー。スパンは多くのエージェントに表示される可能性があることに注意してください

  • スロットリング – 許可された TPS (1 秒あたりのトランザクション数) を超えたためにサービスによってスロットリングされたリクエストの数

[ランタイムメトリクス] ダッシュボードには、AgentCore ランタイムが自動的に生成する以下のメトリクスが含まれています。

  • ランタイムセッションと呼び出し – ランタイムでのホスト中にこの特定のエージェントが生成したセッションと呼び出しの数

  • ランタイムレイテンシー – ランタイムでホストされるエージェントによるリクエストのレイテンシー

  • ランタイムスロットリング – 許可された TPS (1 秒あたりのトランザクション数) を超えたためにサービスによってスロットリングされたリクエストの数

エージェントの詳細 - セッション

エージェントは複数のセッションを持つことができます。[セッション] タブでセッションを表示します。[セッションをフィルタリング] を使用するか、列をソートして必要なセッションを見つけます。

[セッション ID] を選択すると、セッション概要メトリクスとそのセッションに属するトレースのリストが表示されます。セッションメトリクスには以下が含まれます。

  • トレース – セッションに属するトレースの数

  • サーバーエラー – リクエスト処理中のシステムエラーの数。サーバー側のエラーレベルが高い場合は、調査が必要な潜在的なインフラストラクチャまたはサービスの問題がある可能性があります

  • クライアントエラー – クライアントエラーは、無効なリクエストに起因するエラーです。クライアント側のエラーレベルが高い場合は、リクエストのフォーマットやアクセス許可に問題がある可能性があります

  • スロットリング – 許可された TPS (1 秒あたりのトランザクション数) を超えたためにスロットリングされたこのセッションに関連するリクエストの数

  • セッションの詳細 – 開始時刻、終了時刻、セッション ID などのセッションに関するメタデータ

セッション内のトレースのリストを分析するには、[トレースをフィルタリング] を選択してテーブル列を絞り込むかソートし、調査する特定のトレースをバブルアップします。

トレースを選択すると、右ペインにトレースの詳細が表示されます。トレースごとに、トレースの概要、スパン、トレースコンテンツの詳細を確認できます。

[トレース概要] では、以下のメトリクスを表示できます。

注記

概要ページフィールドは、[エージェントビュー]、[セッションビュー]、[トレースビュー] 間で一貫しています。

  • スパン – トレース内のスパンの数

  • サーバーエラー – リクエスト処理中のシステムエラーの数。サーバー側のエラーレベルが高い場合は、調査が必要な潜在的なインフラストラクチャまたはサービスの問題がある可能性があります

  • クライアントエラー – クライアントエラーは、無効なリクエストに起因するエラーです。クライアント側のエラーレベルが高い場合は、リクエストのフォーマットやアクセス許可に問題がある可能性があります

  • スロットリング – 許可された TPS (1 秒あたりのトランザクション数) を超えたためにスロットリングされたこのセッションに関連するリクエストの数

  • P95 スパンレイテンシー – この特定のスパンのすべての呼び出しにおける 95 パーセンタイルレイテンシー。スパンは多くのエージェントで使用できることに注意してください

  • トレースの詳細 – 開始時刻、終了時刻、トレース ID などのトレースに関するメタデータ

スパンビュー

[タイムライン] を選択すると、各スパンの期間が表示され、最も時間がかかり、応答の遅延に影響したスパンがわかります。

軌跡ビュー

スパン関係と後続の呼び出しを分析するには、[軌跡] を選択して、スパンとこれらのスパンからの後続の呼び出しの相互接続された関係を理解します。

[スパン] で、個々のスパンイベントを選択して、スパンデータを元の形式で確認します。スパンデータを元の形式で確認します。詳細なトラブルシューティングを行うには、[イベント] タブを選択してモデルの入力と出力を調べます。

エージェントの詳細 - トレース

各エージェントには複数のトレースがある場合があります。[トレース] タブでトレースの詳細を表示します。[トレースをフィルタリング] を選択するか、列をソートして必要なトレースを見つけます。