View a markdown version of this page

查看您的亚马逊 Bedro AgentCore ck 代理的可观测性数据 - Amazon Bedrock AgentCore
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

查看您的亚马逊 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 标头:

  • Amazon 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 生成的运行时可观测性数据。