文档中心

托管 Prometheus

告警规则模板

自定义告警规则模板

除系统提供的预置告警规则模版外，您也可以根据需求，自定义告警规则模板，快速完成云产品的告警规则配置。本文为您介绍如何创建自定义告警模版。

说明

【邀测·申请试用】：该功能目前处于邀测阶段，如需使用，请联系您的客户经理。

背景信

创建自定义告警规则模版支持手动创建或导入已有模版两种方式。主要场景和说明，如下表所示。

使用场景	场景说明
手动创建模版	手动创建告警模版，支持自定义变量和告警规则（PromQL 语句、告警等级、阈值等）。
导入已有模版	导入其他渠道（例如自建 Prometheus）中的 Prometheus 告警模版，方便用户快速完成跨地域、跨厂商之间的告警规则、模版的同步。导入模版类型：支持导入火山引擎告警规则模版和 Prometheus 原生告警规则模板。导入模版方式：支持上传 Yaml 文件或粘贴 Yaml 文件内容。

使用限制

导入模版时，模版文件最大为 100 MB。

导入模板时，一次最多导入 3 个模版。

导入 Prometheus 原生告警规则模板时，托管 Prometheus 会根据导入的告警模版中，单条告警规则 label 的 level 字段值进行告警等级的转换。转换关系如下表所示。

托管 Prometheus 中的告警等级
其他渠道 Prometheus 告警模版中的告警等级
P0
P0、critical
P1
P1、error、warning
P2
P2、info、notice

说明

如果导入的模版中，单条告警规则 label 中不存在 level 字段，则系统会默认将此规则的告警等级转换为 P2。

创建自定义告警模版

手动创建模版

在顶部导航栏，选择目标地域。

单击左侧导航栏的告警中心 > 告警规则模板，选择自定义模板页签。

单击手动创建，创建自定义告警模板。

配置告警模板的基础信息。

配置项	说明
名称	配置告警模板的名称。在相同地域内，告警模板的名称需保持唯一。
Label	单击添加一行，配置告警规则的全局 Label。说明当您在创建工作区、创建告警规则等多个位置配置 Label 时，Label 的优先级为：规则 Label > 全局 Label > PromQL Label。

变量配置。单击添加变量，配置告警模板中的全局变量。您可以通过在告警规则模版中定义变量，并在使用模版创建告警规则时引用这些变量。系统会自动将变量作为标签，添加到告警规则的 PromQL 语句中。

配置项	说明
变量类型	选择变量类型，包括： Query：PromQL 动态变量，该类型的变量仅能定义变量名称，无法直接定义变量值。例如：在集群的监控指标中，集群 ID、命名空间名称等，均为动态值。动态变量的值可以通过指定 PromQL 语句和正则表达式来获取。 Custom：固定值变量，用于匹配固定的变量值。例如：在集群的监控指标中，工作负载的类型是固定的，包括 Depolyment、StatefulSet、DaemonSet 等，可以直接指定。
变量名称	配置变量的变量名称和 Label。变量名称：匹配 PromQL 语句中的特定 Label。 Label：描述该变量的含义和作用，并在控制台上展现，方便用户理解。说明变量用于对监控数据中的云产品资源对象进行更细粒度的筛选，例如：在 VKE 产品中，您可以通过变量选择 VKE 集群或命名空间。变量名称首字母必须大写，采用驼峰格式。例如ClusterNode。
变量配置	配置变量匹配规则和取值。包括：查询语句：当变量类型选择 Query 时，需要配置获取变量取值的 PromQL 查询语句。例如kube_node_info。匹配表达式：当变量类型选择 Query 时，需要配置获取变量取值的正则表达式，系统会基于查询语句和匹配表达式获取变量的值。例如：您可以使用/.cluster="(.?)".*/表达式，匹配 PromQL 语句中任意包含cluster="任意文本"形式的字符串，并将 cluster=" 和闭合的"之间的文本捕获下来作为一个变量组。变量：当变量类型选择 Custom 时，在文本框内配置变量的固定值，允许使用空格分割不同的值。变量值多选：启用后，选择变量时允许选择多个变量值。添加全选：启用后，变量中包括全部选项，即允许选择所有的变量值。

规则配置。单击添加规则，配置告警模板中的告警规则。

配置项	说明
规则名称	配置告警规则的名称。相同模板内，规则名称必须唯一。
PromQL	使用标准 PromQL 语句，配置监控对象或指标。说明您可以在 PromQL 语句中以$变量名称的形式引用全局变量。例如，如果您定义了集群变量为Cluster，则可以通过node_cpu_seconds_total{cluster="$Cluster"}的形式引用该变量。
触发策略	配置告警触发策略。指定告警等级、条件、阈值和条件持续时间。勾选 P0、P1 或 P2，表示设定不同的告警等级。取消勾选，则表示不设定该等级的告警。比较条件：指定 PromQL 语句和阈值之间的比较条件。支持多个比较条件，包括：大于、大于等于、小于、小于等于、等于和不等于。阈值：配置指标的阈值。条件持续时间：配置指标符合条件的持续时间，包括：立即触发：满足告警条件后，立即触发告警。 1 分钟：满足告警条件，并持续 1 分钟后，再触发告警。 2 分钟：满足告警条件，并持续 2 分钟后，再触发告警。 5 分钟：满足告警条件，并持续 5 分钟后，再触发告警。 10 分钟：满足告警条件，并持续 10 分钟后，再触发告警。
Label	单击添加一行，配置告警规则的 Label。说明当您在创建工作区、创建告警规则等多个位置配置 Label 时，Label 的优先级为：规则 Label > 全局 Label > PromQL Label。
Annotation	单击添加一行，配置告警规则的 Annotation。