2. 核心概念：Span、Trace、Context Propagation 与分布式上下文
在分布式链路追踪中，Span、Trace、Context Propagation 与 分布式上下文 是构成整个观测体系的四个基石。理解它们之间的关系，是进行微服务并发瓶颈分析与慢查询关联分析的前提。
2.1 Span：最小工作单元
Span 是链路追踪中最基本的逻辑单元，代表一次具有开始时间和结束时间的操作。例如，一个 HTTP 请求处理、一次数据库查询、一次 RPC 调用，都可以建模为一个 Span。
每个 Span 包含以下核心属性：
| 属性 | 说明 | 示例值 |
|---|---|---|
| SpanId | 全局唯一的标识符，用于区分同一 Trace 内的不同 Span | abc123def456 |
| ParentSpanId | 父 Span 的 ID，用于构建父子层级关系 | parent789xyz |
| TraceId | 所属 Trace 的全局唯一标识 | trace001 |
| OperationName | 操作名称，描述该 Span 代表的行为 | POST /api/order |
| StartTime / EndTime | 操作的开始与结束时间戳 | 1700000000 / 1700000100 |
| Tags | 键值对形式的元数据，用于附加业务或技术信息 | http.status_code=200 |
| Logs | 时间戳 + 事件描述，用于记录异常或关键事件 | error: timeout |
性能调优视角： 慢查询的根因往往隐藏在某个 Span 的 Duration 异常中。通过分析 Span 的 Tags（如
db.statement、peer.service），可以快速定位到具体的数据库语句或下游服务。
2.2 Trace：端到端的请求轨迹
Trace 是由一系列具有因果关系的 Span 组成的有向无环图（DAG）。它完整记录了一个请求从入口到所有下游服务的完整路径。同一个 Trace 内的所有 Span 共享同一个 TraceId。
Trace 的核心价值在于：
- 全局视角：将分散在多个微服务中的日志、指标串联起来。
- 瓶颈定位：通过 Trace 的瀑布图，直观看到哪个 Span 耗时最长。
- 并发分析：识别出并行调用的 Span 组，判断是否存在资源争抢或线程阻塞。
并发瓶颈提示： 当 Trace 中出现多个同级 Span 同时执行且总耗时接近单个 Span 耗时之和时，说明并发度不足或存在锁竞争；若总耗时远小于之和，则说明并行化有效。
2.3 Context Propagation：跨进程的上下文传递
Context Propagation 是链路追踪的核心机制，它确保一个 Trace 的上下文信息（如 TraceId、SpanId）能够在微服务之间、线程之间、异步回调之间正确传递。没有 Propagation，Span 就会变成孤立的日志，无法形成完整的 Trace。
常见的传播方式包括：
- HTTP 头传播：通过
X-B3-TraceId、X-B3-SpanId等标准头传递。 - 消息队列头传播：在 Kafka/RabbitMQ 消息的 Header 中注入上下文。
- 线程池传播：使用
ThreadLocal或AsyncLocal在同一个进程内传递。 - gRPC Metadata：通过 gRPC 的 Metadata 机制传递。
常见陷阱： 异步编程（如 CompletableFuture、Reactor）中，若未显式传递上下文，会导致 Span 丢失父级关系，形成“断链”。性能调优时，断链的 Trace 无法准确反映调用拓扑，必须优先修复。
2.4 分布式上下文：Span 之间的关联纽带
分布式上下文是一个逻辑容器，它承载了当前请求在分布式环境中的所有状态信息。除了 TraceId 和 SpanId，它还可以包含：
- Baggage Items：用户自定义的键值对，随请求跨服务传递（如用户 ID、租户 ID）。
- 采样决策：是否记录当前 Trace 的完整信息。
- 安全凭证：用于服务间认证的 Token。
上下文通过 Inject（注入）和 Extract（提取）两个操作与 Propagation 配合：
- Inject：在发送请求前，将当前上下文写入传输载体（如 HTTP Headers）。
- Extract：在接收请求时，从传输载体中恢复上下文，并创建子 Span。
2.5 四者关系全景图
下面的 SVG 图展示了 Span、Trace、Context Propagation 与分布式上下文在微服务调用中的协作关系：
2.6 并发瓶颈与慢查询的关联分析切入点
在微服务性能调优中，这四个概念直接对应以下分析路径：
| 问题类型 | Span 表现 | Trace 特征 | 上下文传播线索 |
|---|---|---|---|
| 慢查询 | 单个 Span Duration 远高于 P99 | 该 Span 所在路径整体耗时增加 | Tags 中 db.statement 可定位 SQL |
| 并发瓶颈 | 多个同级 Span 串行执行 | 瀑布图显示无重叠 | 检查线程池上下文是否丢失 |
| 资源争抢 | Span 等待时间长，但 CPU 低 | Trace 中出现大量空闲等待段 | Baggage 中携带的租户 ID 可辅助分析 |
| 上下文断链 | Span 无 ParentSpanId | Trace 不完整，出现孤立 Span | Propagation 代码未正确 Inject/Extract |
实战建议： 在接入链路追踪系统时，优先确保 Context Propagation 覆盖所有异步边界（线程池、消息队列、定时任务）。这是后续所有慢查询和并发分析的数据基础。