4. 告警路由参数体系：参数分类与作用域

告警路由的灵活性与可维护性，核心在于其参数体系的合理设计。本章深入剖析告警路由参数的三大分类（静态参数、动态参数、上下文参数）与三大作用域（全局、路由规则级、窗口级），帮助你在变更窗口平台工程测试验证中精准控制告警流向。

4.1 参数分类：三种参数类型

根据参数的来源、变更频率与生命周期，告警路由参数可分为以下三类：

4.2 参数作用域：三个层级

参数的作用域决定了该参数在路由决策过程中的可见范围与生命周期。告警路由参数体系包含三个层级的作用域：

• 全局作用域： 对整个告警路由引擎生效，所有规则和窗口共享。例如：集群名称、默认告警接收人、全局静默时段。
• 路由规则级作用域： 仅对某一条具体的路由规则生效。例如：该规则的匹配条件、目标路由地址、规则优先级。
• 窗口级作用域： 仅在某个变更窗口的生命周期内生效。例如：窗口开始时间、窗口持续时间、窗口关联的变更单号。

4.3 参数分类与作用域的组合矩阵

将参数分类与作用域进行交叉组合，可以得到完整的告警路由参数体系矩阵，帮助你在配置和测试时快速定位参数归属：

4.4 参数体系架构图

下图展示了告警路由参数体系的整体架构，包括参数分类、作用域层级以及它们之间的交互关系：

4.5 参数配置代码示例

以下是一个典型的告警路由参数配置片段，展示了三种参数类型与三种作用域在实际配置中的体现：

# 全局作用域参数
global:
  cluster: "production"
  timezone: "Asia/Shanghai"
  default_receiver: "ops-oncall@company.com"

# 路由规则级参数
routes:
  - rule_id: "high_cpu_alert"
    priority: 10
    # 静态参数
    target_channel: "pagerduty"
    fixed_labels:
      env: "prod"
      team: "infra"
    # 动态参数（从告警事件中提取）
    match_conditions:
      - field: "severity"
        operator: "in"
        value: ["P0", "P1"]
      - field: "metric_name"
        operator: "eq"
        value: "cpu_usage"
    # 上下文参数（运行时注入）
    context:
      current_oncall: "${global.oncall_calendar.today}"
      service_dependencies: "${topology.service_deps}"

# 窗口级作用域参数
windows:
  - window_id: "change_20241001"
    type: "change"
    # 静态参数
    creator: "zhangsan"
    change_ticket: "CHG-20241001-001"
    # 动态参数（窗口运行时状态）
    status: "${window.current_status}"
    remaining_minutes: "${window.remaining_time}"
    # 上下文参数
    context:
      approver: "${change_approval.approver}"
      impact_scope: "${change_impact.services}"
    # 窗口级路由覆盖规则
    route_overrides:
      - rule_id: "high_cpu_alert"
        target_channel: "slack-critical"
        priority: 5