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