Skip to content

分布式追踪

一句话解释

分布式追踪跨服务跟踪请求 — 显示完整路径、每步耗时和瓶颈所在。

用大白话说

分布式追踪跟随单个请求在多个微服务间的流转。它创建一个「追踪」— 一棵「span」树,每个 span 代表一个服务对该请求的处理。为什么需要分布式追踪:在微服务架构中,单个用户请求可能经过 5-10 个服务:用户请求 → API 网关 → 认证服务 → 订单服务 → 库存服务 → 支付服务 → 响应如果响应慢,哪个服务是瓶颈?没有追踪只能猜。有了追踪,可以精确看到每个服务耗时多少。追踪包含:1. 追踪 ID — 整个请求旅程的唯一标识

  1. Span — 每个服务一个,含开始时间、持续时间和父 span
  2. Span 上下文 — 属性如用户 ID、端点、错误状态
  3. 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)是瓶颈,不是认证或网络。

工作原理

  1. 入口服务创建带追踪 ID 的根 span。2. 追踪 ID(和当前 span ID)通过请求头传播到下游服务。3. 每个下游服务创建链接到父 span 的子 span。4. 所有 span 发送到追踪后端(Jaeger/Zipkin)。5. 后端重建追踪树并显示为时间线。

常见混淆

  • 容易混淆的对象: 日志

    关键区别: 日志记录单个服务中的离散事件 — 「请求失败返回 500」。分布式追踪跨所有服务跟踪请求,显示完整路径和耗时。日志是单服务的;追踪是跨服务的。日志告诉你一个服务中发生了什么;追踪显示整个旅程。两者都用 — 追踪用于跨服务调试,日志用于详细的单服务上下文。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表