模块资料|分布式追踪与 Tempo/Jaeger

原图深度模块的结构化资料摘录,保留目标、知识、命令线索、风险、排障、练习与验收。它不是一张原子知识卡,也不是可直接执行的操作手册。

所属方向:可观测性

目标

  • 定位跨服务延迟、错误和依赖传播。

知识拆解

  • trace/span/context propagation
  • semantic conventions
  • head/tail sampling
  • span links/baggage
  • service graph
  • exemplar

命令 / 配置 / 关键对象

以下是原图中的命令名、缩写或配置对象,并非经校验的完整命令行;其中可能含写操作。执行前必须补齐版本、权限、目标和风险。

  • OTel SDK/agent
  • TraceQL
  • Jaeger query
  • span metrics
  • trace-to-logs

高频故障与风险

  • 上下文断裂
  • 根 span 缺失
  • 过度采样
  • PII 进入 attributes
  • 时钟偏差

排障路径

  • 从入口 trace id
  • 检查 propagation header
  • 分析 critical path
  • 关联 deploy/events

实战练习

  • 多服务 trace
  • tail sampling 保留错误/慢请求

验收标准

  • 关键链路覆盖
  • 采样可解释
  • 延迟归因到具体 span

对应优秀开源项目

继续拆卡的规则

本页是资料入口。只在形成一个能独立解释、带依据与边界的认识后,提炼为 Concept;故障观察进入 Troubleshooting,满足诊断条件的处置进入 Runbook,真实事件进入 Incident。

来源

查看完整原图节点与备注