本篇文章次要介绍如何编写alertmanager的告警模板，应用这个告警模板，能够格式化咱们的告警信息，让告警内容更加易读和好看
prometheus 告警规定详解: https://www.dogfei.cn/archives/alertmanager-rule
prometheus 配置文件参考与介绍: https://www.dogfei.cn/archives/prometheus-config
告警模板
上篇文章介绍了对于告警规定的一些编写，在应用企业微信告警的时候，提到了告警模板，这里具体说下告警模板如何写。
首先，告警模板是基于go语言的模板来写的，具体可参考官网文档：https://golang.org/pkg/text/template/,这里列举一些罕用的写法，而后再去看上面的示例，就晓得什么意思了。
"."的用法
写过helm的肯定晓得这个'.',就是你定义了一个模板，当给这个模板传数据的时候，能够应用'.'来拜访获取对应的变量
{{ .Country.Name.Age }}这种就是通过链式拜访这个简单类型的数据。
模板变量
在模板中定义了变量后，在整个模板中都能应用，例如：
{{ $Name := "fei" }}hello {{ $Name }}define
{{ define "this.is.template" }}定义了一个名为"this.is.template"的模板
if/else语句
满足条件继续执行，不满足则去执行else，不满足条件能够是一些空值，或者false,例如false,0,nill,空字符串
{{ if .Name }} hello {{ .Name }}{{ else }}no one!!!{{ end }}这里就是判断Name是否有值，有就会输入hello {{ .Name }}，没有输入no one，完结用{{ end }}
多条件能够应用
{{ if .Name1 }}hello {{ .Name1 }}{{ else if .Name2 }}hello {{ .Name2 }}{{ else }}no one{{ end }}Range语法
模板里应用range来进行遍历数据，相似于jinja2模板语言中的for，例如：
假如数据结构为:
type Info struct { Name string Age int}而后模板写法如下：
{{ range .Info }}name: {{ .Name }}age: {{ .Age }}{{ end }}比拟
- eq 等于
- ne 不等于
- lt 小于
- le 小于等于
- gt 大于
- ge 大于等于
能够做判断比拟之类的
{{ if gt .Number1 .Number2 }}{{ .Number1 }}大于{{ .Number2 }}{{ end }}逻辑运算
- and 全都满足，返回
true - not 取反
- or 有一个为
true,即可返回true
做一些逻辑运算，比如说
{{ if and .Username .Passwd }}begin login{{ if gt (len .Passwd) 16 }}passwd valid{{ end }}{{ else }}login faild{{ end }}{{ if not .Authenticated }}access deny{{ end }}内置函数
- title: 将字符串转换为首字母大写
- toUpper: 所有字母转换成大写
- toLower: 所有字母转换成小写
- join: 拼接字符串
- safeHtml: 将字符串标记为不须要主动本义的html
- len: 获取长度
简略举例：
{{ "abcd" | toUpper }}{{ "ABCD" | toLower }}{{ .Values | join "," }}移除空格
写过ansible-playbook的肯定晓得，在应用jinja2写模板的时候，缩进、空格会让人很头疼，go语言的模板同样也是如此，也是应用-减号来做解决
{{- }} #去掉右边的空格{{ -}} #去掉左边的空格{{- -}} #去掉两边所有的空格数据结构介绍
.Receiver: 接收器的名称.Status: 如果正在告警，值为firing，复原为resolved.Alerts: 所有告警对象的列表，是一个列表，.Alerts.Firing: 告警列表.Alerts.Resolved: 复原列表.GroupLabels: 告警的分组标签.CommonLabels: 所有告警共有的标签.CommonAnnotations: 所有告警共有的注解.ExternalURL: 告警对应的alertmanager连贯地址具体能够看下报警进去的信息：
{ 'receiver': 'webhook', 'status': 'firing', 'alerts': [{ 'status': 'firing', 'labels': { 'alertname': '内存使用率', 'instance': '10.127.92.100', 'job': 'sentry', 'severity': 'warning', 'team': 'ops' }, 'annotations': { 'description': '内存使用率已超过55%，内存使用率：58%', 'summary': '内存使用率' }, 'startsAt': '2020-12-30T07:20:08.775177336Z', 'endsAt': '0001-01-01T00:00:00Z', 'generatorURL': 'http://prometheus-server:9090/graph?g0.expr=round%28%281+-+%28node_memory_MemAvailable_bytes%7Bjob%3D%22sentry%22%7D+%2F+%28node_memory_MemTotal_bytes%7Bjob%3D%22sentry%22%7D%29%29%29+%2A+100%29+%3E+55&g0.tab=1', 'fingerprint': '09f94bd1aa7da54f' }], 'groupLabels': { 'alertname': '内存使用率' }, 'commonLabels': { 'alertname': '内存使用率', 'job': 'sentry', 'severity': 'warning', 'team': 'ops' }, 'commonAnnotations': { 'summary': '内存使用率' }, 'externalURL': 'http://alertmanager-server:9093', 'version': '4', 'groupKey': '{}:{alertname="内存使用率"}', 'truncatedAlerts': 0}这么一看是不是就清晰了。
模板参考示例
上面看一下示例
官网模板参考：https://raw.githubusercontent.com/prometheus/alertmanager/master/template/default.tmpl
{{ define "wechat.default.message" }}{{- if gt (len .Alerts.Firing) 0 -}} // 判断报警列表的长度是否大于0，大于0阐明有报警，否则没有{{- range $index, $alert := .Alerts -}} // 遍历所有的告警列表，$index是索引，$alert是每一个报警元素==========异样告警==========告警类型: {{ $alert.Labels.alertname }}告警级别: {{ $alert.Labels.severity }}告警详情: {{ $alert.Annotations.description}};{{$alert.Annotations.summary}}故障工夫: {{ ($alert.StartsAt.Add 28800e9).Format "2006-01-02 15:04:05" }} // 调整为北京工夫{{- if gt (len $alert.Labels.instance) 0 }} // 判断下是否存在instance实例信息: {{ $alert.Labels.instance }}{{- end }}============END============{{- end }}{{- end }}{{- if gt (len .Alerts.Resolved) 0 -}} // 判断复原列表长度是否大于0，大于0阐明有复原信息，否则没有{{- range $index, $alert := .Alerts -}} //遍历复原列表==========异样复原==========告警类型: {{ $alert.Labels.alertname }}告警级别: {{ $alert.Labels.severity }}告警详情: {{ $alert.Annotations.description}};{{$alert.Annotations.summary}}故障工夫: {{ ($alert.StartsAt.Add 28800e9).Format "2006-01-02 15:04:05" }} #调整为北京工夫复原工夫: {{ ($alert.EndsAt.Add 28800e9).Format "2006-01-02 15:04:05" }} #调整为北京工夫{{- if gt (len $alert.Labels.instance) 0 }}实例信息: {{ $alert.Labels.instance }}{{- end }}============END============{{- end }}{{- end }}{{- end }}须要特地阐明下告警信息里的工夫是utc工夫，须要转换为北京工夫，也就是在utc工夫的根底上加8小时，也就是28800秒，也就是这里写的28800e9
基本上到这儿，咱们对如何编写告警信息模板有了一个很清晰的意识，上面看下如何配置到alertmanager里，其实之前的文章也说过了，上面再说下：
receivers:- name: 'wechat' wechat_configs: - send_resolved: true message: '{{ template "wechat.default.message" . }}' to_party: '接管告警的部门ID' agent_id: '利用ID' to_user: '用户ID' api_secret: '部门secret'wechat.default.message就是下面define的模板名称