自定义告警模板

默认情况下Alertmanager使用了系统自带的默认通知模板,模板源码可以从https://github.com/prometheus/alertmanager/blob/master/template/default.tmpl获得。Alertmanager的通知模板基于Go的模板系统。Alertmanager也支持用户定义和使用自己的模板,一般来说有两种方式可以选择。

第一种,基于模板字符串。用户可以直接在Alertmanager的配置文件中使用模板字符串,例如:

  1. receivers:
  2. - name: 'slack-notifications'
  3. slack_configs:
  4. - channel: '#alerts'
  5. text: 'https://internal.myorg.net/wiki/alerts/{{ .GroupLabels.app }}/{{ .GroupLabels.alertname }}'

第二种方式,自定义可复用的模板文件。例如,可以创建自定义模板文件custom-template.tmpl,如下所示:

  1. {{ define "slack.myorg.text" }}https://internal.myorg.net/wiki/alerts/{{ .GroupLabels.app }}/{{ .GroupLabels.alertname }}{{ end}}

通过在Alertmanager的全局设置中定义templates配置来指定自定义模板的访问路径:

  1. # Files from which custom notification template definitions are read.
  2. # The last component may use a wildcard matcher, e.g. 'templates/*.tmpl'.
  3. templates:
  4. [ - <filepath> ... ]

在设置了自定义模板的访问路径后,用户则可以直接在配置中使用该模板:

  1. receivers:
  2. - name: 'slack-notifications'
  3. slack_configs:
  4. - channel: '#alerts'
  5. text: '{{ template "slack.myorg.text" . }}'
  6. templates:
  7. - '/etc/alertmanager/templates/myorg.tmpl'