3. 分布式追踪核心概念：Trace、Span、SpanContext、Baggage 与 OpenTelemetry 标准

在分布式系统中，一个用户请求往往需要跨越多个微服务、数据库、消息队列与缓存组件。要定位慢查询的根因，必须建立一套贯穿全链路的追踪模型。本章将深入剖析分布式追踪的五大核心概念，并介绍业界标准——OpenTelemetry，为后续的 Trace 采集与性能分析打下坚实基础。

3.1 核心概念全景

分布式追踪的核心思想是：将一次完整的请求处理过程，抽象为一棵由 Span 组成的树，树的根节点代表入口请求，子节点代表各依赖服务的处理单元。下表列出了五个核心概念及其职责：

3.2 Trace 与 Span：请求的完整生命周期

Trace 由全局唯一的 TraceID 标识，它贯穿整个请求链路。一个 Trace 包含一个或多个 Span，每个 Span 代表一个具有开始时间、结束时间、操作名称与状态的工作单元。

Span 之间通过 父子关系 构成层级结构：

• 根 Span（Root Span）：Trace 中的第一个 Span，没有父 Span，通常对应入口网关或 API 层。
• 子 Span（Child Span）：由父 Span 创建，代表一次下游调用或内部子任务。
• 跟随 Span（Follows From）：异步场景下，子 Span 与父 Span 没有严格的嵌套关系，但逻辑上属于同一 Trace。

每个 Span 包含以下关键属性：

• SpanID：当前 Span 的唯一标识。
• ParentSpanID：父 Span 的 ID，用于构建 Trace 树。
• OperationName：操作名称，如 HTTP GET /api/users 或 SELECT * FROM orders。
• StartTime / EndTime：精确到微秒的时间戳，用于计算延迟。
• Status：操作结果状态（OK / Error）。
• Attributes：键值对，记录请求 URL、数据库语句、错误堆栈等上下文信息。
• Events：时间戳事件，用于记录关键里程碑（如缓存命中、重试发生）。

3.3 SpanContext：跨进程传播的纽带

SpanContext 是分布式追踪中跨进程传递的核心数据结构。当服务 A 调用服务 B 时，必须将当前 Trace 的上下文信息通过 RPC 头部或消息队列属性传递给下游，否则两个服务之间的 Span 将无法关联到同一个 Trace。

SpanContext 主要包含以下字段：

• TraceID：全局唯一，长度 16 字节（128 位），通常以 32 位十六进制字符串表示。
• SpanID：当前 Span 的 ID，长度 8 字节（64 位）。
• TraceFlags：追踪标志位，如是否采样（Sampled Flag）。
• TraceState：供应商特定的追踪元数据，用于传递额外的传播信息。

3.4 Baggage：轻量级上下文传递

Baggage 是 SpanContext 中一个可选但强大的扩展。它允许用户以键值对的形式携带业务上下文数据，随 Trace 自动传播到所有下游服务。与 Span Attributes 不同，Baggage 是跨服务传递的，而 Attributes 仅存在于当前 Span 所在进程。

典型使用场景：

• 传递用户 ID、会话 ID，用于日志关联。
• 传递请求来源（如 source=web 或 source=app），用于流量分析。
• 传递 A/B 测试标签，用于下游服务的实验分组。

3.5 OpenTelemetry 标准：统一的可观测性生态

OpenTelemetry（简称 OTel）是 CNCF 旗下的可观测性标准，它统一了分布式追踪、指标与日志的采集 API 与 SDK。对于分布式追踪，OTel 提供了以下核心能力：

在 Go 中，使用 OpenTelemetry 创建 Span 的典型代码片段如下：

import (
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/attribute"
)

// 获取全局 Tracer
tracer := otel.Tracer("order-service")

// 创建 Span
ctx, span := tracer.Start(ctx, "processOrder")
defer span.End()

// 添加属性
span.SetAttributes(
    attribute.String("order.id", orderID),
    attribute.Int("item.count", len(items)),
)

// 记录事件
span.AddEvent("cache.miss", trace.WithAttributes(
    attribute.String("cache.key", cacheKey),
))

3.6 慢查询场景中的概念映射

将上述概念映射到实际的慢查询排查场景中，可以更直观地理解其价值：

1. Trace：一次用户请求，例如“查询订单详情”。
2. Span：请求中的每一步操作，包括“HTTP 路由”、“认证鉴权”、“缓存查询”、“数据库查询”。
3. SpanContext：当请求从 Web 服务传递到数据库中间件时，通过 SpanContext 携带 TraceID，确保数据库查询的 Span 属于同一个 Trace。
4. Baggage：携带 user.id=12345，方便在数据库慢查询日志中关联具体用户。
5. OpenTelemetry：使用 OTel SDK 自动为 database/sql 的查询创建 Span，并导出到 Jaeger 进行可视化分析。