Echobell

Prometheus Alertmanager Integration - Server- und Infrastruktur-Monitoring-Benachrichtigungen

Vollständiger Leitfaden zur Integration von Prometheus Alertmanager mit Echobell für sofortige mobile Benachrichtigungen. Empfangen Sie Push-Benachrichtigungen für Server-Monitoring, Infrastruktur-Warnungen, CPU/Speicher-Nutzung und kritische Systemereignisse per Webhook oder E-Mail.

Prometheus-Integration

Prometheus mit Alertmanager ist ein weit verbreiteter Open-Source-Monitoring- und Alerting-Stack. Durch die Integration des Alertmanagers mit Echobell erhalten Sie sofortige mobile Benachrichtigungen (inklusive zeitkritischer oder Anruf-Benachrichtigungen), sobald Ihre Alarmregeln auslösen.

Voraussetzungen

  • Ein Echobell-Konto mit mindestens einem angelegten Kanal
  • Eine laufende Prometheus- + Alertmanager-Installation
  • Zugriff auf die Bearbeitung der Alertmanager-Konfiguration (alertmanager.yml)

Überblick

  1. Echobell-Kanal erstellen
  2. Benachrichtigungsvorlagen konfigurieren
  3. Integrationsmethode wählen (Webhook oder E-Mail)
  4. Alarmregeln anlegen oder aktualisieren
  5. Testen und verfeinern

Schritt-für-Schritt

Echobell-Kanal erstellen

  1. Echobell-App öffnen
  2. Neuen Kanal erstellen (z. B. „Prometheus Alerts")
  3. Eine Farbe zur besseren Erkennung wählen

Vorlagen konfigurieren

Die Webhook-Nutzlast des Alertmanagers enthält strukturierte Felder wie status, commonLabels, commonAnnotations, externalURL sowie ein alerts-Array.

Titelvorlage:

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

Textvorlage:

🔔 Alarm: {{commonLabels.alertname}}
📊 Schweregrad: {{commonLabels.severity}}
🖥️ Instance: {{alerts[0].labels["instance"]}}
⏰ Start: {{alerts[0].startsAt}}
ℹ️ Zusammenfassung: {{commonAnnotations.summary}}

Optionale Link-Vorlage (Erweitert):

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

Methode A — Webhook (empfohlen)

  1. Im Echobell-Kanal die Webhook-URL aus „Triggers" kopieren
  2. Im Alertmanager einen Webhook-Receiver konfigurieren:
route:
  receiver: echobell-webhook

receivers:
  - name: echobell-webhook
    webhook_configs:
      - url: "https://hook.echobell.one/t/REPLACE_WITH_YOUR_TOKEN"
        send_resolved: true
        http_config:
          follow_redirects: true

Hinweis: send_resolved: true benachrichtigt auch, wenn Alarme wieder „resolved" sind.

Methode B — E-Mail (Alternative)

Falls E-Mail bevorzugt wird, nutzen Sie den E-Mail-Receiver des Alertmanagers:

  1. In Echobell die Kanal-E-Mail aus „Triggers" kopieren
  2. Im Alertmanager einen E-Mail-Receiver konfigurieren:
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>

Beispiel-Alarmregel erstellen

groups:
  - name: example
    rules:
      - alert: HighCPU
        expr: avg(rate(process_cpu_seconds_total[5m])) > 0.8
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "Hohe CPU-Auslastung"
          description: "CPU war 2 Minuten lang über 80%"

Sobald dieser Alarm auslöst, sendet Alertmanager das Event an Echobell.

Benachrichtigungstypen

  • Zeitkritisch: Kritische Produktionsausfälle, Paging-Level Incidents
  • Anruf: Schwere Ausfälle, bei denen Fokus-Modi unterbrochen werden müssen
  • Normal: Routine-Alarme, Warnungen oder informative Meldungen

Best Practices

  1. Vorlagen kurz aber informativ halten
  2. Link-Vorlage nutzen für direkten Zugang zum Graph/Dashboard
  3. Alarme im Alertmanager gruppieren und routen
  4. Webhook-URL wie ein Geheimnis behandeln

Fehlerbehebung

Falls Alarme nicht in Echobell erscheinen:

  • Webhook-URL oder Kanal-E-Mail prüfen
  • Sicherstellen, dass der Kanal aktiv ist und Abonnenten hat
  • Alertmanager-Logs auf Zustellungsfehler prüfen
  • Route in alertmanager.yml verifizieren

Zusätzliche Ressourcen

Inhaltsverzeichnis