发送告警

免责声明:Prometheus 会自动处理由其配置的告警规则生成的告警。强烈建议在 Prometheus 中基于时间序列数据配置告警规则,而不是直接实现客户端。

您可以通过 API v2 将告警发送到 Alertmanager。v2 的方案被指定为 OpenAPI 规范,可以在这里找到。API v1 在 Alertmanager 版本 0.16.0 中已被弃用,并在 Alertmanager 版本 0.27.0 中被移除。

客户端应持续重新发送告警,只要它们仍然处于活动状态(通常在 30 秒到 3 分钟的量级)。客户端可以通过 POST 请求将告警列表推送到 Alertmanager。

每个告警的标签用于识别告警的相同实例并执行去重。注解始终设置为最近收到的那些,并且不用于识别告警。

startsAtendsAt 时间戳都是可选的。如果省略 startsAt,Alertmanager 将分配当前时间。endsAt 仅在已知告警的结束时间时设置。否则,它将被设置为自上次收到告警起可配置的超时期限。

generatorURL 字段是一个唯一的反向链接,用于标识客户端中此告警的导致实体。

[
  {
    "labels": {
      "alertname": "<requiredAlertName>",
      "<labelname>": "<labelvalue>",
      ...
    },
    "annotations": {
      "<labelname>": "<labelvalue>",
    },
    "startsAt": "<rfc3339>",
    "endsAt": "<rfc3339>",
    "generatorURL": "<generator_url>"
  },
  ...
]

本文档是开源的。请通过提交 issue 或 pull request 帮助改进它。