全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

Trace 分析

最近更新时间:2026-07-06 16:36:31

Trace 分析通过 Trace 上报的 Span 信息和关联日志信息,提供链路分析、单链路检索等能力,有助于故障排查、性能优化和系统监控,提高运维效率。本文针对通用 AI 应用监控为您详细介绍如何使用 LLM Trace 分析。

背景信息

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

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


前提条件

已经将 LLM 相关应用接入 AI 应用监控,并正常上报观测数据。不同语言的接入方式各不相同,更多详细说明参见:接入方式


操作步骤

步骤一:Trace 数据筛选

  1. 登录 AI 可观测,并在顶部导航栏选择项目和地域。

  2. 在左侧导航栏单击 Trace 分析,选择时间范围,查看固定时间段内的所有 Trace 列表和 Trace 相关基本信息。

  3. 根据实际情况筛选需要分析的 Trace 数据。

    提醒:目前暂时不支持数据聚合方式处理


步骤二:Trace 数据分析

数据筛选完成后,即可对数据进行分析和链路追踪,目前提供 Span 列表、性能分析、错误传播链分析。

Root Span 列表

Root Span 列表主要展示当前筛选范围内所有 Root Span 相关 Trace,并展示 Trace 相关详细信息,例如:TraceID、模型名称、Total Tokens、AI Span 类型、开始时间、耗时、服务名、接口名、操作、会话 ID 等。

此外,支持按照 Total Tokens、Input Tokens、Output Tokens、开始时间和耗时进行排序,用于快速定位错误和慢查询。

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


步骤三:查看单链路详情

Trace 详情

单击 TraceID,可跳转到单链路详情页面。切换到 Trace 详情页签,支持查看完整请求链路和 Span 相关详细信息,方便精细化数据分析。

单击 【拓扑】 可按调用顺序展示每个调用的关系及相关性能,方便用户定位最差性能节点。

模块

说明

Trace 信息

显示当前 Trace 相关详细信息,例如:Trace ID、开始时间、总耗时、应用数、Span 数等。

视图切换

提供列表、拓扑图、火焰图 3 种视图,可根据实际场景选择合适的视图,查看 Span 详情。

  • 列表:信息全面,方便快速筛选和 Span 查找。

  • 拓扑图:直观展示链路关系,快速定位问题的上下游关键节点。

  • 火焰图:可视化性能分析,有利于深入分析函数调用关系。

Span 筛选

快捷筛选按钮,提供组件标签、大模型组件标签、查看异常 Span、按关键字搜索。

Span 视图

Span 详细视图,可选用合适视图进行故障分析或性能分析等。

Span 详情

单击目标 Span,支持查看 Span 相关详细信息,包括:基本信息、LLM 数据、属性、LLM 等 Span 相关指标详情。

当前链路追踪相关的服务存在大模型数据时,才会展示 LLM 数据和 LLM 指标相关信息。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈