View a markdown version of this page

オブザーバビリティとコスト管理 - Amazon Bedrock AgentCore

オブザーバビリティとコスト管理

このページでは、ハーネスのモニタリング、実行コストの制御、リソースタグの管理について説明します。

オブザーバビリティ

すべてのハーネス呼び出しは、CloudWatch の AgentCore Observability を通じてトレース、ログ、メトリクスを自動的に生成します。モデル呼び出し、ツール呼び出し、メモリオペレーション、シェルコマンド: 各ステップにタイミングとペイロードの詳細が表示されます。追加の設定はありません。トレースは、最初の呼び出しから使用できます。

AWS CLI/boto3

トレース、ログ、メトリクスは、ハーネス実行ロールを介して CloudWatch に流れます。AgentCoreオブザーバビリティダッシュボードでそれらを表示するか、CloudWatch Logs と X-Ray APIs。

トレースが表示される前に、CloudWatch でトランザクション検索を有効にします (アカウントごとに 1 回)。セットアップの詳細については、AgentCore Observability の開始方法」を参照してください。

AgentCore CLI
# Stream logs agentcore logs --harness research-agent # Filter agentcore logs --harness research-agent --since 1h --level error # List recent traces agentcore traces list --harness research-agent # Get a specific trace agentcore traces get <trace-id> --harness research-agent

詳細: オブザーバビリティの概要 メトリクス テレメトリ

CloudTrail

ハーネスオペレーションは、管理イベント (コントロールプレーン) およびデータイベント (データプレーン) として AWS CloudTrail に記録されます。CloudTrail では、ハーネスリソースは、ハーネス固有のAWS::BedrockAgentCore::Runtimeタイプではなくリソースタイプの下に表示されます。ハーネスは AgentCore ランタイムに対するマネージド抽象化であり、CloudTrail イベントは整合性のために基盤となるランタイムリソースを反映しています。

すべてのハーネス CloudTrail イベントは resources.type = を使用しますAWS::BedrockAgentCore::Runtime。イベント名は次のとおりです。

  • CreateHarnessUpdateHarnessDeleteHarnessGetHarnessListHarnesses (管理イベント)

  • InvokeAgentRuntimeInvokeAgentRuntimeCommand (データイベント)

注記

データプレーンオペレーションは CloudTrail InvokeAgentRuntimeCommandInvokeAgentRuntimeおよび として表示され、基盤となる Runtime API と一致します。resources.ARN フィールドには、コントロールプレーンイベントのハーネス ARN とデータプレーンイベントのランタイム ARN が含まれます。

制限によるコストの制御

ランナウェイエージェントがリソースを焼き付けないようにハードキャップを設定します。

  • maxIterations - 呼び出しあたりの推論/アクションサイクル。デフォルトは 75 です。

  • timeoutSeconds - 1 回の呼び出しのウォールクロックタイムアウト。デフォルトは 3600 です。

  • maxTokens - 呼び出しあたりのトークン予算。デフォルトの N/A。

  • idleRuntimeSessionTimeout - アイドル状態のmicroVM がウォーム状態を維持する期間。デフォルトは 900 です。

  • maxLifetime - microVM セッションの最大有効期間。デフォルトは 28800 です。

すべての制限はオプションです。サービスのデフォルトを使用するには省略してください。ハーネスは AgentCore ランタイムによってサポートされるため、ハーネスの呼び出しもランタイムサービスクォータの対象となります。詳細については、AgentCore harness Service Quotas」とAgentCore Runtime Service Quotas」を参照してください。

AWS CLI/boto3
aws bedrock-agentcore-control update-harness \ --harness-id "MyHarness-UuFdkQoXSL" \ --max-iterations 50 \ --timeout-seconds 1800 \ --max-tokens 8192

または、、maxIterations、または を maxTokensで渡してtimeoutSeconds、1 回の呼び出しを上書きしますinvoke_harness

AgentCore CLI

デフォルトを設定します。

agentcore add harness --name bounded-agent \ --max-iterations 50 --timeout 1800 --max-tokens 8192 \ --truncation-strategy sliding_window \ --idle-timeout 600 --max-lifetime 14400 agentcore deploy

--truncation-strategy フラグは sliding_windowまたは を受け入れますsummarization--idle-timeout および --max-lifetimeフラグは、ライフサイクル制限を秒単位で設定します。

1 回の呼び出しで上書きする:

agentcore invoke --harness bounded-agent --max-iterations 20 --harness-timeout 600 \ "Quick lookup: what's the weather in Seattle?"

タグ

コスト配分とアクセスコントロールのためにハーネスにタグを適用します。

AWS CLI/boto3
aws bedrock-agentcore-control create-harness \ --harness-name "MyHarness" \ --execution-role-arn "arn:aws:iam::123456789012:role/MyHarnessRole" \ --tags '{"team": "platform", "environment": "staging"}'
AgentCore CLI

でタグを設定しますharness.json

{ "tags": { "team": "platform", "environment": "staging" } }

を実行して適用agentcore deployします。

タグはデプロイされた CloudFormation リソースに流れます。