分布式追踪
一句话解释
分布式追踪跨服务跟踪请求 — 显示完整路径、每步耗时和瓶颈所在。
用大白话说
分布式追踪跟随单个请求在多个微服务间的流转。它创建一个「追踪」— 一棵「span」树,每个 span 代表一个服务对该请求的处理。为什么需要分布式追踪:在微服务架构中,单个用户请求可能经过 5-10 个服务:用户请求 → API 网关 → 认证服务 → 订单服务 → 库存服务 → 支付服务 → 响应如果响应慢,哪个服务是瓶颈?没有追踪只能猜。有了追踪,可以精确看到每个服务耗时多少。追踪包含:1. 追踪 ID — 整个请求旅程的唯一标识
- Span — 每个服务一个,含开始时间、持续时间和父 span
- Span 上下文 — 属性如用户 ID、端点、错误状态
- Span 事件 — 特定时刻的标注(缓存命中、数据库查询)
追踪是一棵树:根 span 是入口点,子 span 是下游调用。这棵树显示完整请求流和耗时。工具:Jaeger、Zipkin、Datadog、Honeycomb、OpenTelemetry。
示例
javascript
// OpenTelemetry 分布式追踪
import { trace } from '@opentelemetry/api';
// 服务 A:API 网关(根 span)
const tracer = trace.getTracer('api-gateway');
const rootSpan = tracer.startSpan('GET /api/orders');
// 服务 B:认证服务(子 span)
const authSpan = tracer.startSpan('verifyToken');
const user = await verifyToken(token); // 5ms
authSpan.end();
// 服务 C:订单服务(子 span)
const orderSpan = tracer.startSpan('getOrders');
orderSpan.setAttribute('user.id', user.id);
// 服务 D:数据库查询(孙 span)
const dbSpan = tracer.startSpan('SELECT orders');
const orders = await db.query('SELECT * FROM orders WHERE user_id = ?', [user.id]); // 50ms
dbSpan.end();
orderSpan.end(); // 总计:55ms
rootSpan.end(); // 总计:60ms
// 在 Jaeger UI 中看到时间线:// GET /api/orders (60ms)
// ├── verifyToken (5ms)
// └── getOrders (55ms)
// └── SELECT orders (50ms) ← 瓶颈!每个服务创建 span。span 组成树显示请求路径和耗时。追踪揭示数据库查询(50ms)是瓶颈,不是认证或网络。
工作原理
- 入口服务创建带追踪 ID 的根 span。2. 追踪 ID(和当前 span ID)通过请求头传播到下游服务。3. 每个下游服务创建链接到父 span 的子 span。4. 所有 span 发送到追踪后端(Jaeger/Zipkin)。5. 后端重建追踪树并显示为时间线。
常见混淆
容易混淆的对象: 日志
关键区别: 日志记录单个服务中的离散事件 — 「请求失败返回 500」。分布式追踪跨所有服务跟踪请求,显示完整路径和耗时。日志是单服务的;追踪是跨服务的。日志告诉你一个服务中发生了什么;追踪显示整个旅程。两者都用 — 追踪用于跨服务调试,日志用于详细的单服务上下文。
相关术语
相关资源
相关课程
- 可观测性
分布式追踪。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。