Query Trace
目录
Feature Overview
分布式追踪查询功能通过收集服务间调用的元数据信息，为微服务架构提供全链路追踪能力，帮助用户快速定位跨服务调用问题。该功能主要解决以下问题：
- 请求链路追踪：还原复杂分布式系统中的完整请求路径。
- 性能瓶颈分析：识别链路中耗时异常的调用节点。
- 故障根因定位：通过错误标记快速定位问题发生点。
适用场景包括：
- 生产环境故障排查时快速定位异常服务。
- 性能调优时识别高延迟调用链路。
- 新版本发布后验证服务间调用关系。
核心价值：
- 提升分布式系统的可观测性。
- 降低平均恢复时间（MTTR）。
- 优化服务间调用性能。
Main Features
- 多维度查询：支持 TraceID、服务名、标签等 9 种查询条件组合。
- 可视化分析：通过时间序列瀑布图直观展示调用层级和时间分布。
- 精准定位：支持错误 Span 过滤及标签二次搜索。
Feature Advantages
- 快速定位问题：通过多维度查询条件缩小排查范围，加快问题定位速度。
- 可视化呈现：采用时间序列瀑布图直观展示调用关系，降低复杂度，提高故障分析效率。
- 灵活多样：支持简单查询和复杂组合，适应多种运维和开发场景。
Trace Query
Step 1: Combine Query Conditions
提示：查询条件可以组合使用。您可以通过添加多个查询条件来细化查询。
| 查询条件 | 描述 |
|---|---|
| TraceID | 完整链路的唯一标识，可用于查询指定的 Trace。 |
| Service | 发起/接收调用请求的服务或入口网关（必填）。格式为 <service/gateway name>.<namespace name>，例如 bookinfo-gw.bookinfo-ns。 |
| Client | 发起调用请求的客户端服务或入口网关（必填）。格式为 <service/gateway name>.<namespace name>。 |
| Server | 响应调用请求的服务端服务或入口网关（必填）。格式为 <service/gateway name>.<namespace name>。 |
| API | 在 Services > API 中为服务添加的 API。 |
| Tags | 可通过输入标签（Tag）过滤查询结果。支持的标签包括 Span 详情中存在的标签。 |
| Span duration > | 查询持续时间大于等于 输入值（毫秒）的 Span。 |
| Only error traces | 错误 Span 指 Tag 中 error 值为 true 的 Span。 |
| Span kind | Root Span：搜索由配置的 service 发起的根 Span。当配置的服务是整个调用请求的发起方时使用此搜索模式。 Service Entry Span：搜索配置的 service 作为服务端被调用时生成的第一个 Span。 |
| Max query count | 最大可查询的 Span 数量，默认值为 200。提示：出于性能考虑，平台一次最多展示 1000 个 Span。如果满足查询条件的 Span 数量超过 最大查询数，可通过细化查询条件或缩小时间范围分阶段查询。 |
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 结构，便于进一步查看其内部信息。