Query Trace
目录
Feature Overview
分布式追踪查询功能通过收集服务间调用的元数据信息，为微服务架构提供全链路追踪能力，帮助用户快速定位跨服务调用问题。该功能主要解决以下问题：
- 请求链路追踪：还原复杂分布式系统中的完整请求路径。
- 性能瓶颈分析：识别链路中耗时异常的调用节点。
- 故障根因定位：通过错误标记快速定位问题发生点。
适用场景包括：
- 生产环境故障排查时快速定位异常服务。
- 性能调优时识别高延迟调用链路。
- 新版本发布后验证服务间调用关系。
核心价值：
- 提升分布式系统的可观测性。
- 降低平均恢复时间（MTTR）。
- 优化服务间调用性能。
Main Features
- 多维度查询：支持 TraceID、服务名、标签等 9 种查询条件组合。
- 可视化分析：通过时间序列瀑布图直观展示调用层级和时间分布。
- 精准定位：支持错误 Span 过滤及标签二次搜索。
Feature Advantages
- 快速定位问题：通过多维度查询条件缩小排查范围，加快问题定位速度。
- 可视化呈现：采用时间序列瀑布图直观展示调用关系，降低复杂度，提高故障分析效率。
- 灵活多样：支持简单查询和复杂组合，适应多种运维和开发场景。
Trace Query
Step 1: Combine Query Conditions
提示：查询条件可以组合使用。您可以通过添加多个查询条件来细化查询。
Step 2: Execute Query
- 选择查询条件并输入对应值后，点击 Add to query 按钮，当前条件将显示在 Query 结果区域，并触发查询。
- 也可展开 Common search condition 快速添加最近使用的搜索条件。
Query Result Analysis
输入查询条件并搜索后，页面将生成查询结果区域。
Span List
查询结果区域左侧显示符合条件的 Span 列表及其基本信息，包括：服务名称、调用接口或请求处理方法、持续时间和开始时间。
Time-Series Waterfall Chart
查询结果区域右侧的时间序列瀑布图清晰展示单条 Trace 中 Span 之间的调用关系。时间序列瀑布图在 Trace 分析中的主要特点如下：
- 自上而下展开：时间序列瀑布图中，各调用事件（Span）通常自图表顶部向下展开，每个横条代表一次服务调用或处理。位置一般反映操作的逻辑调用顺序。
- 时间轴对齐：时间序列瀑布图的横轴表示时间，每个条的长度表示该调用的持续时间，直观比较不同调用间的时间关系。
- 缩进描述：缩进表示调用的层级关系，缩进越深表示该调用在链路中的调用深度越大。
- 交互及详细数据展示：点击时间序列瀑布图中的条可显示该调用的更多详细信息。
Span Details
点击时间序列瀑布图中 Span 的行，可展开查看该 Span 的详细信息，包括：
- Service：Span 所属服务。
- Span Duration (ms)：Span 的持续时间。
- URL：服务访问的 URL，对应 Span Tags 中的 http.url。
- Tag：由键值对组成的 Span 标签信息，可用于高级搜索标签查询条件。点击标签旁的按钮可将当前标签条件添加至查询条件，实现更精准的查询结果。
- JSON：Span 的原始 JSON 结构，便于进一步查看其内部信息。