Prometheus Alertmanager 연동 - 모바일 알림

Echobell 채널 만들기

1. Echobell 앱을 엽니다
2. 새 채널을 만듭니다(예: "Prometheus Alerts")
3. 쉽게 구분할 수 있도록 색상을 선택합니다

알림 템플릿 구성하기

Alertmanager의 Webhook 페이로드에는 status, commonLabels, commonAnnotations, externalURL과 alerts 배열 같은 구조화된 필드가 들어 있습니다. Echobell 템플릿에서 이러한 필드를 직접 참조할 수 있습니다.

권장 템플릿은 다음과 같습니다.

제목 템플릿:

{{commonLabels.alertname}} - {{status}}

본문 템플릿:

🔔 Alert: {{commonLabels.alertname}}
📊 Severity: {{commonLabels.severity}}
🖥️ Instance: {{alerts[0].labels["instance"]}}
⏰ Starts: {{alerts[0].startsAt}}
ℹ️ Summary: {{commonAnnotations.summary}}
🧾 Description: {{commonAnnotations.description}}

선택 사항인 링크 템플릿(고급 설정):

{{alerts[0].generatorURL || externalURL}}

이렇게 하면 알림 기록 안에서 알림이 발생한 그래프나 대시보드로 바로 이동하는 링크가 표시됩니다. generatorURL이 없는 경우에는 externalURL이 대신 사용됩니다.

연동 방식 A — Webhook(권장)

1. Echobell 채널의 트리거 항목에서 Webhook URL을 복사합니다
2. Alertmanager에서 해당 URL로 요청을 보내는 웹훅 리시버를 추가합니다

최소한의 alertmanager.yml 예시:

route:
  receiver: echobell-webhook

receivers:
  - name: echobell-webhook
    webhook_configs:
      - url: "https://hook.echobell.one/t/<channel-token>"
        send_resolved: true
        http_config:
          follow_redirects: true

참고 사항:

• send_resolved: true로 설정하면 알림이 해제될 때(status가 resolved로 바뀔 때)도 알림을 보냅니다
• Echobell은 JSON 본문을 그대로 읽으므로 위 템플릿이 정상적으로 렌더링됩니다

연동 방식 B — 이메일(대안)

이메일 방식을 선호하거나 반드시 이메일을 사용해야 한다면, Alertmanager의 이메일 리시버를 사용해 채널에 연결된 이메일 주소로 보내세요.

1. Echobell의 트리거 섹션에서 채널의 이메일 주소를 복사합니다
2. Alertmanager에서 이메일 리시버를 구성하고 간단한 템플릿을 사용합니다

예시 설정:

receivers:
  - name: echobell-email
    email_configs:
      - to: "PASTE_CHANNEL_EMAIL_ADDRESS"
        send_resolved: true
        subject: "{{ .CommonLabels.alertname }} - {{ .Status }}"
        html: |
          <p><strong>Summary:</strong> {{ .CommonAnnotations.summary }}</p>
          <p>{{ .CommonAnnotations.description }}</p>
          <p>
            <a href='{{ (index .Alerts 0).GeneratorURL }}' target='_blank' rel='noopener'>Open in Prometheus</a>
          </p>

이메일 트리거용 Echobell 템플릿에서는 Echobell이 자동으로 제공하는 subject, text, html 같은 변수를 사용할 수 있습니다.

알림 규칙 예시 만들기

전체 흐름을 테스트해 볼 수 있는 간단한 규칙 예시입니다.

groups:
  - name: example
    rules:
      - alert: HighCPU
        expr: avg(rate(process_cpu_seconds_total[5m])) > 0.8
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "High CPU usage"
          description: "CPU has been over 80% for 2 minutes"

이 알림이 실행되면 Alertmanager가 설정된 리시버로 이벤트를 보내고, Echobell이 해당 채널의 구독자에게 알림을 전달합니다.