eplamat Runbooks

Alertmanager konnte Config nicht neu laden

Alert: AlertmanagerConfigReloadFailed
Warning Config-Syntax-Fehler
📝
Niedriges Risiko. Alertmanager läuft mit alter Config weiter — neue Routing-Regeln / Telegram-Template-Änderungen sind nicht aktiv. Container-Restart würde Crashloop auslösen.

❓Was bedeutet das?

Letztes curl /-/reload auf Alertmanager hat fehlgeschlagen — Parsing der neuen alertmanager.yml oder eines Templates failed.

Typische Ursache: Template-Syntax-Fehler ({{ ... }}), kaputte YAML-Einrückung, oder ein Receiver, der nicht referenziert werden kann.

⚠️Wie schlimm ist es?

Niedrig solange der Container nicht restartet. Beim nächsten docker compose up -d (z.B. via Image-Update Mi 04:00) bootstrappt er mit der kaputten Config und gibt Crashloop. Vor Mittwoch fixen.

🔧Was tun?

  1. Fehler in den Logs: 
    docker logs --tail 50 alertmanager 2>&1 | grep -iE "error|invalid|failed"
  2. Config validieren: 
    docker exec alertmanager amtool check-config /etc/alertmanager/alertmanager.yml
    Zeigt YAML- und Template-Fehler.
  3. Fix die Datei (alertmanager/conf/alertmanager.yml).
  4. WICHTIG: Force-recreate statt Reload nach Edit (Bind-Mount-Inode-Gotcha): 
    cd /srv/eplamat && docker compose up -d --force-recreate alertmanager
  5. Active Config zur Verifikation: 
    curl -s http://localhost:9093/api/v2/status | python3 -m json.tool | head -50

🆘Wenn das nicht klappt

Kopier den Alert + Log-Fehler in Claude. Alertmanager-Templates sind Go-Template-Syntax — kleine Fehler wie {{ if .X }} ohne {{ end }} sind häufig.