eplamat Runbooks

Prometheus konnte Config nicht neu laden

Alert: PrometheusConfigReloadFailed
Warning Config-Syntax-Fehler
📝
Niedriges Risiko. Prometheus läuft weiter mit der alten Config — die neue Config wird ignoriert. Wenn der Container restartet, schlägt aber der Start fehl.

❓Was bedeutet das?

Jemand (du, ein Script, oder ein Tool) hat curl /-/reload auf Prometheus aufgerufen, aber das Parsing der neuen Config (oder einer Rule-Datei) ist fehlgeschlagen. Prometheus behält die bisher gültige Config im Speicher.

Beim nächsten Container-Restart wird die kaputte Config geladen → Start crasht → Crashloop.

⚠️Wie schlimm ist es?

Niedrig solange Prometheus nicht restartet. Aber: der nächste Image-Update (Mittwoch 04:00) wird Prometheus restarten und dann ist Monitoring tot. Vor Mittwoch fixen.

🔧Was tun?

  1. Fehlermeldung finden: 
    docker logs --tail 50 prometheus 2>&1 | grep -iE "error|invalid|failed"
    Meist eine YAML-Syntax-Stelle in einer Rule-Datei oder prometheus.yml.
  2. Config validieren — vor Reload: 
    docker exec prometheus promtool check config /etc/prometheus/prometheus.yml
docker exec prometheus promtool check rules /etc/prometheus/rules/*.yml
  3. Fix die kaputte Datei (meist eine fehlende : oder falsche Einrückung).
  4. Reload erneut: 
    curl -sf -XPOST http://localhost:9090/-/reload && echo "OK"
    Wenn weiter Fehler: docker logs prometheus | tail für aktuelle Meldung.
  5. Alert clearet 5 min nach erfolgreichem Reload (for: 5m).

🆘Wenn das nicht klappt

Kopier den Alert + die letzte Log-Zeile in Claude. YAML-Fehler sind meist 1-Zeichen-Fixes.