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

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

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

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

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

1. 登录增长分析平台。

2. 在顶部导航栏，选择 Agent 运营分析。

3. 在左侧选择业务空间，并进入 Agent行为观测 > Trace观测页面。

4. 设置筛选条件，查询链路数据。
   
   默认需要设置查看方式和数据来源，同时支持自定义添加筛选项，自定义筛选支持设置且（AND）、或（OR）​逻辑关系，具体筛选参数说明如下表所示。

   过滤项	说明
   查看方式	必填过滤项，支持以下方式： Root Span：根据 TraceID 查询，以调用入口为粒度进行展示。 All Span：查询所有 SpanID，以上报埋点为粒度进行展示。 Model Span：仅查询和模型调用相关的埋点。 Skill Span：仅查询和 Skill 调用相关的埋点。 Tool Span：仅查询和 Tool 调用相关的埋点。 MCP Span：仅查询和 MCP 调用相关的埋点。 RAG Span：仅查询和 RAG 调用相关的埋点。
   数据来源	必填过滤项，支持 SDK 上报、离线导入、dataAgent。
   自定义筛选项	单击添加筛选项，支持添加链路耗时、链路状态、token数、模型名称以及输入输出内容等自定义筛选项。

   其他筛选条件：

   • 支持自定义时间段筛选。
   • 支持设置 Span 类型、数据来源筛选。

   

5. 查看链路观测数据。
   字段说明：

   • Trace ID：追踪链路 ID
   • Session ID：会话 ID
   • 状态：Trace 状态
   • Input：请求的原始输入内容
   • Output：请求的最终输出结果
   • Tokens：输入和输出的总 Token 数
   • Input Tokens：输入 Token 数
   • Output Tokens：输出 Token 数
   • 耗时：请求从开始到结束的总耗时
   • LatencyFirstResp：流式响应中首次返回数据的时间
   • 开始时间：请求开始处理的时间
   • SpanID：操作单元 ID
   • SpanName：操作单元名称
   • SpanType：操作单元类型，例如 Agent、Model
   • Agent：Agent ID
   • DataAgent ID：DataAgent ID
   • 数据到期时间：请求数据在系统中的保留截止时间
   • Trace评估标签：链路评估标签
   • Session评估标签：会话评估标签

6. 单击数据行，进入 Trace 详情页面，在该页面可查看以下信息。
   
   页面左侧为调用树，展示完整的执行链路，单击某一操作单元（Span），可查看对应的 Run、Metadata 数据。

   • Run：展示所选 Span 的输入和输出数据。在页面右侧展示 Span 的参数信息，部分参数说明：
     • Status：当前链路的状态
     • Span ID：操作单元 ID
     • Type：类型，例如模型（model）、技能（skill）、提示词（prompt）
     • 耗时：执行当前链路的耗时
     • 开始时间：请求开始处理的时间
     • Tokens：输入和输入的总 Token 数
   • Metadata：以 JSON 格式展示所选 Span 的元数据。