MQTT 알림 설정

MQTT 알림 설정 (Configure MQTT notifications)

연락처 포인트의 MQTT 통합을 사용해 MQTT 브로커로 알림을 보낼 수 있어요. 브로커 URL, 토픽, 메시지 형식(JSON/텍스트)을 구성해 알림 페이로드를 제어합니다.

출처: 문서

본문

연락처 포인트의 MQTT 통합을 사용해 MQTT 브로커로 알림을 보낼 수 있어요.

연락처 포인트용 MQTT 구성

1. Alerts & IRM → Alerting → Notification configuration 으로 이동한 다음 Contact points 탭을 선택합니다.
2. + Add contact point 를 클릭합니다.
3. 연락처 포인트 이름을 입력합니다.
4. Integration 목록에서 MQTT 를 선택합니다.
5. Broker URL 필드에 브로커 URL을 입력합니다. tcp, ssl, mqtt, mqtts, ws, wss 스킴을 지원합니다. 예: tcp://127.0.0.1:1883
6. Topic 필드에 MQTT 토픽 이름을 입력합니다.
7. (선택) 추가 설정 구성.
8. Save contact point 를 클릭합니다.

연락처 포인트 테스트와 알림 활성화 방법 등 자세한 내용은 Configure contact points 문서를 참고하세요.

필수 설정 (Required Settings)

선택 설정 (Optional Settings)

기본 JSON 페이로드 (Default JSON payload)

Message format 옵션이 json(기본)이면 페이로드는 다음과 같은 예시입니다:

{
  "receiver": "My MQTT integration",
  "status": "firing",
  "orgId": 1,
  "alerts": [
    {
      "status": "firing",
      "labels": {
        "alertname": "High memory usage",
        "team": "blue",
        "zone": "us-1"
      },
      "annotations": {
        "description": "The system has high memory usage",
        "runbook_url": "https://myrunbook.com/runbook/1234",
        "summary": "This alert was triggered for zone us-1"
      },
      "startsAt": "2021-10-12T09:51:03.157076+02:00",
      "endsAt": "0001-01-01T00:00:00Z",
      "generatorURL": "https://play.grafana.org/alerting/1afz29v7z/edit",
      "fingerprint": "c6eadffa33fcdf37",
      "silenceURL": "https://play.grafana.org/alerting/silence/new?alertmanager=grafana&matchers=alertname%3DT2%2Cteam%3Dblue%2Czone%3Dus-1",
      "dashboardURL": "",
      "panelURL": "",
      "values": {
        "B": 44.23943737541908,
        "C": 1
      }
    },
    {
      "status": "firing",
      "labels": {
        "alertname": "High CPU usage",
        "team": "blue",
        "zone": "eu-1"
      },
      "annotations": {
        "description": "The system has high CPU usage",
        "runbook_url": "https://myrunbook.com/runbook/1234",
        "summary": "This alert was triggered for zone eu-1"
      },
      "startsAt": "2021-10-12T09:56:03.157076+02:00",
      "endsAt": "0001-01-01T00:00:00Z",
      "generatorURL": "https://play.grafana.org/alerting/d1rdpdv7k/edit",
      "fingerprint": "bc97ff14869b13e3",
      "silenceURL": "https://play.grafana.org/alerting/silence/new?alertmanager=grafana&matchers=alertname%3DT1%2Cteam%3Dblue%2Czone%3Deu-1",
      "dashboardURL": "",
      "panelURL": "",
      "values": {
        "B": 44.23943737541908,
        "C": 1
      }
    }
  ],
  "groupLabels": {},
  "commonLabels": {
    "team": "blue"
  },
  "commonAnnotations": {},
  "externalURL": "https://play.grafana.org/",
  "version": "1",
  "groupKey": "{}:{}",
  "message": "**Firing**\n\nLabels:\n - alertname = T2\n - team = blue\n - zone = us-1\nAnnotations:\n - description = This is the alert rule checking the second system\n - runbook_url = https://myrunbook.com\n - summary = This is my summary\nSource: https://play.grafana.org/alerting/1afz29v7z/edit\nSilence: https://play.grafana.org/alerting/silence/new?alertmanager=grafana&matchers=alertname%3DT2%2Cteam%3Dblue%2Czone%3Dus-1\n\nLabels:\n - alertname = T1\n - team = blue\n - zone = eu-1\nAnnotations:\nSource: https://play.grafana.org/alerting/d1rdpdv7k/edit\nSilence: https://play.grafana.org/alerting/silence/new?alertmanager=grafana&matchers=alertname%3DT1%2Cteam%3Dblue%2Czone%3Deu-1\n"
}

Body: Message format이 json(기본)이면 페이로드는 다음 필드를 포함합니다.

참고: json Message format을 사용할 때 JSON 페이로드의 message 필드만 커스터마이즈 가능하며 출력은 문자열로 포맷됩니다. 전체 페이로드를 텍스트나 JSON 형식으로 커스터마이즈하려면 text 형식과 커스텀 페이로드를 사용하세요.

Alert 객체: 알림 그룹에 포함된 알림을 나타냅니다.

커스텀 페이로드 (Custom payload)

Message format 옵션을 text 로 설정하면 MQTT 메시지의 전체 페이로드를 커스터마이즈할 수 있어요. 이 모드에서는 Message 옵션이 전체 페이로드를 정의합니다. 알림 템플릿을 지원하며 평문, JSON, 또는 커스텀 형식으로 알림 메시지를 생성할 수 있어요. 평문이나 JSON 메시지를 만드는 템플릿 예시는 알림 템플릿 예시 문서를 참고하세요.

더 알아보기 (Learn more)

• 출처 문서: Configure MQTT notifications
• 연락처 포인트 구성
• 알림 템플릿
• Grafana Alerting 문서 홈