alertmanager设置告警邮件的邮件头/邮件模板

绝地灬酷狼 2022-08-31 15:15 382阅读 0赞

> 模板，让邮件更好看！
> 
> alertmanager对应告警消息的下发配置的较完善，官方给出的邮件配置几乎都是见名知义的，本文我们来看看告警邮件的邮件头部和邮件内容模板怎样自定义设置。

官方给出的可选配置如下：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hZWlhfOTk4Nw_size_16_color_FFFFFF_t_70][]

alert配置文件增加：

- name: rules3-CPU使用告警
      email_configs:
      - to: 'xxx@x.com'
        headers: { Subject: '平台告警通知：CPU使用告警'}
        html: '{
       { template "email.to.html" .}}'

headers表示设置的邮件头，html标签表示设置的自定义模板，其中email.to.html表示模板名称，为什么可以这么写？看看源码就知道了：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hZWlhfOTk4Nw_size_16_color_FFFFFF_t_70 1][]

位置：$GOPATH\\src\\alertmanager\\config\\notifiers.go

这里是取邮件的几个主要配置，代码中将读取的用户配置注入到了 c.Headers  中，拿html字段来说，可以看看DefaultEmailSubject 的定义：

// DefaultEmailSubject defines the default Subject header of an Email.
    	DefaultEmailSubject = `{
       { template "email.default.subject" . }}`

所以这就不难看出了，我们自定义的格式只需要和它保持一致就行了，然后自定义名称替换email.default.subject即可。如果想看看更多字段的用法也可以直接看源码中的测试用例：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hZWlhfOTk4Nw_size_16_color_FFFFFF_t_70 2][]

简单定义一个模板：

{
 { define "email.to.html" }}
 {
 { range .Alerts }} 
 告警通知！！！ 
 告警主题: {
 { .Annotations.explain }} 
 告警级别: {
 { .Labels.serverity }} 
 告警类型: {
 { .Annotations.Alert_type }}
 所在主机: {
 { .Labels.instance }} 
 告警信息: {
 { .Annotations.description }}{
 { .Annotations.console }} 
 触发时间: {
 { (.StartsAt.Add 28800e9).Format "2006-01-02 15:04:05" }} 
 {
 { end }}
 {
 { end }}

range表示遍历告警规则，如 .Labels.serverity取的就是rules.yml文件中告警规则定义的serverity字段的值。效果：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hZWlhfOTk4Nw_size_16_color_FFFFFF_t_70 3][]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hZWlhfOTk4Nw_size_16_color_FFFFFF_t_70]: /images/20220829/34b606ab16674bc1aa21bcca49554888.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hZWlhfOTk4Nw_size_16_color_FFFFFF_t_70 1]: /images/20220829/907a13bcb6b3442697e4ce504b55983b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hZWlhfOTk4Nw_size_16_color_FFFFFF_t_70 2]: /images/20220829/b1e6c762c5fa4b008e5c2d15ef5b8952.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0hZWlhfOTk4Nw_size_16_color_FFFFFF_t_70 3]: /images/20220829/3a00e7ba1d1c49bd98f2787aca4400ff.png