发送告警

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