1. 课程导论：质量门禁与可观测性背景、SLO与SLI基础概念、Jaeger在链路诊断中的角色
1.1 质量门禁：从“被动救火”到“主动防御”
在微服务架构中，服务间的依赖关系错综复杂，一个上游接口的轻微抖动，经过级联放大后，可能演变为整个系统的雪崩。传统的“事后告警 + 人工排查”模式，在日均亿级调用的场景下，已无法满足业务连续性的要求。质量门禁（Quality Gate）正是在这一背景下诞生的核心实践——它将质量红线前置到发布、变更、流量调度等关键节点，实现自动化的准入/准出控制。
核心转变： 质量门禁将可观测性数据（延迟、错误率、饱和度）转化为决策信号，在故障影响用户之前，阻断劣化代码或配置的扩散。
质量门禁的典型执行流程包含以下四个步骤：
- 指标采集： 从APM、日志、基础设施监控中实时获取SLI数据。
- 策略评估： 将SLI与预设的SLO阈值进行比对，计算错误预算消耗速率。
- 门禁判定： 若消耗速率超过门限（如：过去5分钟错误预算消耗超过10%），则判定为“未通过”。
- 自动化动作： 阻断发布流水线、触发流量降级、或自动回滚版本。
1.2 SLO与SLI：可观测性的量化基石
要构建有效的质量门禁，必须先建立统一的量化语言。SLI（Service Level Indicator，服务等级指标）是直接反映服务健康状况的原始度量；SLO（Service Level Objective，服务等级目标）则是针对SLI设定的目标阈值，是团队与业务方之间的“质量契约”。
| 概念 | 定义 | 示例 | 在门禁中的角色 |
|---|---|---|---|
| SLI | 服务性能的具体度量指标 | 请求延迟P99、错误率、吞吐量 | 门禁的输入信号 |
| SLO | SLI的目标值或范围 | P99延迟 ≤ 200ms，错误率 ≤ 0.1% | 门禁的判定基准 |
| 错误预算 | 1 - SLO，允许服务不可用的最大时间/次数 | 99.9% SLO → 每月约43分钟错误预算 | 门禁的决策依据（预算消耗速率） |
实践建议： 选择SLI时，应遵循“USE”原则（Utilization、Saturation、Errors）和“RED”原则（Rate、Errors、Duration）。对于核心交易链路，优先关注“错误率”和“延迟P99”这两个黄金指标。
1.3 Jaeger在链路诊断中的核心角色
当质量门禁触发告警，或SLO出现燃烧速率异常时，我们需要快速定位“哪一段调用链”出了问题。传统的指标监控只能告诉你“系统慢了”，而分布式链路追踪（Distributed Tracing）能告诉你“慢在哪里、为什么慢”。Jaeger作为CNCF毕业的链路追踪项目，在质量门禁体系中扮演着“诊断显微镜”的角色。
Jaeger在SLO台账验证中的三大核心能力：
- 根因定位： 通过Trace ID串联跨服务调用，快速识别是数据库慢查询、下游超时、还是网络抖动导致的SLO违例。
- SLO台账验证： 将Jaeger的Span延迟数据与SLO阈值进行逐跳对比，生成“SLO台账”——记录每一次请求是否满足SLO，以及未满足的具体环节。
- 门禁反馈闭环： 当门禁阻断变更后，Jaeger提供的持续追踪数据可用于验证回滚或降级策略是否生效，形成“观测 → 决策 → 验证”的闭环。
1.4 从指标到Trace：SLO台账的逐跳验证
传统的SLO监控通常基于聚合指标（如：平均延迟），但聚合指标会掩盖“长尾请求”中的异常Span。Jaeger提供的逐跳验证能力，允许我们将一次请求的完整调用链展开，对比每个Span的实际耗时与SLO中定义的“预期耗时上限”。
以下是一个典型的SLO台账验证流程：
- Step 1： 质量门禁检测到某接口的P99延迟超过SLO（200ms），触发诊断。
- Step 2： 系统自动拉取该时间窗口内所有慢Trace，提取Trace ID列表。
- Step 3： Jaeger API返回每个Trace的完整Span列表，包括服务名、操作名、开始时间、持续时间。
- Step 4： 台账引擎逐Span比对：若Span耗时 > 该环节SLO阈值，则标记为“违例”，并记录违例深度。
- Step 5： 输出SLO台账报告，明确“哪个服务、哪个操作、哪个实例”导致了SLO违例。
常见误区： 不要仅依赖Jaeger的“服务依赖图”做根因分析。依赖图只能展示拓扑关系，无法精确到“每一次调用”的SLO满足情况。必须结合Trace级别的Span耗时台账，才能做出准确的门禁判定。
1.5 本章小结：三位一体的质量保障体系
本章作为课程导论，建立了三个核心认知：
- 质量门禁是“执行者”，负责在变更和运行时自动阻断劣化。
- SLO/SLI是“度量标准”，为门禁提供可量化的判定依据。
- Jaeger是“诊断工具”，提供Trace级别的SLO台账验证能力，让门禁决策有据可查。