免责声明: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 帮助改进它。