文档中心

ArkClaw 企业版

管理员观测ArkClaw

查看ArkClaw Trace分析

平台针对 ArkClaw 提供单独 Trace 分析页面，用于追踪 ArkClaw 的完整调用链路，方便查询调用关系，分析链路问题。本文为您详细介绍如何查看 ArkClaw 相关的 Trace 信息。

背景信息

Span 是分布式跟踪中的基本工作单元，代表系统中执行的一个操作，例如：一次数据库查询、一个函数执行、一次远程服务调用等。每个 Span 拥有唯一标识，附带操作名称、开始时间、结束时间、标签、日志等关键属性。

Trace 是由多个 Span 组成的有向无环图，代表一个请求在分布式系统中的完整调用链。每个 Trace 拥有全局唯一的标识符，所有属于同一请求的 Span 都将被关联到此 Trace。Trace 和 Span 之间存在父子关系，这种关系有助于理解请求在系统中的执行链路，方便链路追踪。

前提条件

操作步骤

选择观测看板和数据分析的数据来源。其中，Claw 实例页面展示员工 Claw 相关观测看板和数据分析；企业服务智能体页面展示企业服务智能体相关观测看板和数据分析。

说明

所有筛选项和筛选规则均按“与”逻辑生效，即满足所有条件的数据才会被筛选并用数据分析。

序号	筛选项	说明
1	聚合方式	图表中数据展示的聚合方式。自动聚合：动态聚合方式，根据筛选的数据量，自动选择合适的聚合时间进行数据展示。指定聚合时间：静态聚合方式，根据指定的聚合时间进行数据展示。最少支持按 30 秒聚合，最多支持按 1 天聚合。
2	时间范围	数据筛选的时间范围。支持手动刷新数据或自动刷新数据，可根据实际需求配置。按最近筛选：根据当前时间，动态筛选最近时间段内的 Trace 数据，例如：筛选最近 1 小时的数据。指定时间范围：指定时间范围，静态筛选某个时间段内的 Trace 数据，例如：筛选 2025-11-08 00:00:00 到 2025-11-10 00:00:00 时间段内的数据。
3	标签筛选	根据标签键值对进行数据筛选。最多支持配置 20 个标签，多个标签按“与”逻辑生效，即命中所有标签的数据才会被筛选出来。
4	Span 属性筛选	根据 Span 键值对进行数据筛选。支持配置多条 Span 属性，多个 Span 属性规则按“与”逻辑生效，即匹配到所有 Span 属性的数据才会被筛选出来。
5	其他属性筛选	多个 Trace 关联信息的筛选项，用于精细化筛选，例如：ArkClaw 实例 ID、Trace ID、模型名称、Span 类型、AI Span 类型、接口名等。多个筛选项按“与”逻辑生效，即匹配到所有筛选规则的数据才会被筛选出来。

Root Span 列表：列举当前筛选范围内所有 Root Span 相关 Trace，并展示 Trace 相关详细信息，例如：TraceID、Input/Output、模型名称、Total Tokens、AI Span 类型、开始时间、耗时、服务名、接口名、操作、会话 ID 等。此外，支持按照 Total Tokens、Input Tokens、Output Tokens、开始时间和耗时进行排序，用于快速定位错误和慢查询。

说明

分布式链路追踪中，Root Span 是一条完整 Trace 的根节点 Span。每个 Trace 有且仅有一个 Root Span，所有子 Span 都以它为起点，构成完整的请求链路树。

Span 上报量趋势：展示当前筛选数据的 Trace 上报量趋势，可视化直观查看 Trace 上报量的健康状况，有助于故障排查定位、性能评估、容量规划等。例如：某个时间点 Trace 上报量突然大幅增加，可能意味着系统出现异常活动，可结合时间点和其他观测指标，快速定位问题发生的具体服务。

Span 列表：列举当前筛选范围内的所有 Span 相关 Trace，并展示 Trace 相关详细信息，例如：TraceID、Input/Output、模型名称、Total Tokens、AI Span 类型、开始时间、耗时、服务名、接口名、操作、会话 ID 等。此外，支持按照 Total Tokens、Input Tokens、Output Tokens、开始时间和耗时进行排序，用于快速定位错误和慢查询。

Trace 详情

Trace 完整日志

切换到 Trace 详情页签，支持查看完整请求链路和 Span 相关详细信息，方便精细化数据分析。

序号	模块	说明
1	Trace 信息	显示当前 Trace 相关详细信息，例如：Trace ID、开始时间、总耗时、应用数、Span 数等。
2	视图切换	提供列表、拓扑图、火焰图 3 种视图，可根据实际场景选择合适的视图，查看 Span 详情。列表：信息全面，方便快速筛选和 Span 查找。拓扑图：直观展示链路关系，快速定位问题的上下游关键节点。火焰图：可视化性能分析，有利于深入分析函数调用关系。
3	Span 筛选	快捷筛选按钮，提供组件标签、大模型组件标签、查看异常 Span、按关键字搜索。
4	Span 视图	Span 详细视图，可选用合适视图进行故障分析或性能分析等。
5	Span 详情	单击目标 Span，支持查看 Span 相关详细信息，包括：基本信息、LLM 数据、属性、资源、事件等 Span 相关详细信息，以及进程、容器、LLM 等 Span 相关指标详情。说明当前链路追踪相关的服务存在大模型数据时，才会展示 LLM 数据和 LLM 指标相关信息。

更多操作

切换到 Trace 详情页签，前往单链路详情右下角详细信息页签的 LLM 数据栏，可查看当前链路调用模型的基础数据，例如：Input/Output 数据，Request 的系统、模型、类型，Response 的模型、Input 缓存命中 Token、Input Token 消耗、Output Token 消耗、总 Token 消耗。

前往单链路详情右下角指标页签的 LLM 栏，可查看当前链路追踪相关的服务以及大模型数据，例如：大模型调用 QPS、大模型调用次数、Token 使用量、大模型响应耗时、TTFT、TPOT 监控看板。

可将 Span 信息导出可用于数据评测、链路诊断算法验证、检测规则优化、异常识别效果评估、故障案例沉淀与复现等场景。更多详细说明参见：导出 Span 数据到本地文件。

最近更新时间：2026.08.25 20:31:17

这个页面对您有帮助吗？

有用

无用