Prometheus 告警规则构建器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装规范名 @user_3c6cb52e/prometheus-alert-rule-builder 对应的 Prometheus 告警规则构建器技能。
技能介绍
解决什么问题
手写 Prometheus 告警规则时,最常见的痛点是规则写得对不对没人知道。一条 alert: HighCPUUsage 规则里的 PromQL 表达式少一个边界、阈值写反、for 时长配置不当,往往要到告警风暴或该响不响时才会暴露。与此同时,Alertmanager 的路由树配置是另一层负担:route、group_by、continue 这些字段与 receiver 的匹配关系一旦写错,告警就会静默丢失。接入 PagerDuty、Slack、OpsGenie 等通知渠道还要各自维护 receiver 模板,手工拼配置既慢又容易不一致。
核心能力与工作方式
这个技能围绕两条主线工作:
- 告警规则构建:根据监控目标用 PromQL 表达式生成告警规则,覆盖阈值判断、持续时间(
for)和标签标签(labels)等要素。 - 规则校验:借助 Prometheus HTTP API 对规则做校验,在规则落盘前暴露语法与逻辑问题,避免把错误配置直接推给线上环境。
- Alertmanager 路由配置:生成路由树结构,处理告警的分组、抑制与分发路径。
- 通知渠道集成:配置 PagerDuty、Slack、OpsGenie 三类 receiver,把不同严重级别的告警送到对应的处理通道。
典型使用流程是:先明确要监控的指标和判定条件,技能据此产出 PromQL 与规则结构;再通过 HTTP API 验证规则的有效性;最后补齐 Alertmanager 的路由与 receiver 配置,形成一条从指标到通知的完整链路。
适用边界与注意点
- 依赖可用的 API 环境:规则校验依赖 Prometheus HTTP API 可达,部署在隔离网络或 API 未开启时校验步骤无法执行。
- 只负责配置,不负责设计监控体系:指标怎么选、阈值怎么定,仍然需要运维人员结合业务判断,技能提供的是规则与路由的生成和校验能力。
- Receiver 集成取决于环境配置:PagerDuty、Slack、OpsGenie 的凭证和端点需要使用者自行在环境中准备好。
- 规则语义需回归验证:通过校验只说明规则结构合法,阈值与持续时间是否贴合实际负载,建议在测试环境做回归观察后再上线。
截图预览
使用场景
- 监控团队要把新指标的告警规则写入配置文件前,先用 HTTP API 校验 PromQL 表达式和标签结构是否合法
- 平台工程师需要为不同严重级别的告警配置 Alertmanager 路由树,区分 PagerDuty 值班告警和 Slack 通知
- 运维人员要把 OpsGenie 接入现有 Alertmanager 配置,但不确定 receiver 模板字段该怎么填
- 上线新服务前,要给高 CPU 和高内存场景补上带 for 持续时间的告警规则,避免瞬时抖动触发误报
适合人员
- 负责监控基础设施的平台工程师,需要生成并校验 Prometheus 告警规则,避免错误配置流入生产环境
- 管理 Alertmanager 路由和通知渠道的运维工程师,需要配置 PagerDuty、Slack、OpsGenie 的接收器集成
- 正在搭建 Prometheus 监控体系的后端工程师,需要为新业务指标编写带 for 持续时间的告警规则