4. 链路追踪核心概念：Span、Trace、Context Propagation、Baggage

分布式链路追踪是构建可观测性体系的基石。在微服务与多租户架构中，每一次用户请求都可能跨越数十个服务实例与中间件。要准确还原请求的完整路径、定位性能瓶颈并实现租户隔离，必须深入理解链路追踪的四个核心概念：Span、Trace、Context Propagation 与 Baggage。

4.1 Span：追踪的最小工作单元

Span（跨度）是链路追踪中最基本的逻辑单元，代表一个分布式系统中发生的单一操作或工作单元。每个 Span 记录了一个操作的开始时间、结束时间、状态以及一组关联的元数据。

Span 的核心属性

4.2 Trace：端到端的请求全景图

Trace（追踪链路）由一组具有相同 TraceId 的 Span 组成，完整描述了一个请求从入口到出口经过所有服务节点的执行路径。Trace 本质上是一个有向无环图（DAG），Span 之间通过父子关系或因果关系连接。

一个典型的 Trace 结构如下：

• Root Span：Trace 的起始 Span，通常由网关或入口服务创建，没有父 Span。
• Child Span：由 Root Span 或其他 Child Span 派生，代表更细粒度的子操作。
• Follows-From 关系：某些 Span 之间并非严格的父子调用，而是异步触发或消息队列传递，此时使用 Follows-From 关系。

4.3 Context Propagation：跨服务传递追踪上下文

Context Propagation（上下文传播）是分布式链路追踪的核心机制，负责将追踪上下文（TraceId、SpanId、Baggage 等）从一个服务透明地传递到下一个服务。没有正确的上下文传播，Trace 将在服务边界处断裂，无法形成完整的调用链。

传播方式与协议

OpenTelemetry 中的传播器（Propagator）

OpenTelemetry SDK 内置了多种 Propagator，开发者只需在初始化时配置即可自动完成上下文注入与提取：

// Go 示例：配置 W3C Trace Context 与 Baggage 传播器
import (
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/propagation"
)

func initTracer() {
    // 创建组合传播器：同时支持 Trace Context 和 Baggage
    propagator := propagation.NewCompositeTextMapPropagator(
        propagation.TraceContext{},
        propagation.Baggage{},
    )
    otel.SetTextMapPropagator(propagator)
}

4.4 Baggage：跨服务传递业务上下文

Baggage（行李）是 OpenTelemetry 中一种特殊的上下文传播机制，允许用户将一组键值对数据随 Trace 一起跨服务传递。与 Span Attributes 不同，Baggage 中的数据会自动传播到所有下游 Span，无需在每个服务中手动提取和注入。

Baggage 的典型用途

• 租户标识传递：将 tenant.id 放入 Baggage，确保所有下游服务都能感知当前请求所属租户。
• 用户身份与角色：传递 user.id、user.role 等身份信息，用于细粒度权限校验。
• 请求优先级与标签：传递 request.priority、experiment.group 等业务标签，影响下游服务的处理策略。
• 端到端采样决策：传递 sampling.decision，让所有服务遵循统一的采样策略。

4.5 核心概念关系总结