怎么在 Prometheus 中配置告警规则规则文件 rule_files 路径

核心结论：在 prometheus.yml 中配置 rule_files 指向规则文件路径，修改后必须重载服务才能生效。

• 适用场景：二进制部署、Systemd 管理、Docker 容器部署
• 前置条件：规则文件 YAML 语法正确，Prometheus 进程有读取权限
• 验证方式：Web UI Rules 页面查看状态或调用 API 查询

Prometheus 通过 rule_files 字段加载告警规则和记录规则。配置路径支持绝对路径、相对路径及通配符。

1. 配置规则文件路径

编辑主配置文件 prometheus.yml，添加或修改 rule_files 字段：

rule_files:- "/etc/prometheus/rules/*.yml"- "alerts/*.rules"

注意：相对路径是相对于 Prometheus 启动时的工作目录，而非配置文件所在目录，建议生产环境使用绝对路径。

2. 检查配置语法

修改配置后，先使用 promtool 工具检查语法，避免重载失败：

promtool check config /etc/prometheus/prometheus.yml

输出 SUCCESS 表示语法无误。

3. 重载配置生效

配置修改不会自动生效，需重载进程。推荐优先使用系统包管理器方式，若使用 HTTP API 需额外开启参数。

方式一：Systemd 管理（推荐）

如果 Prometheus 由 systemd 管理，直接发送重载信号：

systemctl reload prometheus

方式二：HTTP API 重载

若需通过 curl 调用 API 重载，启动时必须添加 `--web`.enable-lifecycle 参数。

Systemd 添加参数示例：

编辑服务文件 /etc/systemd/system/prometheus.service，在 ExecStart 行追加参数：

ExecStart=/usr/local/bin/prometheus `--config`.file=/etc/prometheus/prometheus.yml `--web`.enable-lifecycle

保存后重载 systemd 并重启 Prometheus：

systemctl daemon-reload
systemctl restart prometheus

Docker 添加参数示例：

docker run -d `--name` prometheus prom/prometheus `--config`.file=/etc/prometheus/prometheus.yml `--web`.enable-lifecycle

参数生效后，执行以下命令重载：

curl -X POST http://localhost:9090/-/reload

4. 验证规则加载

方法一：Web UI 查看

访问 Prometheus 首页，点击顶部菜单 Status -> Rules，确认配置的规则组出现在列表中且状态正常。

方法二：API 查询

curl http://localhost:9090/api/v1/rules

返回 JSON 中包含 "status": "success" 且 data 中有对应规则组信息。

5. 常见故障排查

• curl 重载返回 403 或 404：说明未开启生命周期 API。检查启动参数是否包含 `--web`.enable-lifecycle，修改后需重启进程。
• 规则未显示：检查文件路径是否正确，Prometheus 进程用户是否有文件读取权限。
• YAML 缩进错误：rule_files 列表项前必须加短横线及空格（如 - "path"），否则解析失败。
• 通配符不匹配：确保 shell 通配符语法正确，且目录下确实存在匹配文件。

原文链接：https://www.zjcp.cc/ask/11413.html