免责声明:Prometheus 会自动处理由其配置的告警规则生成的告警。强烈建议在 Prometheus 中基于时间序列数据配置告警规则,而不是直接实现客户端。
您可以通过 API v2 将告警发送到 Alertmanager。v2 的方案被指定为 OpenAPI 规范,可以在这里找到。API v1 在 Alertmanager 版本 0.16.0 中已被弃用,并在 Alertmanager 版本 0.27.0 中被移除。
客户端应持续重新发送告警,只要它们仍然处于活动状态(通常在 30 秒到 3 分钟的量级)。客户端可以通过 POST 请求将告警列表推送到 Alertmanager。
每个告警的标签用于识别告警的相同实例并执行去重。注解始终设置为最近收到的那些,并且不用于识别告警。
startsAt
和 endsAt
时间戳都是可选的。如果省略 startsAt
,Alertmanager 将分配当前时间。endsAt
仅在已知告警的结束时间时设置。否则,它将被设置为自上次收到告警起可配置的超时期限。
generatorURL
字段是一个唯一的反向链接,用于标识客户端中此告警的导致实体。
[
{
"labels": {
"alertname": "<requiredAlertName>",
"<labelname>": "<labelvalue>",
...
},
"annotations": {
"<labelname>": "<labelvalue>",
},
"startsAt": "<rfc3339>",
"endsAt": "<rfc3339>",
"generatorURL": "<generator_url>"
},
...
]
本文档是开源的。请通过提交 issue 或 pull request 帮助改进它。