1. 分布式追踪基础

1.1 分布式追踪的起源

在单体应用时代，一次请求的完整调用链路局限在单个进程内，开发者可以通过日志、堆栈和性能剖析工具直接定位瓶颈。随着微服务架构、容器化与云原生技术的普及，一个用户请求往往需要跨越数十甚至上百个服务节点，传统的单机调试手段彻底失效。

分布式追踪（Distributed Tracing）正是在这一背景下诞生的关键技术。其核心思想是：为每一笔请求赋予一个全局唯一的标识符（Trace ID），并记录该请求在每个服务节点上的执行片段（Span），最终将这些片段串联成一条完整的调用链路，从而实现对跨服务请求的可观测性。

1.2 核心概念：Trace / Span / Context

分布式追踪的三大核心抽象是 Trace、Span 和 Context。理解这三者的关系是掌握分布式追踪的起点。

下图展示了 Trace、Span 与 Context 之间的层级与传播关系：

1.3 OpenTracing 标准

在分布式追踪早期，不同实现（Zipkin、Jaeger、Appdash 等）的 API 互不兼容，导致开发者难以切换或同时使用多种追踪系统。为了解决这一碎片化问题，OpenTracing 应运而生。它是一个厂商中立的、跨语言的分布式追踪标准 API，旨在为应用程序和追踪系统之间提供一层抽象。

OpenTracing 标准的核心组件包括：

• Tracer：追踪器的入口，负责创建 Span 和注入/提取 Context。
• Span：追踪的基本单元，包含操作名称、时间戳、标签和日志。
• SpanContext：携带跨进程传播的追踪数据（Trace ID、Span ID、Baggage）。
• Propagation：定义了 Context 在进程间传递的格式（TextMap、HTTPHeaders、Binary）。

下表对比了 OpenTracing 与早期非标准化实现的关键差异：

1.4 Go 生态中的分布式追踪

Go 语言凭借其高并发、低延迟和优秀的标准库，成为构建微服务和分布式系统的首选语言之一。Go 生态中的分布式追踪工具链非常成熟，主要围绕 OpenTracing 和 OpenTelemetry 标准展开。

以下是 Go 生态中常用的分布式追踪库与组件：

下面以 opentracing-go 为例，展示在 Go 中创建 Span 和传播 Context 的典型代码模式：

import (
    "github.com/opentracing/opentracing-go"
    "github.com/opentracing/opentracing-go/ext"
    "net/http"
)

// 服务端处理函数
func handleRequest(w http.ResponseWriter, r *http.Request) {
    // 从 HTTP 请求头中提取 SpanContext
    wireCtx, _ := opentracing.GlobalTracer().Extract(
        opentracing.HTTPHeaders,
        opentracing.HTTPHeadersCarrier(r.Header),
    )

    // 创建服务端 Span，并指定父级 Context
    serverSpan := opentracing.StartSpan(
        "handleRequest",
        ext.RPCServerOption(wireCtx),
    )
    defer serverSpan.Finish()

    // 在 Span 中添加标签
    ext.HTTPMethod.Set(serverSpan, r.Method)
    ext.HTTPUrl.Set(serverSpan, r.URL.String())

    // 模拟业务处理
    processBusinessLogic(serverSpan)
}

// 客户端发起 RPC 调用
func callDownstream(parentSpan opentracing.Span) {
    // 创建子 Span
    childSpan := opentracing.StartSpan(
        "callDownstream",
        opentracing.ChildOf(parentSpan.Context()),
    )
    defer childSpan.Finish()

    // 构造 HTTP 请求
    req, _ := http.NewRequest("GET", "http://downstream-service/api", nil)

    // 将 SpanContext 注入到 HTTP 请求头中
    opentracing.GlobalTracer().Inject(
        childSpan.Context(),
        opentracing.HTTPHeaders,
        opentracing.HTTPHeadersCarrier(req.Header),
    )

    // 发送请求
    http.DefaultClient.Do(req)
}

下图展示了 Go 生态中分布式追踪的典型架构组件及其交互关系：