Prometheus学习系列（四十）之报警模板参考

Prometheus建立并向Alertmanager发送警报，而后Alertmanager根据标签向不一样的接收者发送通知。 接收器能够是众多集成中的一种，包括：Slack，PagerDuty，电子邮件或经过通用webhook接口的自定义集成。

发送给接收者的通知是经过模板构建的。 Alertmanager附带默认模板，但也能够自定义。 为避免混淆，请务必注意Alertmanager模板与Prometheus中的模板不一样，但Prometheus模板还包括警报规则标签/注释中的模板。

Alertmanager的通知模板基于Go模板系统。 请注意，某些字段将做为文本进行评估，而其余字段将做为HTML进行评估，这将影响转义。

1、数据

Data是传递给通知模板和webhook推送的结构。

Name	Type	Notes
Receiver	string	定义通知将被发送到的接收者名称（松弛，电子邮件等）。
Status	string	若是至少有一个警报被触发，则定义为触发，不然解析。
Alerts	Alert	警报对象列表（见下文）。
GroupLabels	KV	这些警报的标签按分组。
CommonLabels	KV	全部警报共有的标签。
CommonAnnotations	KV	全部警报的经常使用注释集。 用于有关警报的更长的其余信息串。
ExternalURL	string	反向连接到发送通知的Alertmanager。

2、警报

Alert为通知模板保留一个警报。

Name	Type	Notes
Status	string	定义警报是已解决仍是当前正在触发。
Labels	KV	要附加到警报的一组标签。
Annotations	KV	警报的一组注释。
StartsAt	time.Time	警报开始发射的时间。 若是省略，则当前时间由Alertmanager分配。
EndsAt	time.Time	仅在已知警报结束时间时设置。 不然设置为自上次收到警报以来的可配置超时时间。
GeneratorURL	string	一个反向连接，用于标识此警报的生成实体。

3、KV

KV是一组用于表示标签和注释的键/值字符串对。

type KV map[string]string
复制代码

包含两个注释的注释示例：

{
  summary: "alert summary",
  description: "alert description",
}
复制代码

除了直接访问存储为KV的数据（标签和注释）以外，还有用于排序，删除和查看LabelSet的方法：

KV方法

Name	Arguments	Returns	Notes
SortedPairs	-	Pairs (list of key/value string pairs.)	返回键/值对的排序列表。
Remove	[]string	KV	返回没有给定键的键/值映射的副本。
Names	-	[]string	返回LabelSet中标签名称的名称。
Values	-	[]string	返回LabelSet中的值列表。

4、函数

请注意Go模板也提供的默认函数。

Name	Arguments	Returns
title	string	strings.Title, 大写每一个单词的第一个字符。
toUpper	string	strings.ToUpper, 将全部字符转换为大写。
toLower	string	strings.ToLower, 将全部字符转换为小写。
match	pattern, string	Regexp.MatchString. 使用Regex匹配字符串。
reReplaceAll	pattern, replacement, text	Regexp.ReplaceAllString Regexp替换，未经修复。
join	sep string, s []string	strings.Join, 链接s的元素以建立单个字符串。 分隔符字符串sep放在结果字符串中的元素之间。 （注意：参数顺序已反转，以便在模板中更容易管道化。）
safeHtml	text string	html/template.HTML, 将字符串标记为不须要自动转义的HTML。

5、连接

Prometheus官网地址：prometheus.io/ 个人Github：github.com/Alrights/pr…