跳到主要内容
版本:v2.6

PrometheusRule 配置

PrometheusRule 定义了一组 Prometheus 告警和/或记录规则。

备注

本节参考假设你已经熟悉 Monitoring 组件的协同工作方式。有关详细信息,请参阅本节

在 Rancher UI 中创建 PrometheusRule

先决条件:

已安装 Monitoring 应用。

要在 Rancher UI 中创建规则组:

  1. 转到要创建规则组的集群。单击监控 > 高级选项,然后单击 PrometheusRules
  2. 单击创建
  3. 输入组名称
  4. 配置规则。在 Rancher 的 UI 中,规则组需要包含告警规则或记录规则,但不能同时包含两者。如需获取填写表单的帮助,请参阅下方的配置选项。
  5. 单击创建

结果:告警可以向接收器发送通知。

关于 PrometheusRule 自定义资源

当你定义规则时(在 PrometheusRule 资源的 RuleGroup 中声明),规则本身的规范会包含标签,然后 Alertmanager 会使用这些标签来确定接收此告警的路由。例如,标签为 team: front-end 的告警将​​发送到与该标签匹配的所有路由。

Prometheus 规则文件保存在 PrometheusRule 自定义资源中。PrometheusRule 支持定义一个或多个 RuleGroup。每个 RuleGroup 由一组 Rule 对象组成,每个 Rule 对象均能表示告警或记录规则,并具有以下字段:

  • 新告警或记录的名称
  • 新告警或记录的 PromQL 表达式
  • 用于标记告警或记录的标签(例如集群名称或严重性)
  • 对需要在告警通知上显示的其他重要信息进行编码的注释(例如摘要、描述、消息、Runbook URL 等)。记录规则不需要此字段。

有关可以指定的字段的更多信息,请查看 Prometheus Operator 规范。

你可以使用 Prometheus 对象中的标签选择器字段 ruleSelector 来定义要挂载到 Prometheus 的规则文件。

如需查看示例,请参阅 Prometheus 文档中的记录规则告警规则

配置

规则组

字段描述
组名称组的名称。在规则文件中必须是唯一的。
覆盖组间隔组中规则的评估时间间隔(单位:秒)。

告警规则

告警规则可以让你根据 PromQL(Prometheus 查询语言)表达式来定义告警条件,并将触发告警的通知发送到外部服务。

字段描述
告警名称告警的名称。必须是有效的标签值。
告警触发等待时间时长,以秒为单位。当告警触发时间到达该指定时长时,则视为触发。当告警未触发足够长的时间,则视为待处理。
PromQL 表达式要评估的 PromQL 表达式。Prometheus 将在每个评估周期评估此 PromQL 表达式的当前值,并且所有生成的时间序列都将成为待处理/触发告警。有关详细信息,请参阅 Prometheus 文档或我们的 PromQL 表达式示例
Labels为每个告警添加或覆盖的标签。
严重程度启用后,标签​​会附加到告警或记录中,这些标签通过严重程度来标识告警/记录。
严重程度 Label 值Critical,warning 或 none
注释注释是一组信息标签,可用于存储更长的附加信息,例如告警描述或 Runbook 链接。Runbook 是一组有关如何处理告警的文档。注释值可以是模板化的。

记录规则

记录规则允许你预先计算常用或计算量大的 PromQL(Prometheus 查询语言)表达式,并将其结果保存为一组新的时间序列。

字段描述
时间序列名称要输出的时间序列的名称。必须是有效的指标名称。
PromQL 表达式要评估的 PromQL 表达式。Prometheus 将在每个评估周期评估此 PromQL 表达式的当前值,并且将结果记录为一组新的时间序列,其指标名称由“记录”指定。有关表达式的更多信息,请参阅 Prometheus 文档或我们的 PromQL 表达式示例
Labels在存储结果之前要添加或覆盖的标签。