View a markdown version of this page

AgentCore 生成内存可观测性数据 - Amazon Bedrock AgentCore
提供的内存指标提供的跨度数据提供的日志数据

AgentCore 生成内存可观测性数据

对于 AgentCore 内存资源类型， CloudWatch 默认情况下会向 Amazon AgentCore 输出指标。 AgentCore 如果启用这些功能，还会输出一组默认的跨度和日志。要详细了解如何启用跨度和日志，请参阅为 AgentCore 运行时、内存、网关、内置工具和身份资源启用可观察性。

请参阅以下章节，详细了解为代理内存存储提供的可观测性数据。

提供的内存指标

默认情况下， AgentCore 内存资源类型提供以下指标。

延迟

从收到请求到发送最终响应令牌之间的总时间。表示对请求的完整端到端处理。

Invocations

向数据平面和控制平面发出的 API 请求总数。该指标还跟踪内存摄取事件的数量。

系统错误

导致 AWS 服务器端错误的调用次数。

用户错误

导致发生客户端错误的调用次数。

错误

在数据平面和控制平面中处理 API 请求时发生的错误总数。该指标还跟踪内存摄取期间发生的错误总数。

节流

系统节流的调用次数。受限制的请求计为调用、错误和用户错误。

创建次数

计算已创建的内存事件和内存记录的数量。

提供的跨度数据

为了增强可观察性， AgentCore 提供了结构化的跨度，以追踪事件与它们生成或访问的记忆之间的关系。要启用此跨度数据，您需要检测代理代码。要了解更多信息，请参阅为您的 Amazon Bedrock AgentCore 资源添加可观察性。

此跨度数据在 “ CloudWatch 日志” 和 “ CloudWatch 应用程序信号” 中完整提供。要了解有关查看可观测性数据的更多信息，请参阅查看 Amazon Bedro AgentCore ck 代理的可观测性数据。

下表定义了为其创建跨度的操作以及每个捕获的跨度的属性。

操作名称 跨度属性 说明

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 志、Amazon S3 或 Firehose 流。如果您使用 CloudWatch 日志目标，则这些日志将存储在默认日志组下/aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id}或以开头的自定义日志组下/aws/vendedlogs/。要了解更多信息，请参阅为 AgentCore 运行时、内存、网关、内置工具和身份资源启用可观察性。

调用该DeleteMemory操作时，会生成删除过程的开始和完成日志。任何相应的删除错误日志都将提供有关呼叫失败原因的见解。

我们还为长期存储器创建过程中的各个阶段（即提取和整合）提供日志。当提供新的短期记忆事件时，从响应中 AgentCore 提取关键概念，开始形成新的长期记忆记录。一旦创建完毕，它们就会与现有的记忆记录集成，从而创建一个统一的不同存储库。

请参阅以下细目，了解每种工作流程如何帮助您监控新记忆的形成：

提取日志

  • 开始和完成提取处理

  • 成功提取的存储器数量

  • 反序列化或处理输入事件时出现任何错误

整合日志：

  • 开始和完成合并处理

  • 需要整合的存储器数量

  • Success/failure 内存添加和更新

  • 相关的内存检索状态

下表更详细地说明了不同的内存资源工作流如何使用日志字段以及日志正文本身来提供特定于请求的信息。

工作流名称 日志字段 说明

提取

resource_arn、事件时间戳、memory_strategy_id、命名空间、actor_id、session_id、event_id、requestID、isError

分析传入的对话以产生新的回忆

整合

resource_arn、event_timestamp、memory_strategy_id、namession_id、requestId、isError

将提取的记忆与现有记忆相结合