完整译文请访问:http://www.coderdocument.com/docs/prometheus/v2.14/alerting/sending_alerts.html。
免责声明:Prometheus自动负责发送由其配置的告警规则生成的告警。强烈建议在Prometheus中基于时间序列数据配置告警规则,而不是实现一个直接的客户端。
Alertmanager有两个版本的API, v1和v2,都监听告警。下面的代码片段描述了v1的方案。v2的方案(schema)可以在Alertmanager仓库中找到OpenAPI规范。只要客户端仍然处于活动状态(通常为30秒到3分钟),就可以不断地重新发送告警。客户端可以通过POST请求将告警列表推送给Alertmanager。
每个告警的标签用于标识告警的相同实例并执行重复数据删除。注解(annotation)总是设置至那些最近收到的告警,并且并不会用于标识告警。
startsAt
和endsAt
时间戳都是可选的。如果省略startsAt
,则当前时间由Alertmanager分配。只有在告警结束时间已知的情况下才设置endsAt
。否则,它将被设置为自上次收到告警以来的可配置超时时间。
generatorURL
字段是一个惟一的反向链接,它标识客户端中此告警的引发实体。
[
{
"labels": {
"alertname": "<requiredAlertName>",
"<labelname>": "<labelvalue>",
...
},
"annotations": {
"<labelname>": "<labelvalue>",
},
"startsAt": "<rfc3339>",
"endsAt": "<rfc3339>",
"generatorURL": "<generator_url>"
},
...
]
完整译文请访问:http://www.coderdocument.com/docs/prometheus/v2.14/alerting/sending_alerts.html。