扣子罗盘提供了可视化的 Trace 数据记录,你可以直观地查看不同处理环节的详细信息例如延迟、token 消耗等。
在扣子罗盘 观测 > Trace 页面,可查看指定应用在特定时间范围内上报的 Trace 数据。
在 Trace 列表,选择目标记录后,可查看 Trace 详情。
你可以选择每个 Span 查看其 Run、Metadata 和 Feedback 信息:
tags 和 runtime 信息),并支持一键复制。元数据是以键值对形式存储的补充信息,例如应用程序版本、运行环境和调用的模型等。你还可以单击 仅展示轨迹节点 按钮查看轨迹(Trajectory)数据。如果要查看指定节点的详细信息,你可以选择该节点。每个节点代表一个 Span。
说明
Agent 的 Trace 数据被上报到扣子罗盘后,扣子罗盘可以自动提取出轨迹数据。关于轨迹,详情参阅 轨迹评测介绍。
你还可以单击 仅展示轨迹节点 按钮旁的下拉箭头,单击 设置轨迹展示规则,在 轨迹节点规则配置 窗口创建筛选条件,对需要显示的轨迹节点进行筛选。筛选条件对空间内所有 Trace 生效。
说明
你可以通过设置轨迹展示规则展示原本不属于轨迹的节点,例如 invoke_agent 节点。
Trace 列表包含以下信息。
|
Trace 信息 |
说明 |
示例 |
|---|---|---|
|
Trace ID |
唯一标识请求完整链路的 ID,用于关联所有相关数据。 |
118f0c30f303292305f7bb7ee003f9**** |
|
Input |
请求的原始输入内容。例如,文本信息或 API 调用参数等。 |
|
|
Output |
请求的最终输出结果。例如模型生成的回答或 API 返回数据。 |
|
|
Tokens |
本次请求的输入和输出总 token 数量。 |
1405 |
|
Input Tokens |
输入信息的 token 数量。 |
1116 |
|
Output Tokens |
输出信息的 token 数量。 |
289 |
|
Latency |
请求从开始到结束的总耗时。 |
1200ms |
|
LatencyFirstResp |
流式响应中首次返回数据的时间。 |
300ms |
|
Start Time |
请求开始处理的时间戳。 |
2025-04-03 15:21:41 |
|
SpanID |
子请求的唯一标识。 |
1b4c709f137cb1af |
|
SpanType |
子请求的类型,例如数据库查询、API调用、模型推理。 |
Agent |
|
SpanName |
子操作的名称,自定义或系统预设。 |
ReActAgent |
|
PromptKey |
触发模型响应的提示词标识。 |
travel.bot |
|
火山应用 |
火山应用的名称。 |
travel_agent |
|
火山智能体 |
火山智能体的名称。 |
travel_agent.v2 |
|
Coze 智能体 |
Coze 平台特定智能体实例的名称。 |
周末趣享助手 |
|
Coze 应用 |
Coze 平台特定关联应用的名称。 |
长文写作助手 |
|
数据到期时间 |
请求数据在系统中的保留截止时间。 |
2025-04-06 15:21:41 |
在调试过程中,为了方便开发者快速查看所需的 Trace 数据,扣子罗盘提供筛选器和应用视图功能,支持快速筛选。
下表列举了观测功能支持的 Trace 数据的筛选维度。
|
筛选维度 |
说明 |
|---|---|
|
上报时间 |
支持选择要查看的 Trace 数据的时间范围。
|
|
查看方式 |
支持筛选 Root Span、All Span、Model Span 三种可选类型的 Trace。
|
|
数据来源 |
支持筛选以下类型的 Trace 数据:
|
|
Input |
支持筛选 Input 包含特定信息、为空、不为空三种类型的 Trace。 |
|
Output |
支持筛选 Output 包含特定信息、为空、不为空三种类型的 Trace。 |
|
Latency |
支持筛选指定延迟时长的 Trace。 |
|
LatencyFirstResp |
支持筛选指定首次返回延迟时长的 Trace。 |
|
MessageID |
支持筛选指定 Message ID 的 Trace。 |
|
SpanType |
支持筛选指定 SpanType 的 Trace。 |
|
Status |
支持筛选成功或失败状态的 Trace。 |
|
TraceID |
支持筛选指定 TraceID 的 Trace。 |
|
UserID |
支持筛选指定 UserID 的 Trace。 |
|
SpanName |
支持筛选指定 SpanName 的 Trace。 |
下表列举了观测功能支持的轨迹节点的筛选维度。
|
筛选维度 |
说明 |
|---|---|
|
SpanType |
支持根据 SpanType 筛选 Span 作为轨迹节点。 |
|
SpanName |
支持根据 SpanName 筛选 Span 作为轨迹节点。 |
|
Metadata |
支持根据 Metadata 中特定字段的值筛选 Span 作为轨迹节点。例如,你可以筛选出 Metadata 中 |
|
Feedback-自动评测 |
在自动评测场景下,支持筛选 Feedback 中指定评估器返回的值符合指定条件的 Span 作为轨迹节点。 |
|
Feedback-人工标注 |
在人工标注场景下,支持筛选 Feedback 中指定标签的值符合指定条件的 Span 作为轨迹节点。 |
Trace 列表页提供两种系统视图:
此外,Trace 列表页支持创建个人偏好视图,可在过滤器中选定个人偏好后,单击保存视图并输入视图名称。
视图保存完成后,点击视图即可快速筛选符合个人偏好的 Trace,再次点击视图即可退出个人视图。