全局屏蔽

[PLUS] 全局屏蔽是夜莺企业版（PLUS）独有功能。

概述

全局屏蔽 = 一条跨所有业务组默认生效的告警屏蔽规则。

侧栏路径：告警 → 规则管理 → 全局屏蔽 Tab，URL /global-muting-rules。

和「屏蔽规则」的区别：

维度	屏蔽规则（OSS + PLUS）	全局屏蔽（PLUS）
作用范围	绑定在某一个业务组下，仅对该业务组的事件生效	全实例所有业务组默认生效
范围控制	选「适用业务组 / 数据源」做白名单	选「排除业务组 / 数据源」做黑名单
适用场景	业务团队自己消化某些已知噪音	平台管理员统一处理跨业务的大范围维护（如机房断电、网络改造、版本发布窗口）
入口	业务组上下文里的「屏蔽规则」	全局屏蔽 Tab（仅 Admin 角色）

典型用例：

• 周末凌晨所有业务组机房断电演练，提前配一条全局屏蔽，整个窗口期不吵；
• 某条公共指标（比如 target_miss）在某个 IDC 集中维护时段统一压制；
• 跨业务组的变更窗口：发布期间排除"变更受影响"的业务组，其余照常告警。

新建 / 编辑全局屏蔽

页面顶部有 Pro 标签 — 没看到说明你的实例不是 PLUS 版。

表单分为 3 个区域：

① 基本信息

字段	必填	说明
屏蔽原因	否（但强烈建议填）	写清楚"为什么屏蔽 + 谁负责 + 预期恢复时间"，列表里看到的就是这个

② 筛选条件

定义"哪些事件命中后被屏蔽"。

字段	必填	说明
事件标签	是（至少 1 条）	标签匹配条件，点 + 按钮加一行。每行支持 =（等于）、!=（不等）、=~（正则）、!~（正则不匹配）四种操作。多行之间是与关系。例如 env=prod + service=api 表示同时满足
排除业务组	否	黑名单 — 选中的业务组不被屏蔽。不填表示"全部业务组都屏蔽"
排除数据源	否	黑名单 — 选中的数据源不被屏蔽。不填表示"全部数据源都屏蔽"

⚠️ 事件标签是全局屏蔽生效的最关键依据 — 不填会保存失败（后端报 “tags is blank”）。永远要至少有一个标签条件，避免误伤所有告警。

③ 屏蔽时长

支持两种时间模式：

固定时间（默认）：选一段连续的时间窗口。

• 屏蔽时长：1h / 6h / 24h / 7d 等快捷选项；
• 屏蔽开始时间 / 屏蔽结束时间：选时长后自动算出，也可以手动改成任意区间；
• 到了结束时间，规则自动失效，需要重新启用或新建。

周期时间：每周固定时段都屏蔽，长期生效。

• 屏蔽时间：左侧多选周一到周日（点 ❌ 取消）
• 开始时间 / 结束时间：当天的 HH:MM，比如 00:00 到 06:00 表示每天凌晨 0-6 点
• 点 + 加按钮可以添加多个时段（如夜间 + 周末）

周期模式常用于"夜间维护窗口长期生效"、“工作日午休期间静默"等持续性场景；只是临时一次性屏蔽用「固定时间」更直观。

操作 & 行为

• 启用 / 禁用：列表里直接拨 Switch；禁用后规则保留，但不再生效。
• 删除：删后规则消失；想留作模板下次复用就保留 + 禁用。
• 生效关系：一条事件 ∪ 全局屏蔽 ∪ 该业务组的本地屏蔽规则 — 只要命中任何一条屏蔽规则，就不会产生通知。

常见问题

Q1：全局屏蔽配错了把整个平台告警都压住了，怎么紧急止血？

A：进列表把对应规则的「启用」开关关掉 — 几秒内生效。这就是为什么"屏蔽原因"建议写清楚责任人 + 预期恢复时间，方便值班同学快速判断能否关掉。永远不要配一条"事件标签 = __name__=~.+"+“无排除"的规则 — 这等于关掉了整个平台的告警。

Q2：全局屏蔽和业务组下的屏蔽规则同时存在，事件会被屏蔽几次？

A：屏蔽是或关系，只要命中任何一条屏蔽规则就被压制，不会重复屏蔽。所以两套规则可以共存：平台层做大范围（如机房维护），业务层做本组特有的（如自家服务的已知噪音）。

Q3：屏蔽规则生效后，原本要触发的告警事件还会出现在「活跃告警」列表吗？

A：不会。被屏蔽的事件不会产生告警事件，也不会推送通知，活跃告警列表里看不到。如果要看"如果不屏蔽会有多少事件”，可以在屏蔽规则到期后回看历史告警里的恢复事件来评估。

Q4：周期时间模式跨天怎么写（比如每天 22:00 到次日 06:00）？

A：建议拆成两段：周一到周日 22:00-23:59 + 周一到周日 00:00-06:00。当前 UI 不支持单段跨日。

参考资料

• 屏蔽规则（业务组级）
• 告警规则
• 活跃告警