Grafana告警（邮件）自定义模板配置

qxyywy2024-04-12 10:28

一年前给客户部署配置过grafana，告警配置也是用的原始的，客户在使用过程中只需要一些核心点信息，想要实现这个就需要用Grafana的自定义告警模板以及编辑邮件模板。

通知模板

模板信息的配置中查阅了相关资料，自己组装了一套，主要用于邮件标题，想要实现的效果如："服务器: ***， ****， 内存使用率超过**告警"，告警事项这儿用alertname直接固定 比如配置的是内存超过90阈值就发邮件，那就把alertname设置成"内存使用率超过90告警"即可。重点是获取异常的服务器信息。

查阅相关资料后，编写代码如下：

Go 复制代码 
{{ define "email.message" }}
{{- if gt (len .Alerts.Firing) 0 -}}
  服务器:{{ range $i, $alert := .Alerts.Firing }}
      {{ index $alert.Labels "instance" }}，
    {{ end }}
    {{ range $i, $alert := .Alerts.Firing }}
      {{if eq $i 0 }}
        {{ index $alert.Labels "alertname" }}
      {{end}}
    {{ end }}
{{- end }}
{{- if gt (len .Alerts.Resolved) 0 -}}
  服务器:{{ range $i, $alert := .Alerts.Resolved }}
      {{ index $alert.Labels "instance" }}，
    {{ end }}
    {{ range $i, $alert := .Alerts.Resolved }}
      {{if eq $i 0 }}
        {{ index $alert.Labels "alertname" }}
      {{end}}
    {{ end }}
{{- end }}
{{ end }}

在Contact points->Optional Email settings->Subject配置自定义模板名称

代码编写完成后在旧版（9.1）上一直不行，后来grafana官方资料发现，告警规则中的查询表达式若是用的经典模式（Classic condition）在不能使用"$alert.Labels "instance""获取服务器信息，变更告警规则为Reduce，发现可以收取到正确格式的相关邮件标题，然后进入下一步更改 邮件模板

邮件模板

邮件模板主要是根据客户需要展示具体事项、服务器和事项的当前值即可。

找到grafana的安装目录（默认：C:\Program Files\GrafanaLabs\grafana\public\emails\)，打开

ng_alert_notification.html文件 按照要求注释更改部分html代码即可。部分代码片段如下：

html 复制代码 
 {{ range .Labels.SortedPairs }}
  <tr style="vertical-align: top; padding: 0;" align="left">
    <td colspan="2" class="value" style="word-break: break-word; -webkit-hyphens: auto; -moz-hyphens: auto; hyphens: auto; border-collapse: collapse !important; color: #222222; font-family: 'Open Sans', 'Helvetica Neue', 'Helvetica', Helvetica, Arial, sans-serif; font-weight: normal; line-height: 19px; font-size: 14px; -webkit-font-smoothing: antialiased; -webkit-text-size-adjust: none; margin: 0; padding: 24px 0 0;" align="left" valign="top">
      {{if eq .Name "instance" }}
      <span class="value-heading" style="font-weight: bold;">服务器:</span> <span class="value-value" style="padding-left: 8px;">{{ .Value }}</span>
      {{else if eq .Name "alertname" }}
      <span class="value-heading" style="font-weight: bold;">事项:</span> <span class="value-value" style="padding-left: 8px;">{{ .Value }}</span>
      {{else}}

      {{end}}
    </td>
  </tr>
  {{ end }}
  {{ if gt (len .Annotations.SortedPairs) 0 }}
      <tr style="vertical-align: top; padding: 0;" align="left">
        <td colspan="2" class="annotations" style="word-break: break-word; -webkit-hyphens: auto; -moz-hyphens: auto; hyphens: auto; border-collapse: collapse !important; color: #222222; font-family: 'Open Sans', 'Helvetica Neue', 'Helvetica', Helvetica, Arial, sans-serif; font-weight: normal; line-height: 19px; font-size: 14px; -webkit-font-smoothing: antialiased; -webkit-text-size-adjust: none; margin: 0; padding: 24px 0 12px;" align="left" valign="top">
          {{ range .Annotations.SortedPairs }}
            {{if eq .Name "description" }}
            <p style="color: #222222; font-family: 'Open Sans', 'Helvetica Neue', 'Helvetica', Helvetica, Arial, sans-serif; font-weight: normal; line-height: 19px; font-size: 14px; -webkit-font-smoothing: antialiased; -webkit-text-size-adjust: none; margin: 0 0 10px; padding: 0;" align="left"><span class="annotations-heading" style="font-weight: bold; text-transform: capitalize;">当前值:</span> <span class="annotations-value" style="padding-left: 8px;">{{ .Value }}</span></p>
            {{end}}
          {{ end }}
        </td>
      </tr>
  {{ end }}

此处针对当前值，9.1版本里的{{ .ValueString }}是一个字符串，本人对go语言不熟以及对对照官方给出的方法在这个模板html里无法解析出服务器信息，所以在告警里的annotations的Description里获取了当前值，代码用"{{ printf "%.2f" $values.B.Value }}"（当前值保留2位小数）。

收取的邮件效果如下

重新在告警规则中的查询表达式中对表达式B使用Reduce，表达式C使用Classic condition配置阈值，发现邮件未按阈值进行邮件发送，且annotations的Description里的表达式也获取不到正确的值。查询官方资料( 具体链接：template-notifications/reference)，发现最新版里有一个Values是KV，应该是可以解析出服务器信息和对应的value值。

下载安装完最新版（10.4.1），在配置告警时发现和9.1有明细的变化，
直接配置完相关信息，发送邮件可以实现按阈值进行邮件发送，满足客户需要。后面再对新版本的邮件模板html进行改造

部分代码片段如下：

html 复制代码 
{{ __dangerouslyInjectHTML `<!--[if mso | IE]><table role="presentation" border="0" cellpadding="0" cellspacing="0"><tr><td class="" style="vertical-align:top;width:600px;" ><![endif]-->` }}
	<div class="mj-column-per-100 mj-outlook-group-fix" style="font-size:0px;text-align:left;direction:ltr;display:inline-block;vertical-align:top;width:100%;">
	  <table border="0" cellpadding="0" cellspacing="0" role="presentation" style="vertical-align:top;" width="100%">
		<tbody>
		  {{ if .Labels.SortedPairs }}
		  <!--<tr>
			<td align="left" class="txt" style="font-size:0px;padding:10px 25px;word-break:break-word;">
			  <div style="font-family: Inter, Helvetica, Arial; font-size: 13px; line-height: 150%; text-align: left; color: #000000;"><strong>Labels</strong></div>
			</td>
		  </tr>-->
		  <tr>
			<td align="left" class="txt" style="font-size:0px;padding:10px 25px;word-break:break-word;">
			  <table cellpadding="0" cellspacing="0" width="100%" border="0" style="color:#000000;font-family:Inter, Helvetica, Arial;font-size:13px;line-height:22px;table-layout:auto;width:100%;border:none;">
				<mj-raw>{{ range .Labels.SortedPairs }}</mj-raw>
				{{if eq .Name "instance" }}
				<tr>
				  <td>
					<strong>服务器</strong>
				  </td>
				  <td>{{ .Value }}</td>
				</tr>
				{{else if eq .Name "alertname" }}
				 <tr>
				  <td>
					<strong>事项</strong>
				  </td>
				  <td>{{ .Value }}</td>
				</tr>
				{{ else }}
				{{ end }}
				<mj-raw>{{ end }}</mj-raw>
				
				<mj-raw>{{ range $refID, $value := .Values }}</mj-raw>
				{{ if eq $refID "B" }}
				<tr>
				  <td>
					<strong>当前值</strong>
				  </td>
				  <td>{{ printf "%.2f" $value }}</td>
				</tr>
				{{ end }}
				<mj-raw>{{ end }}</mj-raw>
			  </table>
			</td>
		  </tr>
		  {{ end }}{{ if (without .Annotations.SortedPairs.Names "description" "summary") }}
		  <tr>
			<td align="left" class="txt" style="font-size:0px;padding:10px 25px;word-break:break-word;">
			  <div style="font-family: Inter, Helvetica, Arial; font-size: 13px; line-height: 150%; text-align: left; color: #000000;"><strong>Annotations</strong></div>
			</td>
		  </tr>
		  <tr>
			<td align="left" class="txt" style="font-size:0px;padding:10px 25px;word-break:break-word;">
			  <table cellpadding="0" cellspacing="0" width="100%" border="0" style="color:#000000;font-family:Inter, Helvetica, Arial;font-size:13px;line-height:22px;table-layout:auto;width:100%;border:none;">
				<mj-raw>{{ range .Annotations.SortedPairs }}</mj-raw>
				<mj-raw>{{ if and (ne .Name "description") (ne .Name "summary") }}</mj-raw>
				<tr>
				  <td>
					<strong>{{ .Name }}</strong>
				  </td>
				  <td>{{ .Value }}</td>
				</tr>
				<mj-raw>{{ end }}</mj-raw>
				<mj-raw>{{ end }}</mj-raw>
			  </table>
			</td>
		  </tr>
		  {{ end }}
		</tbody>
	  </table>
	</div>
{{ __dangerouslyInjectHTML `<!--[if mso | IE]></td></tr></table><![endif]-->` }}

邮件收取效果如图：

另外关于邮件里跳转链接的配置，在grafana的安装路径的grafana\conf下，打开defaults.ini文件找到"[server]",编辑 domain = 192.168.**.**，这样就可以从邮件里直接跳转到相关的grafana页面。

相关推荐
不会玩技术的技术girl3 小时前
AI 自动化编程的现状与局限
运维·人工智能·自动化
严不鸽4 小时前
Docker 常用总结
运维·docker·容器
小冯的编程学习之路4 小时前
【Linux】：Linux网络协议
linux·运维·网络协议
Just_Do_IT_OK4 小时前
Docker--Apollo-configservice
运维·docker·容器
dalongxia20245 小时前
数据中台从centos升级为国产操作系统后，资源增加字段时，提交报500错误
linux·运维·centos
木子欢儿6 小时前
debian12安装docker
运维·docker·云原生·容器·eureka
fengxingzhe0086 小时前
OSPFv2协议状态切换（状态机）基本原理-RFC2328
运维·网络·网络协议·面试·ospfv2·ospfv2协议状态机·ospfv2报文交互实例
恩爸编程6 小时前
Linux 定时任务：轻松创建与精准执行
linux·运维·数据库·linux定时任务·linux定时任务创建·linux定时任务执行·linux定时任务是什么
web182859970896 小时前
深入解析 Tengine：高性能 Web 服务器与反向代理的企业级应用
运维·服务器·前端
果粒陈爱写代码6 小时前
Linux day 1130
linux·运维·服务器
热门推荐
01docker安装启动问题解决排查02【一文读懂】NTN（非地面网络）技术介绍03HCIA-datacom数通题库和录播视频资料04【漏洞复现】CVE-2015-3337 Arbitrary File Reading05RAG 实践- Ollama+RagFlow 部署本地知识库06玄机平台应急响应—webshell查杀07AI 绘画Stable Diffusion 研究（十四）SD 图生图+剪映制作人物说话视频08Gitlab ci/cd09支付宝短视频平台创作分成激励项目10C语言日常刷题 2