hyb-oa/docs/ops/slo.md

SLI / SLO 与错误预算（P13）

更新时间：2026-02-12

1. 范围与目标

本版聚焦 P11/P13 治理链路（Feature Flags、ERP 同步、验真开关）和核心可观测接口，建立可执行的 SLI/SLO 与错误预算基线。

• 环境范围：生产环境（NODE_ENV=production）
• 统计窗口：滚动 30 天
• 目标用途：发布评审、变更放行、故障复盘

2. SLI 定义

SLI-1：API 可用性（Availability）

• 指标定义：
  • 分子：http_server_requests_total{status!~"5.."}
  • 分母：http_server_requests_total
• 统计口径：按所有 /api/* 请求聚合
• 采样周期：5 分钟

SLI-2：核心接口延迟（Latency P99）

• 指标定义：histogram_quantile(0.99, rate(http_server_request_duration_seconds_bucket[5m]))
• 核心接口：
  • /api/dashboard/expense-overview
  • /api/dashboard/trends
  • /api/dashboard/top-categories
  • /api/dashboard/approval-efficiency

SLI-3：治理开关变更成功率（Feature Flag Update Success）

• 指标定义：
  • 分子：/api/system/feature-flags/:key 返回 2xx 的次数
  • 分母：/api/system/feature-flags/:key 总调用次数
• 目标：验证治理入口稳定性，避免灰度期管理面不稳定

3. SLO 目标

SLO-A（可用性）

• 目标：30 天可用性 >= 99.90%
• 对应最大不可用预算：0.10%
• 换算：
  • 每 30 天预算约 43 分钟
  • 每 7 天预算约 10 分钟

SLO-B（延迟）

• 目标：核心 Dashboard 接口 P99 < 500ms
• 兜底上限：P99 不得持续超过 1500ms 超过 15 分钟

SLO-C（治理变更稳定性）

• 目标：Feature Flag 更新成功率 >= 99.5%
• 说明：若低于目标，暂停高风险灰度变更（ERP/验真）

4. 错误预算策略

预算分级

• 正常区：剩余预算 > 50%
  • 允许常规迭代与灰度
• 预警区：剩余预算 20% ~ 50%
  • 限制非必要发布频率，增加回归样本
• 保护区：剩余预算 < 20%
  • 冻结非紧急变更，仅允许故障修复

预算消耗触发动作

• 可用性预算触发：
  1. 立即复核最近 24h 发布与配置变更
  2. 执行 erp_sync 与 invoice_verification 的 force_off 预案
• 延迟预算触发：
  1. 优先检查 Dashboard 聚合查询与数据库负载
  2. 降级非关键统计刷新频率

5. 监控与告警接入

• Prometheus 告警规则：deploy/prometheus/alerts-slo.yml
• 非功能脚本：
  • server/scripts/benchmark-dashboard.sh
  • server/scripts/security-baseline.sh
• 发布前最小检查：
  • ./scripts/check-minimal.sh
  • cd server && ./scripts/regression-feature-flags.sh

6. 回滚与变更约束

• 一级回滚（业务可用优先）：
  • 将 erp_sync、invoice_verification 置 force_off
• 二级回滚（系统保护）：
  • env 硬闸：ERP_SYNC_ENABLED=false、INVOICE_VERIFICATION_ENABLED=false
• 说明：保留审计与历史开关记录，不做 destructive 数据回滚

7. 后续演进（P13-5+）

• 将 regression-all.sh 结构化结果纳入 SLO 评审输入
• 形成 Change Failure Rate 周报/月报（DORA 指标）
• 将 SLO 预算状态纳入发布门禁