模块资料|分布式追踪与 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。