您可以使用promtool来测试您的规则。

  1. # 单个测试文件
  2. ./promtool test rules test.yml
  4. # 多个测试文件
  5. ./promtool test rules test1.yml test2.yml test3.yml
一、测试文件格式
  1. # 这是要考虑进行测试的规则文件列表。
  2. rule_files:
  3.   [ - <file_name> ]
  5. # 可选的, 默认 = 1m
  6. evaluation_interval: <duration>
  8. # 下面列出组名称的顺序将是规则组的评估顺序（在给定的评估时间）。 订单仅适用于下面提到的组。
  9. # 下面不需要提到所有组。
  10. group_eval_order:
  11.   [ - <group_name> ]
  13. # 所有测试都列在这里。
  14. tests:
  15.   [ - <test_group> ]
1.1 <test_group>
  1. # 系列数据
  2. interval: <duration>
  3. input_series:
  4.   [ - <series> ]
  6. # 上述数据的单元测试
  8. # 警报规则的单元测试。 我们从输入文件中考虑警报规则。
  9. alert_rule_test:
  10.   [ - <alert_test_case> ]
  12. # 单元测试PromQL表达式。
  13. promql_expr_test:
  14.   [ - <promql_test_case> ]
1.2 <series>
  1. # 这遵循通常的系列符号 '<metric name>{<label name>=<label value>, ...}'
  2. # 例子: 
  3. #      series_name{label1="value1", label2="value2"}
  4. #      go_goroutines{job="prometheus", instance="localhost:9090"}
  5. series: <string>
  7. # 这使用扩展表示法。
  8. # 扩展符号：
  9. #     'a+bxc' becomes 'a a+b a+(2*b) a+(3*b) … a+(c*b)'
  10. #     'a-bxc' becomes 'a a-b a-(2*b) a-(3*b) … a-(c*b)'
  11. # 例子:
  12. #     1. '-2+4x3' becomes '-2 2 6 10'
  13. #     2. ' 1-2x4' becomes '1 -1 -3 -5 -7'
  14. values: <string>
1.3 <alert_test_case>

Prometheus允许您为不同的警报规则使用相同的警报名称。 因此，在此单元测试中，您必须在单个<alert_test_case>下列出alertname的所有触发警报的并集。

  1. # 这是从必须检查警报的时间= 0开始经过的时间。
  2. eval_time: <duration>
  4. # 要测试的警报的名称。
  5. alertname: <string>
  7. # 在给定评估时间在给定警报名称下触发的预期警报列表。 如果您想测试是否不应该触发警报规则，那么您可以提及上述字段并将“exp_alerts”留空。
  8. exp_alerts:
  9.   [ - <alert> ]
1.4 <alert>
  1. # 这些是预期警报的扩展标签和注释。 
  2. # 注意：标签还包括与警报关联的样本标签（与您在`/alerts`中看到的标签相同，没有系列`__name__`和`alertname`）
  3. exp_labels:
  4.   [ <labelname>: <string> ]
  5. exp_annotations:
  6.   [ <labelname>: <string> ]
1.5 <promql_test_case>
  1. # 表达评估
  2. expr: <string>
  4. # 这是从必须检查警报的时间= 0开始经过的时间。
  5. eval_time: <duration>
  7. # 在给定评估时间的预期样品。
  8. exp_samples:
  9.   [ - <sample> ]
1.6 <sample>
  1. # 通常系列表示法中的样本标签 '<metric name>{<label name>=<label value>, ...}'
  2. # 例子: 
  3. #      series_name{label1="value1", label2="value2"}
  4. #      go_goroutines{job="prometheus", instance="localhost:9090"}
  5. labels: <string>
  7. # promql表达式的期望值。
  8. value: <number>
二、例子

这是用于通过测试的单元测试的示例输入文件。 test.yml是遵循上述语法的测试文件，alerts.yml包含警报规则。

将alerts.yml放在同一目录中，运行./promtool test rules test.yml。

2.1 <test.yml>
  1. # This is the main input for unit testing. 
  2. # Only this file is passed as command line argument.
  4. rule_files:
  5.     - alerts.yml
  7. evaluation_interval: 1m
  9. tests:
  10.     # Test 1.
  11.     - interval: 1m
  12.       # Series data.
  13.       input_series:
  14.           - series: 'up{job="prometheus", instance="localhost:9090"}'
  15.             values: '0 0 0 0 0 0 0 0 0 0 0 0 0 0 0'
  16.           - series: 'up{job="node_exporter", instance="localhost:9100"}'
  17.             values: '1+0x6 0 0 0 0 0 0 0 0' # 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0
  18.           - series: 'go_goroutines{job="prometheus", instance="localhost:9090"}'
  19.             values: '10+10x2 30+20x5' # 10 20 30 30 50 70 90 110 130
  20.           - series: 'go_goroutines{job="node_exporter", instance="localhost:9100"}'
  21.             values: '10+10x7 10+30x4' # 10 20 30 40 50 60 70 80 10 40 70 100 130
  23.       # Unit test for alerting rules.
  24.       alert_rule_test:
  25.           # Unit test 1.
  26.           - eval_time: 10m
  27.             alertname: InstanceDown
  28.             exp_alerts:
  29.                 # Alert 1.
  30.                 - exp_labels:
  31.                       severity: page
  32.                       instance: localhost:9090
  33.                       job: prometheus
  34.                   exp_annotations:
  35.                       summary: "Instance localhost:9090 down"
  36.                       description: "localhost:9090 of job prometheus has been down for more than 5 minutes."
  37.       # Unit tests for promql expressions.
  38.       promql_expr_test:
  39.           # Unit test 1.
  40.           - expr: go_goroutines > 5
  41.             eval_time: 4m
  42.             exp_samples:
  43.                 # Sample 1.
  44.                 - labels: 'go_goroutines{job="prometheus",instance="localhost:9090"}'
  45.                   value: 50
  46.                 # Sample 2.
  47.                 - labels: 'go_goroutines{job="node_exporter",instance="localhost:9100"}'
  48.                   value: 50
2.2 <alerts.yml>
  1. # This is the rules file.
  3. groups:
  4. - name: example
  5.   rules:
  7.   - alert: InstanceDown
  8.     expr: up == 0
  9.     for: 5m
  10.     labels:
  11.         severity: page
  12.     annotations:
  13.         summary: "Instance {{ $labels.instance }} down"
  14.         description: "{{ $labels.instance }} of job {{ $labels.job }} has been down for more than 5 minutes."
  16.   - alert: AnotherInstanceDown
  17.     expr: up == 0
  18.     for: 10m
  19.     labels:
  20.         severity: page
  21.     annotations:
  22.         summary: "Instance {{ $labels.instance }} down"
  23.         description: "{{ $labels.instance }} of job {{ $labels.job }} has been down for more than 5 minutes."