AgentCore が生成した組み込みツールオブザーバビリティデータ
オブザーバビリティツールのメトリクス
AgentCore には、コードインタープリタとブラウザツール用の以下の組み込みメトリクスが用意されています。組み込みツールメトリクスは 1 分間隔でバッチ処理されます。AgentCore ツールの詳細については、「Amazon Bedrock AgentCore Code Interpreter を使用したコードの実行とデータの分析」および「Amazon Bedrock AgentCore Browser を使用したウェブアプリケーションの操作」を参照してください。
呼び出しツール:
- 呼び出し
-
Data Plane API に対して行われたリクエストの合計数。各 API コールは、リクエストペイロードのサイズやレスポンスのステータスに関係なく、1 回の呼び出しとしてカウントされます。
- Throttles
-
許可された TPS (1 秒あたりのトランザクション数) またはクォータ制限を超えたためにサービスによってスロットリングされたリクエストの数。これらのリクエストは、HTTP ステータスコード 429 の ThrottlingException を返します。
- SystemErrors
-
リクエスト処理中に発生したサーバー側のエラーの数。
- UserErrors
-
無効なリクエストに起因するクライアント側のエラーの数。これには、解決するためにユーザーアクションが必要です。
- レイテンシー
-
サービスがリクエストを受信してから最初のレスポンストークンの送信を開始するまでの経過時間。初期応答時間を測定するために重要です。
ツールセッションの作成:
- 呼び出し
-
Data Plane API に対して行われたリクエストの合計数。各 API コールは、リクエストペイロードのサイズやレスポンスのステータスに関係なく、1 回の呼び出しとしてカウントされます。
- Throttles
-
許可された TPS (1 秒あたりのトランザクション数) またはクォータ制限を超えたためにサービスによってスロットリングされたリクエストの数。これらのリクエストは、HTTP ステータスコード 429 の ThrottlingException を返します。
- SystemErrors
-
リクエスト処理中に発生したサーバー側のエラーの数。
- UserErrors
-
無効なリクエストに起因するクライアント側のエラーの数。これには、解決するためにユーザーアクションが必要です。
- レイテンシー
-
サービスがリクエストを受信してから最初のレスポンストークンの送信を開始するまでの経過時間。初期応答時間を測定するために重要です。
- 時間
-
ツールセッションの期間 (オペレーションは CodeInterpreterSession/BrowserSession になります）。
ブラウザユーザーの乗っ取り:
- TakerOverCount
-
を引き継ぐユーザーの総数
- TakerOverReleaseCount
-
コントロールを解放するユーザーの総数
- TakerOverDuration
-
ユーザーが引き継ぐ期間
リソース使用状況メトリクスとログ
Amazon Bedrock AgentCore 組み込みツールは、ランタイムリソースの CPU およびメモリ消費メトリクスを含む包括的なリソース使用状況テレメトリを提供します。
注記
リソース使用状況データは最大 60 分遅延し、精度はメトリクスによって異なる場合があります。
提供されたメトリクス
デフォルトでは、Bedrock AgentCore 組み込みツールは、アカウントレベルとツールレベルのメトリクスを 1 分の解像度で提供します。Amazon CloudWatch の集約およびメトリクスデータ保持は、標準の Amazon CloudWatch データ保持ポリシーに従います。詳細については、https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric を参照してください。
| 名前 | ディメンション | 説明 |
|---|---|---|
|
CPUUsed-vCPUHours |
サービス、サービス、リソース |
vCPU-Hours 単位で消費される仮想 CPU の合計量。リソースレベルとアカウントレベルで使用できます。リソースの追跡と推定請求の可視性に役立ちます。 |
|
MemoryUsed-GBHours |
サービス、サービス、リソース |
リソースレベルとアカウントレベルで利用可能な、GB-時間単位で消費されるメモリの合計量。リソースの追跡と推定請求の可視性に役立ちます。 |
ディメンションの説明
-
サービス - AgentCore.CodeInterpreter または AgentCore.Browser
-
リソース - 組み込みツール ID
アカウントレベルのメトリクスは、Amazon CloudWatch Bedrock AgentCore Observability Console の組み込みツールタブで使用できます。コンソールのダッシュボードには、メモリ使用状況グラフと、使用状況メトリクスから生成された CPU 使用状況グラフが含まれます。これらのグラフは、リージョンのアカウントで選択したツールタイプのすべてのツールにおけるリソースの合計使用量を表します。
ツールレベルのメトリクスは、Amazon CloudWatch Bedrock AgentCore Observability Console のツールページにあります。コンソールのダッシュボードには、メモリ使用状況グラフと、使用状況メトリクスから生成された CPU 使用状況グラフが含まれます。グラフは、選択したツールのすべてのセッションにおけるリソースの合計使用量を表します。
注記
テレメトリデータはモニタリング目的で提供されます。実際の請求は、計測された使用状況データに基づいて計算され、集計タイミング、調整プロセス、測定精度によってテレメトリ値とは異なる場合があります。正規料金については、 AWS 請求明細書を参照してください。
販売済みログ
Amazon Bedrock AgentCore 組み込みツールを使用すると、セッションレベルの使用状況テレメトリの供給ログを 1 秒単位で有効にできます。各ログレコードには 1 秒のリソース使用状況データムが含まれます。現在サポートされているメトリクスは次のとおりです。
-
Code Interprefer codeInterpreter.vcpu.hours.used および codeInterpreter.memory.gb_hours.used
-
Browser browser.vcpu.hours.used および browser.memory.gb_hours.used
各リソース使用状況データムは、ログレコードで次のスキーマを使用します。
コードインタープリタ
| ログタイプ | ログフィールド | 説明 |
|---|---|---|
|
USAGE_LOGS |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, codeInterpreter.vcpu.hours.used, codeInterpreter.memory.gb_hours.used |
セッションレベルのリソース追跡のリソース使用状況ログ。 |
ブラウザ
| ログタイプ | ログフィールド | 説明 |
|---|---|---|
|
USAGE_LOGS |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, browser.vcpu.hours.used, browser.memory.gb_hours.used |
セッションレベルのリソース追跡のリソース使用状況ログ。 |
ログの有効化の詳細については、「Amazon Bedrock AgentCore リソースにオブザーバビリティを追加する」を参照してください。これらのログは、設定されている送信先 (AWS LogGroup、Amazon S3、または Amazon Kinesis Firehose。
Amazon CloudWatch Bedrock AgentCore Observability Console の組み込みツールセッションページで、これらのログから生成されたリソース使用状況メトリクスを確認できます。メトリクスの表示エクスペリエンスを最適化するには、右上の セレクターを使用して目的の時間範囲を選択し、特定の CPU およびメモリ使用量データに焦点を当てます。
注記
テレメトリデータはモニタリング目的で提供されます。実際の請求は、計測された使用状況データに基づいて計算され、集計タイミング、調整プロセス、測定精度によってテレメトリ値とは異なる場合があります。正規料金については、 AWS 請求明細書を参照してください。
提供されたスパンデータ
オブザーバビリティを強化するために、AgentCore は組み込みツール APIs を可視化する構造化スパンを提供します。このスパンデータを有効にするには、組み込みツールリソースでオブザーバビリティを有効にする必要があります。ステップと詳細については、「Amazon Bedrock AgentCore リソースにオブザーバビリティを追加する」を参照してください。このスパンデータは、aws/spans ロググループの完全な in AWS CloudWatch Logs で使用できます。次の表は、スパンが作成されるオペレーションと、キャプチャされた各スパンの属性を定義します。
コードインタープリタ
| オペレーション名 | スパン属性 | 説明 |
|---|---|---|
|
StartCodeInterpreterSession |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、レイテンシー_ms、エラー_type |
コードインタープリタセッションを開始します。 |
|
StopCodeInterpreterSession |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、レイテンシー_ms、エラー_type、 session_duration_s |
コードインタープリタセッションを停止します。 |
|
InvokeCodeInterpreter |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、レイテンシー_ms、エラー_type |
入力コードを使用してコードインタプリタを呼び出します。 |
|
CodeInterpreterSessionExpire |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、レイテンシー_ms、エラー_type、 session_duration_s |
StopCodeInterpreterSession が呼び出されず、セッションがタイムアウトすると、コードインタープリタセッションが期限切れになります。 |
-
toolsession.id - ツールセッションの ID
-
session_duration_s - セッションが終了するまでの秒単位の期間
ブラウザ
| オペレーション名 | スパン属性 | 説明 |
|---|---|---|
|
StartBrowserSession |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、レイテンシー_ms、エラー_type |
ブラウザセッションを開始します。 |
|
StopBrowserSession |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、レイテンシー_ms、エラー_type、 session_duration_s |
ブラウザセッションを停止します。 |
|
ConnectBrowserAutomationStream |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、レイテンシー_ms、エラー_type |
ブラウザ自動化ストリームに接続します。 |
|
BrowserSessionExpire |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、レイテンシー_ms、エラー_type、 session_duration_s |
StopBrowserSession が呼び出されず、セッションがタイムアウトすると、コードインタープリタセッションが期限切れになります。 |
アプリケーションログデータ
AgentCore は、エージェントのランタイム呼び出しとセッションレベルのリソース消費を可視化するのに役立つ構造化されたアプリケーションログを提供します。このログデータは、エージェントリソースでオブザーバビリティを有効にするときに提供されます。ステップと詳細については、「Amazon Bedrock AgentCore リソースにオブザーバビリティを追加する」を参照してください。AgentCore はCloudWatch Logs、Amazon S3、または Firehose ストリームにログを出力できます。CloudWatch Logs 送信先を使用する場合、これらのログはエージェントのアプリケーションログまたは独自のカスタムロググループの下に保存されます。
| ログタイプ | ログフィールド | 説明 |
|---|---|---|
|
APPLICATION_LOGS |
timestamp, resource_arn, event_timestamp, account_id, request_id, session_id, trace_id, span_id, service_name, operation, request_payload, response_payload |
トレースフィールド、リクエスト、レスポンスペイロードを含む InvokeCodeInterpreter のアプリケーションログ |
