Prometheus 문서/경보/클라이언트

1 개요

SENDING ALERTS

경보 보내기

면책조항 : Prometheus는 구성된 경보 규칙에 따라 생성된 경보 전송을 자동으로 처리합니다. 직접 클라이언트를 구현하는 것보다 시계열 데이터를 기반으로 Prometheus에서 경보 규칙을 구성하는 것이 좋습니다.

Alertmanager에는 v1과 v2라는 두 가지 API가 있으며 둘 다 경고를 수신합니다. v1의 구성표는 아래 코드에 설명되어 있습니다. v2의 구성표는 Alertmanager 리포지토리에서 찾을 수 있는 OpenAPI 사양으로 지정됩니다. 클라이언트는 활성 상태인 한 계속해서 경고를 다시 보내야 합니다(보통 30초~3분 정도). 클라이언트는 POST 요청을 통해 Alertmanager에 경보 목록을 푸시할 수 있습니다.

각 경보의 레이블은 경보의 동일한 인스턴스를 식별하고 중복 제거를 수행하는 데 사용됩니다. 어노테이션은 항상 가장 최근에 받은 어노테이션으로 세팅되며 경보를 식별하지 않습니다.

startsAt과 endAt 타임스탬프는 모두 선택사항입니다. startsAt이 생략되면, Alertmanager가 현재 시간을 할당합니다. endsAt은 경보의 종료시간을 알고 있는 경우에만 세팅됩니다. 그렇지 않으면 경보가 마지막으로 수신된 이후부터 설정가능한 타임아웃 기간으로 세팅됩니다.

이 generatorURL 필드는 클라이언트에서 이 경보의 원인 엔티티를 식별하는 고유한 백링크입니다.

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

2 참고

• https://prometheus.io/docs/alerting/latest/clients/