2. OpenTelemetry 基础回顾：Trace、Span、Context Propagation 核心概念

在深入服务目录的部署频率分析之前，必须先牢固掌握 OpenTelemetry 的三大基石：Trace（链路）、Span（跨度）和 Context Propagation（上下文传播）。这三个概念构成了所有可观测性数据的骨架，也是后续分析服务部署频率对调用链影响的基础。

2.1 Trace：端到端的请求旅程

一个 Trace 代表一个请求在分布式系统中从入口到出口的完整生命周期。它由多个 Span 组成，这些 Span 通过父子关系连接，形成一棵有向无环图（DAG）。

• 全局唯一标识：每个 Trace 都有一个全局唯一的 TraceId（通常为 16 字节或 128 位）。
• 跨服务边界：Trace 可以跨越多个微服务、数据库、消息队列和外部 API。
• 时间范围：Trace 的起始时间是第一个 Span 的开始时间，结束时间是最后一个 Span 的结束时间。

2.2 Span：可观测性的基本工作单元

Span 是 Trace 中的最小逻辑单元，代表一个具有开始时间和结束时间的操作。每个 Span 封装了以下核心属性：

2.3 Context Propagation：连接一切的隐形纽带

Context Propagation 是 OpenTelemetry 最核心的机制，它确保 Trace 信息能够在服务之间、线程之间和异步调用之间无缝传递。没有它，分布式链路将断裂成孤立的 Span。

传播过程分为两个阶段：

1. 注入（Inject）：在发送请求（HTTP/gRPC/消息队列）之前，将当前 Context（包含 TraceId、SpanId 等）序列化并写入请求头。
2. 提取（Extract）：在接收请求时，从请求头中反序列化 Context，并创建新的子 Span 关联到父 Trace。

OpenTelemetry 支持多种传播协议，最常用的是 W3C Trace Context（标准 HTTP 头 traceparent 和 tracestate）。

2.4 核心概念关系图

下图展示了 Trace、Span 和 Context Propagation 在分布式请求中的协作关系：

2.5 传播协议对比

OpenTelemetry 支持多种上下文传播协议，在实际部署中需要根据技术栈选择。以下是主流协议的对比：

2.6 代码示例：手动创建 Span 并传播 Context

以下 Go 语言示例展示了如何在服务 A 中手动创建 Span，并通过 HTTP 头将 Context 传播到服务 B：

import (
    "context"
    "net/http"
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/propagation"
)

// 服务 A：处理请求并调用服务 B
func handleRequestA(w http.ResponseWriter, r *http.Request) {
    tracer := otel.Tracer("service-a")
    ctx, span := tracer.Start(r.Context(), "handle-request-a")
    defer span.End()

    // 注入版本属性
    span.SetAttributes(attribute.String("deployment.version", "1.0.0"))

    // 创建调用服务 B 的请求
    req, _ := http.NewRequestWithContext(ctx, "GET", "http://service-b/api", nil)
    
    // 注入当前 Context 到 HTTP 头
    otel.GetTextMapPropagator().Inject(ctx, propagation.HeaderCarrier(req.Header))
    
    // 发送请求
    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()
}

// 服务 B：接收请求并提取 Context
func handleRequestB(w http.ResponseWriter, r *http.Request) {
    // 从 HTTP 头提取 Context
    ctx := otel.GetTextMapPropagator().Extract(r.Context(), propagation.HeaderCarrier(r.Header))
    
    tracer := otel.Tracer("service-b")
    _, span := tracer.Start(ctx, "handle-request-b")
    defer span.End()

    // 此时 span 自动关联到服务 A 的 Trace
    span.SetAttributes(attribute.String("deployment.version", "2.1.0"))
}

2.7 部署频率分析中的关键启示

• 版本属性注入：在每个 Span 的 Attributes 中注入 deployment.version，是后续按版本聚合分析的基础。
• Context 断裂检测：如果部署后出现大量“孤儿 Span”（无父 Span），说明 Context Propagation 在新版本中配置错误。
• Trace 拓扑变化：新版本可能引入新的服务依赖或移除旧依赖，通过 Trace 的 Span 结构变化可以自动发现部署影响。