9. Prometheus-配置-规则概要及记录规则

最新推荐文章于 2025-05-30 09:04:33 发布

原创最新推荐文章于 2025-05-30 09:04:33 发布 · 483 阅读

0 ·

CC 4.0 BY-SA版权

Prometheus 专栏收录该内容

19 篇文章

订阅专栏

本文详细介绍了Prometheus的记录规则和警报规则配置方法，包括如何创建规则文件、使用YAML格式、规则文件的语法检查及如何在Prometheus中加载规则文件。了解这些规则有助于优化查询性能和实时监控。

原文:https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/

配置规则

Prometheus支持两种类型的规则，可以对其进行配置，然后定期进行评估：记录规则和警报规则。要将规则包含在Prometheus中，请创建一个包含必要规则语句的文件，并使Prometheus通过Prometheus配置中的rule_files字段加载该文件。规则文件使用YAML。

通过将SIGHUP发送到Prometheus进程，可以在运行时重新加载规则文件。仅当所有规则文件格式正确时，才会应用更改。

规则的语法检查

要在不启动Prometheus服务器的情况下快速检查规则文件在语法上是否正确，请安装并运行Prometheus的promtool命令行实用工具：

go get github.com/prometheus/prometheus/cmd/promtool
promtool check rules /path/to/example.rules.yml

当该文件在语法上有效时，检查器将已解析规则的文本表示形式打印到标准输出，然后以0返回状态退出。

如果存在任何语法错误或无效的输入参数，它将打印一条错误消息为标准错误，并以1返回状态退出。

记录规则

记录规则使您可以预先计算经常需要或计算量大的表达式，并将其结果保存为一组新的时间序列。这样，查询预先计算的结果通常比每次需要原始表达式都要快得多。这对于仪表板特别有用，仪表板每次刷新时都需要重复查询相同的表达式。

记录和警报规则存在于规则组中。组中的规则以规则的时间间隔顺序运行。

规则文件的语法为：

groups:
  [ - <rule_group> ]

一个简单的示例规则文件：

groups:
  - name: example
    rules:
    - record: job:http_inprogress_requests:sum
      expr: sum(http_inprogress_requests) by (job)

`<rule_group>`

# The name of the group. Must be unique within a file.
name: <string>

# How often rules in the group are evaluated.
[ interval: <duration> | default = global.evaluation_interval ]

rules:
  [ - <rule> ... ]

`<rule>`

记录规则的语法为：

# The name of the time series to output to. Must be a valid metric name.
record: <string>

# The PromQL expression to evaluate. Every evaluation cycle this is evaluated at the current time, and the result recorded as a new set of time series with the metric name as given by 'record'.
# 要评估的PromQL表达式。 每个评估周期都会在当前时间进行评估，并将结果记录为一组新的时间序列，其度量标准名称由"record"给出。
expr: <string>

# Labels to add or overwrite before storing the result.
labels:
  [ <labelname>: <labelvalue> ]

警报规则的语法为：

# The name of the alert. Must be a valid metric name.
alert: <string>

# The PromQL expression to evaluate. Every evaluation cycle this is evaluated at the current time, and all resultant time series become pending/firing alerts.
# 要评估的PromQL表达式。 每个评估周期都会在当前时间进行评估，所有产生的时间序列都会变为待处理/触发警报。
expr: <string>

# Alerts are considered firing once they have been returned for this long.
# Alerts which have not yet fired for long enough are considered pending.
[ for: <duration> | default = 0s ]

# Labels to add or overwrite for each alert.
labels:
  [ <labelname>: <tmpl_string> ]

# Annotations to add to each alert.
annotations:
  [ <labelname>: <tmpl_string> ]