---
title: Prometheus Alertmanager Integration - Server- und Infrastruktur-Monitoring-Benachrichtigungen
sidebarTitle: Prometheus
description: 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.
---

import { Step, Steps } from "fumadocs-ui/components/steps";

# 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

<Steps>
<Step>
### Echobell-Kanal erstellen

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

### 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}}
```

</Step>
<Step>
### Methode A — Webhook (empfohlen)

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

```yaml
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.

</Step>
<Step>
### 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:

```yaml
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>
```

</Step>
<Step>
### Beispiel-Alarmregel erstellen

```yaml
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.

</Step>
</Steps>

## 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

- [Prometheus Dokumentation](https://prometheus.io/docs/introduction/overview/)
- [Alertmanager Konfiguration](https://prometheus.io/docs/alerting/latest/configuration/)
- [Echobell Webhook](/de/docs/webhook)
- [Benachrichtigungsvorlagen](/de/docs/notification)
