4、质量门禁规则体系：规则定义、规则分类与生命周期管理

质量门禁规则是驱动分布式追踪 MTTR 复盘口径自动验证的核心引擎。一套严谨、可执行的规则体系，能够将抽象的“质量”目标转化为具体的、可编程的判定逻辑，从而在流水线、监控告警或复盘流程中自动拦截或标记不符合预期的行为。本章将深入剖析规则的定义范式、分类模型以及从创建到废弃的全生命周期管理策略。

4.1 规则定义：结构化与可编程

每一条质量门禁规则都应遵循统一的结构化模板，确保其可读性、可维护性和可自动化执行。规则定义通常包含以下核心字段：

规则的条件表达式通常采用类 PromQL 或自定义 DSL，以支持对分布式追踪中的 Span 属性、服务指标、Trace 拓扑 进行多维度的复合判断。以下是一个典型的规则定义示例：

rule_id: "QGR-0042-SP"
name: "核心交易P99延迟门禁"
category: "blocking"
scope: "service='order-service' && span.kind='server' && http.route='/api/checkout'"
condition: "duration_p99(5m) > 500ms || error_rate(5m) > 0.01"
action: "block_release"
window: "5m"
version: 3

4.2 规则分类：阻塞、告警与观察

根据规则触发后的影响力和紧急程度，质量门禁规则被划分为三个明确的类别。这种分类机制允许团队在“严格管控”与“快速迭代”之间取得平衡。

4.2.1 阻塞规则（Blocking）

阻塞规则是最高优先级的门禁。一旦触发，将直接阻断当前流水线（如 CI/CD 发布、配置变更）的继续执行，直到问题被确认或规则被临时豁免。此类规则通常用于保护核心业务链路，防止严重质量事故流入生产环境。

• 典型场景： 核心交易成功率低于 99.9%、数据库连接池耗尽、关键安全漏洞。
• 触发动作： block_release、rollback、create_incident。
• 豁免机制： 支持指定时间段或特定用户进行临时豁免，并记录审计日志。

4.2.2 告警规则（Alerting）

告警规则用于发现潜在风险或非致命性异常。规则触发后不会阻断流程，但会通过即时通讯、邮件或工单系统通知相关责任人，要求在规定时间内响应。告警规则是 SRE 团队日常运维的主要依据。

• 典型场景： 服务 P99 延迟超过阈值但未达到阻塞标准、错误率小幅上升、依赖服务响应变慢。
• 触发动作： trigger_alert、send_notification、create_jira_ticket。
• 升级策略： 若告警在指定时间内未被确认，可自动升级为阻塞规则或提升告警级别。

4.2.3 观察规则（Observation）

观察规则是最低优先级的门禁，主要用于数据采集、趋势分析和复盘口径验证。规则触发后仅记录事件日志，不产生任何告警或阻断动作。这类规则是构建 MTTR 复盘口径自动验证机制的基础数据源。

• 典型场景： 记录每次发布的追踪数据变化、采集新版本与基线版本的性能差异、标记异常模式用于后续分析。
• 触发动作： log_observation、tag_trace、update_dashboard。
• 价值： 为复盘提供可量化的“预期行为”与“实际行为”对比数据，验证复盘口径的准确性。

4.3 规则生命周期管理

质量门禁规则并非一成不变。随着业务演进、系统架构调整以及复盘经验的积累，规则需要经历从创建到废弃的完整生命周期。有效的生命周期管理能够防止规则腐化，避免“告警疲劳”和“门禁失效”。

规则生命周期通常包含以下六个阶段：

1. 创建（Draft）：基于复盘分析或质量目标，定义规则的结构化内容。此阶段规则处于非激活状态，仅用于评审。
2. 评审（Review）：由 SRE 团队、开发团队和质量工程专家共同评审规则的 scope、condition 和 action 是否合理，避免误判或漏判。
3. 试运行（Staging）：将规则部署到预发环境或小范围生产流量中，以观察模式运行，验证规则的准确性和影响。
4. 激活（Active）：规则正式生效，按照其分类（阻塞/告警/观察）执行对应动作。
5. 审计与优化（Audit）：定期审计规则的触发率、准确率和误报率。根据复盘结果调整阈值、scope 或分类。
6. 废弃（Deprecated）：当规则不再适用（如服务下线、指标变更）或已被更优规则替代时，将其标记为废弃，并从激活状态移除。

4.4 规则版本控制与审计追溯

规则的生命周期管理离不开版本控制。每一次规则的创建、修改、激活或废弃，都应被记录为一条不可篡改的审计日志。这不仅有助于问题回溯，也是 MTTR 复盘口径自动验证机制中“验证口径是否一致”的关键证据链。