3. SLO 与 SLI 的映射：服务等级目标与可测量指标

在质量门禁自动化校验体系中，SLO（Service Level Objective，服务等级目标）是业务承诺的量化表达，而SLI（Service Level Indicator，服务等级指标）是实际可采集的原始测量数据。两者之间的映射关系，决定了门禁校验能否从“模糊期望”转化为“精确判定”。

3.1 服务等级目标（SLO）的定义

SLO 是围绕 SLI 设定的目标阈值或范围，通常以“时间窗口内的达标率”形式呈现。它回答了“系统应该好到什么程度”这一核心问题。

3.2 SLO 拆解为 SLI 的映射方法

将高层级 SLO 拆解为可采集的 SLI，需要遵循“业务→系统→组件→指标”的逐层分解路径。以下为标准化拆解流程：

1. 识别用户旅程：确定 SLO 所覆盖的核心业务流程（如“用户下单”）。
2. 绘制系统依赖图：列出该旅程涉及的所有服务、中间件、基础设施。
3. 定义关键指标类别：从 可用性、延迟、吞吐量、错误率、饱和度 五个黄金信号中选择。
4. 确定测量点：在架构图中标注每个组件的 SLI 采集位置（如 API 网关、数据库连接池）。
5. 设定聚合规则：明确 SLI 的统计口径（如 P50/P95/P99、平均值、滑动窗口大小）。

3.3 SLO ↔ SLI 映射关系表（通用模板）

以下表格展示了常见 SLO 类型与对应 SLI 的映射关系，可直接用于门禁参数注入设计：

3.4 映射过程中的常见陷阱与规避

• 陷阱一：SLI 与 SLO 粒度不匹配
  例如 SLO 要求“全年可用性 99.99%”，但 SLI 只采集了“单次请求成功/失败”，未考虑计划内维护窗口。应明确排除窗口定义。
• 陷阱二：忽略长尾效应
  仅使用平均延迟作为 SLI，会掩盖 P99 甚至 P999 的劣化。门禁校验应优先采用百分位指标。
• 陷阱三：SLI 采集盲区
  只监控了服务端，忽略了客户端真实体验。建议在关键用户端埋点，形成“服务端 SLI + 客户端 SLI”双视角校验。
• 陷阱四：口径定义模糊
  “请求超时”在不同团队可能定义为 10s、30s 或 60s。必须在 SLI 口径文档中明确超时阈值，否则门禁判定结果不可复现。

3.5 映射关系的可视化：SLO → SLI 分解架构

下图展示了一个典型电商系统的 SLO 拆解过程，从业务级 SLO 逐层映射到基础设施 SLI：

3.6 映射校验的自动化注入设计

在质量门禁系统中，SLO ↔ SLI 映射关系需要以参数化配置的形式注入校验引擎。以下是一个典型的 YAML 配置片段：

slo_mappings:
  - slo_id: "order_success_rate_99_95"
    slo_display: "下单成功率 ≥ 99.95%"
    window: "28d"
    target_ratio: 0.9995
    sli_list:
      - sli_id: "api_gateway_request_success_rate"
        source: "nginx_access_log"
        metric: "success_count / total_count"
        aggregation: "rolling_1m"
        threshold: 0.9999
      - sli_id: "order_service_p99_latency"
        source: "apm_span_data"
        metric: "p99(response_time_ms)"
        aggregation: "rolling_5m"
        threshold: 200
      - sli_id: "mysql_connection_pool_availability"
        source: "prometheus_mysql_exporter"
        metric: "max_connections - active_connections / max_connections"
        aggregation: "avg_over_1m"
        threshold: 0.95
    composite_rule: "all(sli_ok)  # 所有 SLI 达标则 SLO 通过"

3.7 映射校验的典型流程

下图展示了从 SLI 采集到 SLO 判定通过的完整自动化流程：

3.8 映射文档化与版本管理

每个 SLO ↔ SLI 映射关系必须形成可追溯的文档，并纳入版本控制。推荐使用以下结构：

• 映射矩阵表：Excel 或 Markdown 表格，包含 SLO ID、SLI ID、口径描述、负责人、创建日期。
• 口径定义文件：YAML/JSON 格式，与门禁配置同仓库管理，每次修改需 Code Review。
• 变更日志：记录每次口径调整的原因、影响范围、审批人。
• 自动化校验脚本：定期检查映射关系是否与监控系统中的实际指标一致，防止配置漂移。