跳转至

配置通知模板

模板语法（Go Template）说明

告警通知模板采用了 Go Template 语法来渲染模板。

模板会基于下面的数据进行渲染。

{
    "status": "firing",
    "labels": {
        "alertgroup": "test-group",           // 告警策略名称
        "alertname": "test-rule",          // 告警规则名称
        "cluster": "35b54a48-b66c-467b-a8dc-503c40826330",
        "customlabel1": "v1",
        "customlabel2": "v2",
        "endpoint": "https",
        "group_id": "01gypg06fcdf7rmqc4ksv97646",
        "instance": "10.6.152.85:6443",
        "job": "apiserver",
        "namespace": "default",
        "prometheus": "insight-system/insight-agent-kube-prometh-prometheus",
        "prometheus_replica": "prometheus-insight-agent-kube-prometh-prometheus-0",
        "rule_id": "01gypg06fcyn2g9zyehbrvcdfn",
        "service": "kubernetes",
        "severity": "critical",
        "target": "35b54a48-b66c-467b-a8dc-503c40826330",
        "target_type": "cluster"
   },
    "annotations": {
        "customanno1": "v1",
        "customanno2": "v2",
        "description": "这是一条测试规则，10.6.152.85:6443 down",
        "value": "1"
    },
    "startsAt": "2023-04-20T07:53:54.637363473Z",
    "endsAt": "0001-01-01T00:00:00Z",
    "generatorURL": "http://vmalert-insight-victoria-metrics-k8s-stack-df987997b-npsl9:8080/vmalert/alert?group_id=16797738747470868115&alert_id=10071735367745833597",
    "fingerprint": "25c8d93d5bf58ac4"
}

使用说明

  1. . 字符

    在当前作用域下渲染指定对象。

    示例 1：取顶级作用域下的所有内容，即示例代码中上下文数据的全部内容。

    {{ . }}

  2. 判断语句 if / else

    使用 if 检查数据，如果不满足可以执行else。

    {{if .Labels.namespace }}命名空间: {{ .Labels.namespace }} \n{{ end }}

  3. 循环函数 for

    for 函数用于重复执行代码内容。

    示例 1：遍历 labels 列表，获取告警的所有 label 内容。

    {{ for .Labels}} \n {{end}}

阈值模板说明

Insight 内置 Webhook 告警模板如下，其他如邮件、企业微信等内容相同，只是对换行进行相应调整。

规则名称: {{ .Labels.alertname }} \n
策略名称: {{ .Labels.alertgroup }} \n
告警级别: {{ .Labels.severity }} \n
集群: {{ .Labels.cluster }} \n
{{if .Labels.namespace }}命名空间: {{ .Labels.namespace }} \n{{ end }}
{{if .Labels.node }}节点: {{ .Labels.node }} \n{{ end }}
资源类型: {{ .Labels.target_type }} \n
{{if .Labels.target }}资源名称: {{ .Labels.target }} \n{{ end }}
触发值: {{ .Annotations.value }} \n
发生时间: {{ .StartsAt }} \n
{{if ne "0001-01-01T00:00:00Z" .EndsAt }}结束时间: {{ .EndsAt }} \n{{ end }}
描述: {{ .Annotations.description }} \n

邮箱主题参数

由于 Insight 在发送告警消息时，会对同一时间同一条规则产生的消息进行合并发送， 所以 email 主题不同于上面四种模板，只会使用告警消息中的 commonLabels 内容对模板进行渲染。默认模板如下：

[{{ .status }}] [{{ .severity }}] 告警: {{ .alertname }}

其他可作为邮箱主题的字段如下：

{{ .status }} 告警消息的触发状态
{{ .alertgroup }} 告警所属的策略名称
{{ .alertname }} 告警所属的规则名称
{{ .severity }} 告警级别
{{ .target_type }} 告警资源类型
{{ .target }} 告警资源对象
{{ .规则其他自定义 label key }}

评论