客户端

Alertmanager 支持两个版本的 API，分别为 v1 和 v2，这两种 API 都可用于接收告警。v1 的方案（scheme）在下面的代码片段中进行了描述。v2 的方案被指定为一个 OpenAPI 规范，可以在 Alertmanager 的官方仓库中找到。

客户端需要持续不断地重新发送告警（通常每 30 秒到 3 分钟）。客户端可以通过 POST 请求向 Alertmanager 推送一组告警。每个告警的标签用于识别相同的告警实例，Alertmanager 对此会执行去重操作。注解（annotations）总是设置为最近接收到的数据，并且它们不会被用于标识告警。

startsAt和endsAt时间戳都是可选的。如果省略了startsAt，则由 Alertmanager 自动以当前时间赋值。endsAt只在知道告警结束时间时才会被设置，否则它会被设置为从最后一次接收告警的时间加上一个超时周期。

generatorURL字段是一个具有唯一性的回链（backlink），用于在客户端中标识触发此告警的实体。

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

该文档基于 Prometheus 官方文档翻译而成。