本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# AgentCore 生成内存可观测性数据
<a name="observability-memory-metrics"></a>

对于 AgentCore 内存资源类型， CloudWatch 默认情况下向亚马逊 AgentCore 输出指标。 AgentCore 如果启用这些跨度和日志，还会输出一组默认的跨度和日志。要了解有关[启用跨度和日志的更多信息，请参阅为 AgentCore 运行时、内存、网关、内置工具和身份资源](observability-configure.md#observability-configure-cloudwatch)启用可观察性。

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

## 提供的内存指标
<a name="memory_metrics_summary"></a>

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

延迟  
从接收请求到发送最终响应令牌所经过的总时间。表示对请求的完整端到端处理。

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

系统错误  
导致 Amazon 服务器端错误的调用次数。

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

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

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

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

## 提供的跨度数据
<a name="memory_span_summary"></a>

为了增强可观察性， AgentCore 提供结构化跨度来追踪事件与它们生成或访问的记忆之间的关系。要启用此跨度数据，您需要对代理代码进行检测。要了解更多信息，请参阅为您的亚马逊 Bedrock AgentCore 资源[为您的亚马逊 Bedro AgentCore ck 资源添加可观察性](observability-configure.md)添加可观察性。

该跨度数据可在 CloudWatch 日志和 CloudWatch 应用程序信号中完整获得。要了解有关查看可观测性数据的更多信息，请参阅[查看您的 Amazon Bedro AgentCore ck 代理的可观测性数据。](observability-view.md)

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


| 操作名称 | 跨度属性 | 说明 | 
| --- | --- | --- | 
|  `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`  | 列出可用的内存记录 | 

## 提供的日志数据
<a name="memory_logs_summary"></a>

AgentCore 提供结构化日志，可帮助您监控关键 AgentCore 内存资源进程并对其进行故障排除。要启用此日志数据，您需要检测代理代码。要了解更多信息，请参阅为您的亚马逊 Bedrock AgentCore 资源[为您的亚马逊 Bedro AgentCore ck 资源添加可观察性](observability-configure.md)添加可观察性。

AgentCore 可以将日志输出到日 CloudWatch 志、亚马逊 S3 或 Firehose 数据流。如果您使用 CloudWatch 日志目标，则这些日志将存储在默认日志组下`/aws/vendedlogs/bedrock-agentcore/memory/APPLICATION_LOGS/{memory_id}`或以开头的自定义日志组下`/aws/vendedlogs/`。要了解更多信息，请参阅为 AgentCore 运行时、内存、网关、内置工具和身份资源[启用](observability-configure.md#observability-configure-cloudwatch)可观察性。

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

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

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

 **提取日志 ** 
+ 提取处理的开始和完成
+ 成功提取的内存数量
+ 反序列化或处理输入事件时出现的任何错误

 **合并日志：**
+ 合并处理的开始和完成
+ 需要整合的存储器数量
+ Success/failure 内存添加和更新
+ 相关的内存检索状态

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


| 工作流名称 | 日志字段 | 说明 | 
| --- | --- | --- | 
| 提取 | resource\_arn、事件时间戳、memory\_strategy\_id、命名空间、actor\_id、session\_id、事件 ID、requestID、isError | 分析传入的对话以生成新的记忆 | 
| 整合 | resource\_arn、事件时间戳、memory\_strategy\_id、命名空间、会话 ID、请求 ID、isError | 将提取的存储器与现有存储器相结合 |