promtool

Prometheus 配置与规则校验工具

补充说明

promtool 检查 Prometheus 配置、告警/记录规则，运行规则单元测试，也可以查询运行中的 Prometheus 和检查 TSDB。

常用示例

promtool check config prometheus.yml
promtool check rules rules.yml
promtool test rules tests.yml
promtool query instant http://prometheus:9090 'up'
promtool query range --start=1h http://prometheus:9090 'rate(http_requests_total[5m])'
promtool tsdb analyze /prometheus
promtool tsdb list /prometheus

规则测试：

rule_files:
  - rules.yml
evaluation_interval: 1m
tests:
  - interval: 1m
    input_series:
      - series: 'up{job="api"}'
        values: '0 0 1 1 1'
    alert_rule_test:
      - eval_time: 3m
        alertname: InstanceDown
        exp_alerts:
          - exp_labels:
              severity: critical
              job: api

易错点与排错

• check config 只校验语法和引用，不验证抓取目标是否可达。
• 规则文件路径要相对于 Prometheus 工作目录；CI 里容易路径错。
• test rules 需要完整的时间序列输入；values 的写法要符合语法。
• 查询命令连接的是运行中的 Prometheus；认证和 TLS 要配置。
• TSDB 分析需要只读或离线访问；生产环境注意权限和 I/O。
• Prometheus 版本与 promtool 版本要匹配；跨版本语法可能不同。
• 校验通过不代表规则合理；告警阈值和持续时间仍要评审。

相关命令

• amtool — Alertmanager 管理
• prometheus — 服务端
• logcli — Loki 查询