链路追踪概述

先从一个真实场景说起。好几年前，我刚接手一个电商平台的后端改造，系统已经拆成了十几个微服务。每次排查一个下单超时的问题，都得在几十台机器上翻日志，用时间戳手工拼调用链——那种感觉，就像在乱麻里找线头。后来引入了链路追踪，整个局面才彻底改观。

分布式系统为什么需要链路追踪

单体应用时代，一个请求从入口到数据库，全在同一个进程里。出问题？打一个日志，看堆栈就够了。但微服务架构下，一个用户请求可能要经过网关、认证、商品、订单、支付、库存等七八个服务，还可能跨消息队列、跨线程池。你想想看，如果支付失败，是库存扣减超时？还是订单状态写错？还是网关丢了响应头？没有链路追踪，这就是个黑洞。

我归纳了四个核心痛点，缺了链路追踪根本扛不住：

痛点	具体表现
故障定位难	同类错误码散落在不同服务日志，无法串联根因
性能瓶颈不可见	某个服务慢 100ms，但你不知道是 DB 慢还是下游依赖慢
依赖关系模糊	服务拓扑随时间演化，没人说得清真实调用关系
容量评估靠猜	不知道每个接口的实际吞吐和延迟分布

Trace 与 Span 的概念

讲到底层模型，其实就两个核心概念：Trace 和 Span。理解它们，你就掌握了链路追踪的钥匙。

Span——一次具体的操作单元

每个 Span 代表一个服务或组件内的一次操作。比如调用 Redis、执行一个 SQL 查询、调用下一个服务的 HTTP 接口。Span 本身携带这些元数据：

• Span ID：全局唯一标识，通常用 64 位随机数
• Parent Span ID：父 Span 的 ID，形成父子关系
• Operation Name：操作语义名称，比如 "GET /api/orders"
• Start Time / Duration：开始时间和耗时
• Tags & Logs：附加键值对和结构化日志

Trace——把 Span 串成链条

一个 Trace 就是一个请求的完整生命周期，由一组具有相同 Trace ID 的 Span 构成。Trace ID 在入口处生成，然后一路透传到所有下游服务。把这些 Span 按父子关系组织起来，就形成了一棵树。

看个简单例子：用户请求「查询订单详情」，实际调用链路是：

• Span A (API Gateway, 40ms)
  • Span B (Order Service, 30ms)
    • Span C (MySQL Query, 15ms)
    • Span D (Redis Cache, 5ms)

Trace ID 在整个链条中保持不变；Span ID 和 Parent Span ID 则定义了层级结构。嗯，这里要注意：Span 不一定是同步的。异步消息、并发 goroutine 都可以生成兄弟 Span。

OpenTracing 标准简介

市面上链路追踪工具很多——Jaeger、Zipkin、SkyWalking、Datadog……每家都有自己的 SDK。如果团队换来换去，代码就要重写一遍，这谁受得了？OpenTracing 的标准就是为了解决这个「厂商锁定」问题。

核心思想

说白了，OpenTracing 定义了一套不绑定具体实现的 API 规范。你的业务代码只依赖 OpenTracing 接口，底层引擎可以随时切换。我参与过的一个项目，从 Zipkin 迁移到 Jaeger，只改了启动配置和 Maven 依赖，核心代码零改动。

三大核心接口

接口	作用
Tracer	创建 Span、注入/提取上下文
Span	表示一次操作，设置 Tag、Log、结束时间
SpanContext	承载 Trace ID、Span ID 和 Baggage 等跨进程传递的数据

一个极简的代码示例（伪代码风格）

// 创建 Tracer（通常全局单例）
tracer = TracerFactory.getTracer("my-service")

// 开始一个 Span
span = tracer.buildSpan("GET /api/users").start()

// 设置 Tag
span.setTag("http.method", "GET")
span.setTag("user.id", 12345)

// 业务逻辑…
doWork()

// 结束 Span
span.finish()

你看到没有？全程没有导入任何 Jaeger 或 Zipkin 的类。这就是 OpenTracing 的魅力——接口与实现分离。

上下文传播

跨进程传递 SpanContext 是链路追踪最难的部分。OpenTracing 定义了两种传播格式：

• TextMap：适用于 HTTP Header、消息队列属性等文本键值对
• Binary：适用于 gRPC、Thrift 等二进制协议

好了，知识体系搭完了。下面这张图能帮你把整体脉络串起来——