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

通过 Trace 分析功能可获取以下数据：

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

使用Trace 分析功能，可以帮助您：

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

1. 登录增长分析平台。

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

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

4. 设置筛选条件，查询链路数据。
   

   具体筛选参数说明如下表所示：

   过滤项	说明
   Trace 范围	支持选择全部Trace、所有异常、长耗时。
   时间段	查询指定时间范围内的 Trace 分析数据。
   Span 类型	支持选择： Root Span：根据 TraceID 查询，以调用入口为粒度进行展示。 All Span：查询所有 SpanID，以上报埋点为粒度进行展示。 Model Span：仅查询和模型调用相关的埋点。 Skill Span：仅查询和 Skill 调用相关的埋点。 Tool Span：仅查询和 Tool 调用相关的埋点。 MCP Span：仅查询和 MCP 调用相关的埋点。 RAG Span：仅查询和 RAG 调用相关的埋点。
   数据来源	支持选择 SDK 上报、离线导入。
   配置筛选	单击配置筛选，默认必填： 查看方式：对应 Span 类型筛选项。 数据来源：对应数据来源筛选项。 单击添加筛选项，支持自定义添加多个筛选项，多个选项之间可切换 AND 或 OR 关系。

5. 查看链路观测数据。
   列表所展示的字段支持自定义配置：
   
   字段说明：

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

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

   • Run：展示所选 Span 的输入和输出数据。在页面右侧展示 Span 的参数信息，部分参数说明：
     • Status：当前链路的状态
     • Span ID：操作单元 ID
     • Session ID：会话 ID
     • Type：类型，例如模型（model）、技能（skill）、提示词（prompt）
     • 耗时：执行当前链路的耗时
     • 开始时间：请求开始处理的时间
     • Tokens：输入和输入的总 Token 数
     • ModelProvider：模型服务商
     • ModelName：模型名称
     • Stream：流式响应
     • LatencyFirstResp：流式响应中首次返回数据的时间
   • Metadata：以 JSON 格式展示所选 Span 的元数据。

1. 登录增长分析平台。
2. 在顶部导航栏，选择 Agent 运营分析。
3. 在左侧选择业务空间，并进入 Agent行为观测 > Trace分析 > Trace快捷查询页面。
   在该页面，您可以通过指定 Session ID、Trace ID 或 Span ID，查询指定时间段内的 Trace 数据。