1. 课程导论：质量门禁与可观测性的关系，Jaeger在发布流程中的定位
1.1 质量门禁：从“卡点”到“可观测决策”
在传统发布流程中，质量门禁（Quality Gate）通常表现为一组静态检查规则：代码扫描通过、单元测试覆盖率达标、构建产物签名正确。这些门禁在“配置发布环境异常”场景下存在两个致命缺陷：
- 静态阈值无法感知运行时拓扑变化：配置变更可能引发下游服务超时、连接池耗尽或级联错误，而传统门禁仅检查配置格式与语法。
- 缺乏分布式上下文关联：配置发布导致的异常往往表现为“用户侧响应慢”或“订单失败率上升”，但门禁无法将失败率指标与具体的配置变更链路关联。
核心观点：现代质量门禁必须从“静态检查点”进化为“可观测决策引擎”，利用分布式追踪、指标和日志的关联分析，在发布过程中实时判断配置变更是否引入异常。
1.2 可观测性：质量门禁的“感知层”
可观测性（Observability）为质量门禁提供了三个维度的感知能力，三者缺一不可：
| 维度 | 传统门禁能力 | 可观测增强后的门禁能力 |
|---|---|---|
| Traces（追踪） | 无 | 追踪配置变更请求的完整调用链，识别跨服务延迟异常 |
| Metrics（指标） | 仅检查构建成功率 | 实时检测错误率、P99延迟、吞吐量等黄金信号 |
| Logs（日志） | 仅检查编译日志 | 关联配置变更前后的异常日志模式，自动提取错误堆栈 |
当配置发布触发门禁时，可观测性数据能够回答三个关键问题：
- 发生了什么？ —— 错误率是否突增？哪些服务受到影响？
- 为什么发生？ —— 异常是否由本次配置变更直接导致？调用链中哪个环节出现故障？
- 影响范围多大？ —— 是单个用户、单个服务还是全链路雪崩？
1.3 Jaeger在发布流程中的定位
Jaeger 作为 CNCF 毕业的分布式追踪系统，在配置发布质量门禁中承担 “调用链证据提供者” 的角色。其定位可以概括为以下三层：
定位总结：Jaeger 不是门禁决策者，而是门禁决策的“分布式上下文引擎”。它提供配置变更前后的调用链快照，帮助门禁系统判断异常是否由配置引发。
1.4 Jaeger 在门禁中的具体职责
在配置发布场景下，Jaeger 提供以下关键能力来辅助门禁定位异常：
| 职责 | 说明 | 门禁决策价值 |
|---|---|---|
| 调用链对比 | 对比配置发布前后的 Trace 快照，识别新增的延迟、错误 Span | 判断配置变更是否引入新的故障路径 |
| 服务依赖拓扑 | 自动绘制配置变更影响的服务依赖图，标记异常节点 | 确定异常影响范围，避免盲目全量回滚 |
| 错误根因定位 | 通过 Trace ID 关联错误日志，定位到具体的配置参数或服务 | 提供回滚或热修复的精确目标 |
| SLO 偏差检测 | 基于 Trace 的延迟分布，检测配置发布是否导致 SLO 违规 | 触发自动回滚或降级策略 |
1.5 课程核心脉络
本课程将围绕以下主线展开，帮助学员掌握 Jaeger 辅助质量门禁定位配置发布环境异常的完整技能：
- 基础篇：Jaeger 架构与配置发布场景的 Trace 采集策略
- 门禁集成篇：将 Jaeger 查询 API 集成到质量门禁决策引擎
- 异常定位篇：基于 Trace 的配置异常模式识别与根因分析
- 实战篇：从配置发布到异常回滚的完整门禁闭环演练
前置要求：学员需具备基本的分布式系统概念（服务、调用链、延迟），了解 Docker 和 Kubernetes 基础操作。无需预先精通 Jaeger，课程将从零搭建实验环境。