Agent 运营分析内置的观测工具，为您提供可视化的全链路请求调用记录。本文介绍如何观测数据。

通过观测工具可获取以下数据：

• Trace：一次完整请求的调用链记录。
• Span：Trace 中的一个独立操作单元，例如一次模型调用，一次函数调用等。Trace 中的首个 Span 为 Root Span，完整呈现请求从发起至结束的全生命周期。Root Span 下的 span 提供请求执行过程中更详细的上下文信息。

使用观测工具，可以帮助您：

• 了解模型在不同任务上的运行时间和资源消耗情况，以便进行性能优化。
• 当模型出现错误输出时，通过 Trace 可以追踪计算过程，定位错误发生的位置。
• 确保模型的使用符合安全和合规要求。通过 Trace 可以记录模型的输入和输出，以及中间计算过程，以便进行审计和监管，同时检测潜在的安全漏洞和恶意攻击。

1. 登录 Agent 运营分析平台。
2. 在左侧选择业务空间，并进入观测工具 > 数据观测页面。
3. 设置过滤器、筛选条件，查询链路数据。

   • 过滤器：默认需要设置查看方式和数据来源，同时支持自定义添加筛选条件，自定义的条件支持设置且、或逻辑关系，具体过滤器参数说明如下表所示。
     

     过滤项	说明
     查看方式	必填过滤项，支持以下方式： Root Span：根据 TraceID 查询，以调用入口为粒度进行展示。 All Span：查询所有 SpanID，以上报埋点为粒度进行展示。 Model Span：仅查询和模型调用相关的埋点。 Skill Span：仅查询和 Skill 调用相关的埋点。 Tool Span：仅查询和 Tool 调用相关的埋点。 MCP Span：仅查询和 MCP 调用相关的埋点。 RAG Span：仅查询和 RAG 调用相关的埋点。
     数据来源	必填过滤项，目前支持 SDK 上报。
     自定义过滤项	Agent：可设置是否属于指定 Agent，或Agent 是否为空。 Duration：可设置链路耗时范围，或耗时是否为空。 Input：可设置包含指定输入，或输入是否为空。 LatencyFirstResp：可设置首 Token 响应耗时范围，或耗时是否为空。 MessageID：可设置是否属于指定消息，或消息 ID 是否为空。 Output：可设置包含指定输出，或输出是否为空。 SpanName：可设置包含指定 Span 名称，或名称是否为空。 SpanType：可设置是否属于指定 Span 类型，或类型是否为空。 Status：可设置是否属于指定的链路状态（成功或失败）。 TraceID：可设置是否属于指定 Trace，或 TraceID 是否为空。 UserID：可设置是否属于指定用户，或用户 ID 是否为空。

   • 筛选条件：

     • 支持自定义时间段筛选
     • 支持设置查看方式、数据来源筛选
     • 支持自定义视图，视图配置方式与过滤器一致。
       
4. 查看链路观测数据。
   
   字段说明：
   • Trace ID：追踪链路 ID
   • Input：请求的原始输入内容
   • Output：请求的最终输出结果
   • Tokens：输入和输出的总 Token 数
   • Input Tokens：输入 Token 数
   • Output Tokens：输出 Token 数
   • Latency：请求从开始到结束的总耗时
   • LatencyFirstResp：流式响应中首次返回数据的时间
   • Start Time：请求开始处理的时间
   • SpanID：操作单元 ID
   • SpanName：操作单元名称
   • SpanType：操作单元类型，例如 Agent、Model
   • Agent：Agent ID
   • 数据到期时间：请求数据在系统中的保留截止时间
5. 单击数据行，进入 Trace 详情页面，在该页面可查看以下信息。
   
   • 调用树：完整的执行链路，单击某一 Span，可查看对应的 Run、Metadata 数据。
   • Run：展示所选 Span 的输入和输出数据，页面右侧展示链路状态、SpanID、类型等详细数据。
   • Metadata：以 JSON 格式展示所选 Span 的所有元数据。