查看您的 Amazon Bedro AgentCore ck 代理的可观察性数据
在代理中实现可观测性后,您可以在 CloudWatch 控制台生成的 AI 可观察性页面和日志中查看收集的指标和跟踪。 CloudWatch 请参阅以下章节,了解如何查看代理的指标。
在 Amazon 中使用生成式 AI 可观测性查看数据 CloudWatch
CloudWatch 生成式 AI 可观测性页面显示 AgentCore 代理运行时输出的所有服务提供的指标,以及跨度和轨迹派生的数据(如果您在代理代码中启用了检测功能)。要在中查看可观测性控制面板 CloudWatch,请打开 Amazon CloudWatch GenAi 可观测性页面
借助生成式 AI 可观测性 CloudWatch,您可以查看带有图表和其他数据可视化效果的定制仪表板,以及错误细分、跟踪可视化等。要了解有关在中使用生成式 AI 可观察性的更多信息 CloudWatch,包括如何查看代理的个人会话和跟踪数据,请参阅亚马逊用户指南中的 Amazon Bedrock AgentCore 代理。 CloudWatch
在中查看其他数据 CloudWatch
还可以在中查看所有服务提供的指标和跨度 CloudWatch,以及您的检测代理代码输出的任何指标。
要查看这些数据,请参阅以下章节。
日志
-
打开 CloudWatch 控制台
。 -
在左侧导航窗格中,展开日志,然后选择日志组
-
使用搜索字段查找您的代理、内存或网关资源的日志组。
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
-
-
轨迹和跨度
通过跟踪,您可以看到通过代理的请求执行路径:
-
位置:代理
spans日志组 (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>) 中的default日志流,或者使用共享跨度目标的代理的aws/spans日志组中的日志流。有关更多信息,请参阅 Amazon Bedrock AgentCore 运行时中托管的代理的 Span 目标。 -
通过以下方式访问: 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 控制台
-
从左侧导航栏中选择 “交易搜索”
-
按服务名称或其他条件筛选
-
选择一条跟踪以查看详细的执行图
指标
如果您按照启用可观测性中所述通过检测代理代码来启用 AgentCore 可观察性,则您的代理会自动生成 OTEL 指标,这些指标将 CloudWatch 使用增强指标格式 (EMF) 发送到:
-
命名空间:
bedrock-agentcore -
通过以下方式访问: CloudWatch 指标控制台
-
内容:您的代理代码和框架生成的自定义指标
-
自动收集:无需其他代码-由 ADOT 工具生成
除了代理发出的指标外,该 AgentCore 服务还向发布标准服务指标。 CloudWatch有关这些指标的列表,请参阅AgentCore 生成的运行时可观测性数据。