View a markdown version of this page

查看您的亚马逊 Bedro AgentCore ck 代理的可观测性数据 - 亚马逊基岩 AgentCore
在亚马逊中使用生成式 AI 可观测性查看数据 CloudWatch在中查看其他数据 CloudWatch

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

查看您的亚马逊 Bedro AgentCore ck 代理的可观测性数据

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

在亚马逊中使用生成式 AI 可观测性查看数据 CloudWatch

CloudWatch 生成式 AI 可观测性页面显示 AgentCore 代理运行时输出的所有服务提供的指标，以及跨度和跟踪派生数据（如果您在代理代码中启用了检测）。要在中查看可观测性控制面板 CloudWatch，请打开亚马逊 CloudWatch GenAi 可观测性页面。

借助生成式 AI 可观测性 CloudWatch，您可以查看量身定制的仪表板，其中包含图表和其他数据可视化效果，以及错误分解、跟踪可视化等。要了解有关在中使用生成式 AI 可观测性的更多信息 CloudWatch，包括如何查看代理的个人会话和跟踪数据，请参阅亚马逊用户指南中的 Amazon Bedrock AgentCore 代理。 CloudWatch

在中查看其他数据 CloudWatch

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

要查看这些数据，请参阅以下部分。

日志

  1. 打开 CloudWatch 控制台。

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

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

    AgentCore 代理日志组采用以下格式：

    • 标准日志 - stdout/stderr 输出

      • 位置：/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>/[运行日志] <UUID>

      • 包含：运行时错误、应用程序日志、调试语句

      • 用法示例：

        • print (“正在处理请求...”) # 出现在标准日志中

        • logging.info (“请求成功处理”) # 出现在标准日志中

    • OTEL 结构化日志 -详细的操作信息

      • 位置：/aws/bedrock-agentcore/runtimes/-/otel-rt <agent_id>-l <endpoint_name>ogs

      • 包含：执行详情、错误跟踪、性能数据

      • 自动收集：无需额外代码-由 ADOT 仪器生成

      • 优点：可以包括将日志链接到相关跟踪的关联 ID

轨迹和跨度

跟踪可通过您的代理查看请求执行路径：

  • 位置：代理spans日志组 (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>) 中的default日志流，或使用共享跨度目标的代理的aws/spans日志组中的日志流。有关更多信息，请参阅 Amazon Bedrock AgentCore 运行时中托管的代理的跨度目标。

  • 通过以下方式访问： CloudWatch 交易搜索控制台

  • 要求：必须启用 CloudWatch 交易搜索

轨迹自动捕获：

  • 代理调用顺序

  • 与框架组件（LangChain等）集成

  • LLM 电话和回复

  • 工具调用和结果

  • 错误路径和异常

对于跨服务的分布式跟踪，可以使用标准的 HTTP 标头：

  • AWS X-Ray 格式：X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

  • W3C 格式：traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

要查看轨迹，请：

  • 导航到 CloudWatch 控制台

  • 从左侧导航栏中选择 “交易搜索”

  • 按服务名称或其他条件筛选

  • 选择跟踪记录以查看详细的执行图

指标

如果您按照启用可观察性中所述通过检测代理代码来启用可 AgentCore 观察性，则您的代理会自动生成 OTEL 指标，这些指标将 CloudWatch 使用增强指标格式 (EMF) 发送到：

  • 命名空间: bedrock-agentcore

  • 通过以下方式访问： CloudWatch 指标控制台

  • 内容：由您的代理代码和框架生成的自定义指标

  • 自动收集：无需额外代码-由 ADOT 仪器生成

除了代理发出的指标外，该 AgentCore 服务还将标准服务指标发布到。 CloudWatch有关这些指标的列表，请参阅AgentCore 生成的运行时可观测性数据。