You need to enable JavaScript to run this app.
文档中心
数据智能体

数据智能体

请输入
  • 文档首页
    • 数据智能体用户研究 AgentAgent 运营分析Trace 分析
复制全文
下载 pdf
我的收藏
Agent 运营分析
Trace 分析
复制全文
下载 pdf
我的收藏
Trace 分析

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

功能简介

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

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

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

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

功能入口
  1. 登录增长分析平台。
  2. 在顶部导航栏，选择 Agent 运营分析。
  3. 在左侧选择业务空间，并进入 Trace分析 > Trace列表页面。
    Image

列表配置

设置筛选项过滤数据

设置筛选条件，查询链路数据。
Image
具体筛选参数说明如下表所示：

过滤项

说明

时间段

查询指定时间范围内的 Trace 分析数据。
Image

搜索栏

输入会话 ID、消息 ID 或用户 ID 进行搜索。
Image

Span 类型

支持选择：

  • Root Span：根据 TraceID 查询，以调用入口为粒度进行展示。
  • All Span：查询所有 SpanID，以上报埋点为粒度进行展示。
  • Model Span：仅查询和模型调用相关的埋点。
  • Skill Span：仅查询和 Skill 调用相关的埋点。
  • Tool Span：仅查询和 Tool 调用相关的埋点。
  • MCP Span：仅查询和 MCP 调用相关的埋点。
  • RAG Span：仅查询和 RAG 调用相关的埋点。

高级筛选

  1. 单击高级筛选，默认必填来源，来源筛选项和其他筛选项固定为 AND 关系。
  2. 支持继续添加属性过滤、行为权限、分群过滤筛选项，各项之间的关系可切换为 AND 或 OR。

Image

配置常驻筛选

  1. 支持自定义配置常驻筛选项。
    Image
  2. 选择指定属性作为筛选项。
    Image
    配置完成后筛选项常驻页面顶部，用于筛选指定范围的 Trace。
    Image

配置列表字段

列表的 Trace ID 字段固定展示，其他所展示的字段支持自定义配置：
Image
字段说明：

  • Session ID：会话 ID
  • 输入内容：请求的原始输入内容
  • 输出内容：请求的最终输出结果
  • 开始时间：请求开始处理的时间
  • 耗时：请求从开始到结束的总耗时
  • 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
  • 自定义字段：可选择指定的用户属性展示在列表中

添加视图

支持把当前筛选配置和列配置存为自定义视图，视图对空间内所有用户可见。
Image

查看 Trace 数据
  1. 在 Tarce 列表单击数据行，进入 Trace 详情页面，在该页面可查看以下信息。
    Image
    页面左侧为调用树，展示完整的执行链路，单击某一操作单元（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 的元数据。
  2. （可选）左侧调用树支持以下筛选操作。
    • 设置筛选条件并搜索指定 Span。
      Image
    • 设置属性筛选条件过滤 Span。支持添加多个属性筛选项，各项之间关系支持 AND 或 OR。
      Image
最近更新时间：2026.08.04 10:34:27
这个页面对您有帮助吗？
有用
有用
无用
无用