# 查看您的 Amazon Bedro AgentCore ck 代理的可观察性数据
<a name="observability-view"></a>

在代理中实现可观测性后，您可以在 CloudWatch 控制台生成的 AI 可观察性页面和日志中查看收集的指标和跟踪。 CloudWatch 请参阅以下章节，了解如何查看代理的指标。

## 在 Amazon 中使用生成式 AI 可观测性查看数据 CloudWatch
<a name="observability-view-console"></a>

 CloudWatch 生成式 AI 可观测性页面显示 AgentCore 代理运行时输出的所有服务提供的指标，以及跨度和轨迹派生的数据（如果您在代理代码中启用了检测功能）。要在中查看可观测性控制面板 CloudWatch，请打开 [Amazon CloudWatch GenAi 可观测性页面](https://console.aws.amazon.com/cloudwatch/home#gen-ai-observability)。

借助生成式 AI 可观测性 CloudWatch，您可以查看带有图表和其他数据可视化效果的定制仪表板，以及错误细分、跟踪可视化等。*要了解有关在中使用生成式 AI 可观察性的更多信息 CloudWatch，包括如何查看代理的个人会话和跟踪数据，请参阅[亚马逊用户指南中的 Amazon Bedrock AgentCore 代理](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AgentCore-Agents.html)。 CloudWatch *

## 在中查看其他数据 CloudWatch
<a name="observability-view-cw"></a>

还可以在中查看所有服务提供的指标和跨度 CloudWatch，以及您的检测代理代码输出的任何指标。

要查看这些数据，请参阅以下章节。

### 日志
<a name="observability-view-cw-logs"></a>

1. 打开 [CloudWatch 控制台](https://console.aws.amazon.com/cloudwatch/home)。

1. 在左侧导航窗格中，展开**日志**，然后选择**日志组** 

1. 使用搜索字段查找您的代理、内存或网关资源的日志组。

   AgentCore 代理日志组采用以下格式：
   +  **标准日志**- stdout/stderr 输出
     +  **位置**：/aws/bedrock-agentcore/runtimes/<agent\_id>-<endpoint\_name>/[运行日志] <UUID>
     +  **包含**：运行时错误、应用程序日志、调试语句
     +  **用法示例**：
       + print (“正在处理请求...”) \# 出现在标准日志中
       + logging.info (“请求已成功处理”) \# 出现在标准日志中
   +  **OTEL 结构化日志**-详细操作信息
     +  **位置**：/aws/bedrock-/-agentcore/runtimes /otel-rt <agent\_id>-lo <endpoint\_name>gs
     +  **包含**：执行详情、错误跟踪、性能数据
     +  **自动收集**：无需其他代码-由 ADOT 工具生成
     +  **优点**：可以包括将日志链接到相关跟踪的关联 ID

### 轨迹和跨度
<a name="observability-view-cw-spans"></a>

通过跟踪，您可以看到通过代理的请求执行路径：
+ 位置：代理`spans`日志组 (`/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>`) 中的`default`日志流，或者使用共享跨度目标的代理的`aws/spans`日志组中的日志流。有关更多信息，请参阅 [Amazon Bedrock AgentCore 运行时中托管的代理的 Span 目标](observability-configure.md#observability-configure-unified-traces)。
+ 通过以下方式访问： CloudWatch 交易搜索控制台
+ 要求：必须启用 CloudWatch 交易搜索

轨迹会自动捕获：
+ 代理调用序列
+ 与框架组件（LangChain等）集成
+ 法学硕士电话和回复
+ 工具调用和结果
+ 错误路径和异常

对于跨服务的分布式跟踪，您可以使用标准的 HTTP 标头：
+  AWS X-Ray 格式：`X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1`
+ W3C 格式：`traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01`

要查看记录，请执行以下操作：
+ 导航到 CloudWatch 控制台
+ 从左侧导航栏中选择 “**交易搜索**”
+ 按服务名称或其他条件筛选
+ 选择一条跟踪以查看详细的执行图

### 指标
<a name="observability-view-cw-metrics"></a>

如果您按照启用可观测性中所述通过检测代理代码来[启用 AgentCore 可观察性](observability-configure.md#observability-configure-builtin)，则您的代理会自动生成 OTEL 指标，这些指标将 CloudWatch 使用增强指标格式 (EMF) 发送到：
+ 命名空间: `bedrock-agentcore` 
+ 通过以下方式访问： CloudWatch 指标控制台
+ 内容：您的代理代码和框架生成的自定义指标
+ 自动收集：无需其他代码-由 ADOT 工具生成

除了代理发出的指标外，该 AgentCore 服务还向发布标准服务指标。 CloudWatch有关这些指标的列表，请参阅[AgentCore 生成的运行时可观测性数据](observability-runtime-metrics.md)。