规则管理

「规则管理」用于创建和维护告警规则。规则定义了「当哪个指标满足什么条件、持续多久、达到什么等级时触发告警」。规则与表达式解耦，表达式可被多条规则复用，方便统一维护监控口径。

入口路径：左侧菜单 告警中心 > 规则管理，页面路由 /admin/duty/alert-rule/index。

页面菜单

页面	路由	说明
告警规则	/admin/duty/alert-rule	创建、编辑、删除告警规则
创建告警规则	/admin/duty/alert-rule/create	新建规则表单
编辑告警规则	/admin/duty/alert-rule/edit/:uuid	修改已有规则
表达式	/admin/duty/alert-rule-expr	管理可复用的 PromQL 表达式

---

告警规则：从指标到告警

创建一条告警规则

1. 进入 规则管理 > 告警规则。
2. 点击「新增告警规则」。
3. 填写基础信息：
   • 规则名称：全局唯一，建议使用语义化命名，如 gpu-memory-usage-high。
   • 别名：展示用别名。
   • 描述：说明该规则的触发场景与处理建议。
4. 选择 表达式：
   • 下拉框支持远程搜索与筛选。
   • 选项分为系统内置（蓝色标签）和自定义（绿色标签）。
   • 表达式定义了监控哪个 PromQL 指标，例如 GPU 显存使用率、任务失败率等。
5. 配置 触发条件：
   • 点击「添加触发条件」，最多可添加 3 组。
   • 每组包含：
     • 操作符：==、!=、>、<、>=、<=
     • 阈值：数值，支持最多 4 位小数；表达式若配置了单位，阈值输入框会自动带单位后缀。
     • 持续时间：如 1m、5m、10m，表示指标持续满足条件多久才触发。
     • 告警等级：P1 / P2 / P3，每个等级在一条规则内只能出现一次。
6. （可选）添加 标签：
   • 填写键值对，例如 team=ops、service=ai-gateway。
   • 标签会随告警一起发送，可用于告警降噪、分派与筛选。
7. 点击「创建」。
8. 创建成功后返回列表页，可继续配置订阅策略，让告警通知到值班人员。

一条规则建议只覆盖一个核心指标，阈值不要设得过低，避免告警风暴。

验证告警依据

1. 在告警规则列表中找到目标规则。
2. 点击行操作「Prometheus 图表」。
3. 系统会按规则表达式即时查询指标曲线，帮助确认：
   • 指标最近是否有波动。
   • 当前值是否接近阈值。
   • 阈值设置是否合理。
4. 验证完成后如需调整，点击「编辑」修改阈值或持续时间。

编辑与删除

1. 在列表中找到目标规则，点击「编辑」。
2. 可修改别名、描述、表达式、触发条件、标签；规则名称创建后不可修改。
3. 点击「保存」。
4. 如需删除，点击「删除」并二次确认。

---

表达式：复用监控口径

表达式是一段 PromQL 模板，描述如何计算某个监控指标。把表达式独立管理后，多个告警规则可以引用同一个指标口径，避免重复编写 PromQL。

查看表达式

1. 进入 规则管理 > 表达式。
2. 列表展示：表达式名称、ID、模板内容、单位、来源分类（系统/自定义）、启用状态。
3. 使用顶部筛选：
   • 按名称模糊搜索。
   • 按来源筛选：系统内置 / 自定义。
   • 按启用状态筛选。

新建表达式

1. 点击「新增表达式」。
2. 填写：
   • 名称：全局唯一。
   • 模板内容：PromQL 表达式，例如 avg(gpu_memory_usage_percent) by (node)。
   • 单位：如 %、MB、次，用于在告警规则阈值输入框中自动显示单位后缀。
3. 点击「确定」。

启用/禁用表达式

1. 在表达式列表中找到目标表达式。
2. 系统内置表达式不可编辑，但可启用/停用。
3. 自定义表达式可单独启用或禁用；禁用后，引用它的告警规则将无法选择该表达式。

修改表达式会影响所有引用它的告警规则，请谨慎操作。

---

常见问题

Q：P1/P2/P3 有什么区别？ A：P1 最高，通常对应故障级告警；P2 为警告级；P3 为提示级。不同等级可在订阅策略中配置不同的通知渠道与升级策略。

Q：为什么创建了规则却没有触发告警？ A：请检查：

1. 表达式对应的指标是否有数据。
2. 阈值是否设置得过高。
3. 持续时间是否设置得过长。
4. 规则是否已启用。
5. 是否已配置订阅策略将告警分派出去。

Q：阈值带单位后缀有什么好处？ A：单位来自表达式配置，填写阈值时直观知道是百分比、MB 还是次数，降低配置错误。

Q：告警规则名称创建后能改吗？ A：不能。告警规则名称全局唯一，创建后不可修改；如需变更名称，请新建规则。

Q：同一规则内 P1 能配置多次吗？ A：不能。同一规则内每个告警等级（P1/P2/P3）只能出现一次。

Q：禁用表达式会影响已有告警规则吗？ A：会。表达式启用状态会影响所有引用它的告警规则；禁用前请确认没有规则正在使用该表达式。