View a markdown version of this page

AgentCore がメモリオブザーバビリティデータを生成する - Amazon Bedrock AgentCore
提供されたメモリメトリクス提供されたスパンデータ提供されたログデータ

AgentCore がメモリオブザーバビリティデータを生成する

AgentCore メモリリソースタイプの場合、AgentCore はデフォルトで Amazon CloudWatch にメトリクスを出力します。AgentCore は、これらを有効にすると、スパンとログのデフォルトセットも出力します。スパンとログの有効化の詳細については、AgentCore ランタイム、メモリ、ゲートウェイ、組み込みツール、アイデンティティリソースのオブザーバビリティの有効化」を参照してください。

エージェントメモリストアに提供されるオブザーバビリティデータの詳細については、以下のセクションを参照してください。

提供されたメモリメトリクス

AgentCore メモリリソースタイプは、デフォルトで次のメトリクスを提供します。

レイテンシー

リクエストの受信から最終レスポンストークンの送信までの経過時間の合計。リクエストの完全なend-to-end処理を表します。

呼び出し

データプレーンとコントロールプレーンに対して行われた API リクエストの合計数。このメトリクスは、メモリ取り込みイベントの数も追跡します。

システムエラー

AWS サーバー側のエラーが発生する呼び出しの数。

ユーザーエラー

クライアント側でエラーが発生した呼び出しの数。

エラー

データプレーンとコントロールプレーンで API リクエストの処理中に発生したエラーの合計数。このメトリクスは、メモリの取り込み中に発生するエラーの合計も追跡します。

Throttles

システムがスロットリングした呼び出しの数。スロットリングされたリクエストは、呼び出し、エラー、およびユーザーエラーとしてカウントされます。

作成数

作成されたメモリイベントとメモリレコードの数をカウントします。

提供されたスパンデータ

AgentCore は、オブザーバビリティを高めるために、イベントとイベントが生成またはアクセスするメモリとの関係をトレースする構造化されたスパンを提供します。このスパンデータを有効にするには、エージェントコードを計測する必要があります。詳細については、「Amazon Bedrock AgentCore リソースにオブザーバビリティを追加する」を参照してください。

このスパンデータは、CloudWatch Logs と CloudWatch Application Signals で完全に利用できます。オブザーバビリティデータの表示の詳細については、「Amazon Bedrock AgentCore エージェントのオブザーバビリティデータの表示」を参照してください。

次の表は、スパンが作成されるオペレーションと、キャプチャされた各スパンの属性を定義します。

オペレーション名 スパン属性 説明

CreateEvent

memory.id , session.id , event.id , actor.id , throttled , error , fault

メモリセッション内に新しいイベントを作成します。

GetEvent

memory.id , session.id , event.id , actor.id , throttled , error , fault

既存のメモリイベントを取得します。

ListEvents

memory.id , session.id , event.id , actor.id , throttled , error , fault

セッション内のイベントを一覧表示します

DeleteEvent

memory.id , session.id , event.id , actor.id , throttled , error , fault

メモリからイベントを削除します。

RetrieveMemoryRecords

memory.id , namespace , throttled , error , fault

特定の名前空間のメモリレコードを取得します。

ListMemoryRecords

memory.id , namespace , throttled , error , fault

使用可能なメモリレコードを一覧表示します。

提供されたログデータ

AgentCore は、主要な AgentCore Memory リソースプロセスをモニタリングおよびトラブルシューティングするのに役立つ構造化ログを提供します。このログデータを有効にするには、エージェントコードを計測する必要があります。詳細については、「Amazon Bedrock AgentCore リソースにオブザーバビリティを追加する」を参照してください。

AgentCore はCloudWatch Logs、Amazon S3、または Firehose ストリームにログを出力できます。CloudWatch Logs 送信先を使用する場合、これらのログはデフォルトのロググループ/aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id}または /aws/vendedlogs/ で始まるカスタムロググループの下に保存されます。詳細については、AgentCore ランタイム、メモリ、ゲートウェイ、組み込みツール、および ID リソースのオブザーバビリティを有効にする」を参照してください。

DeleteMemory オペレーションが呼び出されると、削除プロセスの開始と完了のログが生成されます。対応する削除エラーログには、呼び出しが失敗した理由に関するインサイトが表示されます。

また、長期メモリ作成プロセスのさまざまな段階、つまり抽出と統合のログも提供します。新しい短期メモリイベントが提供されると、AgentCore はレスポンスから主要な概念を抽出して、新しい長期メモリレコードの形成を開始します。これらが作成されると、既存のメモリレコードと統合され、個別のメモリの統合ストアが作成されます。

各ワークフローが新しい思い出の形成のモニタリングにどのように役立つかについては、次の内訳を参照してください。

抽出ログ

  • 抽出処理の開始と完了

  • 正常に抽出されたメモリの数

  • 入力イベントの逆シリアル化または処理におけるエラー

統合ログ:

  • 統合処理の開始と完了

  • 統合を必要とするメモリの数

  • メモリの追加と更新の成功/失敗

  • 関連するメモリ取得ステータス

次の表は、さまざまなメモリリソースワークフローがログ本文自体とともにログフィールドを使用してリクエスト固有の情報を提供する方法の詳細な内訳を示しています。

[Workflow name] (ワークフロー名) ログフィールド 説明

抽出

resource_arn, event_timestamp, memory_strategy_id, namespace, actor_id, session_id, event_id, requestId, isError

着信会話を分析して新しい記憶を生成する

統合

resource_arn, event_timestamp, memory_strategy_id, namespace, session_id, requestId, isError

抽出されたメモリと既存のメモリを組み合わせる