Integracja z Prometheus Alertmanager - alerty na telefon

Utwórz kanał Echobell

1. Otwórz aplikację Echobell
2. Utwórz nowy kanał (np. „Prometheus Alerts”)
3. Wybierz kolor ułatwiający rozpoznanie

Skonfiguruj szablony powiadomień

Payload webhooka Alertmanagera zawiera uporządkowane pola, takie jak status, commonLabels, commonAnnotations, externalURL oraz tablicę alerts. Do tych pól możesz odwoływać się bezpośrednio w szablonach Echobell.

Proponowane szablony:

Szablon tytułu:

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

Szablon treści:

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

Opcjonalny szablon odnośnika (Ustawienia zaawansowane):

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

Dzięki temu w rekordzie alertu pojawi się bezpośredni odnośnik do wykresu lub pulpitu z aktywnym alertem. Jeśli generatorURL nie występuje, użyty zostanie externalURL.

Metoda integracji A — webhook (zalecana)

1. W swoim kanale Echobell skopiuj adres URL webhooka z sekcji wyzwalaczy
2. W Alertmanagerze dodaj odbiorcę webhook, który wysyła żądania pod ten adres

Minimalny przykład 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

Uwagi:

• send_resolved: true powoduje powiadomienie także wtedy, gdy alert zostanie rozwiązany (status zmienia się na resolved)
• Echobell odczytuje treść JSON w niezmienionej postaci, więc powyższe szablony wyrenderują się poprawnie

Metoda integracji B — e-mail (alternatywa)

Jeśli wolisz lub musisz korzystać z poczty, użyj odbiorcy email w Alertmanagerze i wysyłaj wiadomości na adres e-mail powiązany z kanałem.

1. W Echobell skopiuj adres e-mail kanału z sekcji wyzwalaczy
2. Skonfiguruj odbiorcę email w Alertmanagerze i użyj prostych szablonów

Przykładowy fragment:

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>

W szablonach Echobell dla wyzwalaczy e-mail możesz korzystać ze zmiennych takich jak subject, text i html, które Echobell udostępnia automatycznie.

Utwórz przykładową regułę alertu

Oto niewielka przykładowa reguła do przetestowania całego przepływu:

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"

Gdy ten alert zadziała, Alertmanager wyśle zdarzenie do skonfigurowanego odbiorcy, a Echobell powiadomi subskrybentów kanału.