首页/云/可观测性速查/promtool:配置与规则校验工具
Prometheus 与采集64 条

promtool:配置与规则校验工具

promtool 随 Prometheus 发行包提供:check config、check rules 做静态校验,test rules 跑规则单元测试;建议纳入 CI,在部署前拦截错误。

可观测性速查云更新于 2026-10-12

常用命令

常用命令
promtool check config prometheus.yml
promtool check rules rules/*.yml
promtool test rules test_rules.yml
promtool check metrics < /metrics   # 检查指标命名是否符合惯例
promtool check metrics 会提示命名与单位问题(如缺少单位后缀),适合接入采集端的质量门禁。

易错点

  • 配置只在服务器上手工改、没有 CI 校验时,错误往往在重启那一刻才被发现
  • check rules 能查语法结构,但查不出业务语义错误,仍需测试用例覆盖

数据来源与参考

  • Prometheus 文档 · promtool 使用说明
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌