3. 可观测性三大支柱：Trace、Metric、Log在异步任务场景下的作用与区别

在异步任务编排系统中，任务的生命周期跨越多个线程、进程甚至服务边界，传统的单进程调试手段完全失效。可观测性（Observability） 成为理解系统内部状态的唯一途径。OpenTelemetry 将可观测性数据归纳为三大支柱：Trace（链路追踪）、Metric（指标） 和 Log（日志）。三者各有侧重，在异步场景下扮演着不可替代的角色。

3.1 三大支柱的核心定义与异步场景挑战

3.2 Trace：异步任务的“骨架”

Trace 是异步任务可观测性的核心骨架。它通过 Span 记录每个任务步骤的开始、结束、状态和元数据，并通过 SpanContext 在异步边界传递父子关系。

3.2.1 异步任务中的 Span 生命周期

与同步请求不同，异步任务的 Span 可能经历以下特殊状态：

• 挂起（Suspend）：任务等待 I/O 或外部回调时，Span 暂停计时。
• 恢复（Resume）：任务重新获得 CPU 执行权，Span 继续计时。
• 扇出（Fan-out）：一个父 Span 产生多个并行子 Span。
• 扇入（Fan-in）：多个子 Span 完成后汇聚到一个父 Span。

3.3 Metric：异步系统的“仪表盘”

Metric 提供聚合后的系统健康视图。在异步任务场景中，以下指标至关重要：

• 队列深度（Queue Depth）：当前待处理任务数量，反映系统积压程度。
• 任务延迟（Task Latency）：从任务提交到完成的总耗时，通常以 P50/P90/P99 分位值呈现。
• 任务吞吐量（Throughput）：单位时间内完成的任务数。
• 任务失败率（Failure Rate）：执行失败的任务占比。
• 工作线程利用率（Worker Utilization）：线程池或协程池的繁忙程度。

3.4 Log：异步任务的“细节放大器”

Log 提供最细粒度的上下文信息。在异步场景中，日志必须携带 Trace ID 和 Span ID，才能与 Trace 关联。典型的异步任务日志结构如下：

{
  "timestamp": "2025-03-21T10:30:45.123Z",
  "level": "ERROR",
  "trace_id": "a1b2c3d4e5f6a7b8c9d0e1f2",
  "span_id": "span-001",
  "service": "task-executor",
  "message": "任务执行超时，触发重试策略",
  "attributes": {
    "task_id": "task-98765",
    "queue_name": "high-priority",
    "retry_count": 2,
    "max_retries": 3
  }
}

3.5 三大支柱在异步任务中的协同关系

单独使用任何一个支柱都无法完整理解异步系统。下图展示了三者如何协同工作：

3.6 三大支柱的对比总结