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 請求時發生的錯誤總數。此指標也會追蹤記憶體擷取期間發生的錯誤總數。

限流

系統限流的調用數量。限流請求計為叫用、錯誤和使用者錯誤。

建立計數

計算建立的記憶體事件和記憶體記錄的數量。

提供的跨度資料

為了增強可觀測性，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 記憶體資源程序。若要啟用此日誌資料，您需要檢測您的代理程式程式碼。請參閱將可觀測性新增至 Amazon Bedrock AgentCore 資源以進一步了解。

AgentCore 可以將日誌輸出到 CloudWatch Logs、Amazon S3 或 Firehose 串流。如果您使用 CloudWatch Logs 目的地，這些日誌會存放在預設日誌群組下/aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id}或以 /aws/vendedlogs/ 開頭的自訂日誌群組下。請參閱啟用 AgentCore 執行期、記憶體、閘道、內建工具和身分資源的可觀測性，以進一步了解。

呼叫 DeleteMemory操作時，會產生開始和完成刪除程序的日誌。任何對應的刪除錯誤日誌都會提供有關呼叫失敗原因的洞見。

我們也提供長期記憶體建立程序中各種階段的日誌，也就是擷取和合併。提供新的短期記憶體事件時，AgentCore 會從回應中擷取關鍵概念，以開始形成新的長期記憶體記錄。建立後，它們會與現有的記憶體記錄整合，以建立不同記憶體的統一存放區。

請參閱下列明細，以了解每個工作流程如何協助您監控新記憶體的形成：

擷取日誌

  • 開始和完成擷取處理

  • 成功擷取的記憶體數量

  • 還原序列化或處理輸入事件時的任何錯誤

合併日誌：

  • 開始和完成合併處理

  • 需要整合的記憶體數量

  • 記憶體新增和更新成功/失敗

  • 相關記憶體擷取狀態

下表提供不同記憶體資源工作流程如何使用日誌欄位與日誌內文本身來提供請求特定資訊的更詳細明細。

工作流程名稱 日誌欄位 說明

擷取

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

結合擷取的記憶體與現有的記憶體