homelab-infra/docs/ALERTING_MAP.md

Alerting Map

Stand: 2026-05-23

Ziel: Alle problemrelevanten Homelab-Meldungen landen auf einem Handy-Topic.

ntfy Topics

Topic	Zweck
homelab-alerts	Alles, was Aufmerksamkeit braucht: Prometheus, Docker-Events, Posture, Zertifikate/Token, Compose-Drift, Borg-Pre-Hook-Fehler und Restore-Fehler
homelab-info	Optionale Erfolgsmeldungen, z. B. erfolgreiche Restore-Testlaeufe

Sender

Sender	Pfad	Problem-Topic	Hinweis
Prometheus / Alertmanager	monitoring/alertmanager/alertmanager.yml, monitoring/alertmanager-ntfy-bridge/bridge.py	homelab-alerts	Zentrale Monitoring-Alerts via Bridge
Posture Check	services/posture-check/posture-check.sh	homelab-alerts	Warning und Critical gehen auf dasselbe Handy-Topic
Cert / Token Check	services/posture-check/cert-token-check.sh	homelab-alerts	Prueft produktive HTTPS-Domains und Cloudflare Token
Compose Runtime Drift	services/posture-check/compose-runtime-drift.sh	homelab-alerts	Meldet Abweichungen zwischen Repo-Compose und Runtime-Image
Docker Critical Events	services/posture-check/docker-critical-events.sh	homelab-alerts	Meldet Docker die, oom und kill Events
Borg Pre-Hook	ops/borg-ui/scripts/pre-borg.sh	homelab-alerts	Meldet Fehler vor Borg, z. B. Posture-, Dump- oder Restore-Freshness-Fehler
Restore Jobs	ops/restore-tests/run-restore-job-with-ntfy.sh	homelab-alerts	Erfolg geht an homelab-info, Fehler immer an homelab-alerts

Konvention

• NTFY_BASE_URL zeigt standardmaessig auf https://ntfy.kaleschke.info.
• Neue Problem-Alerts sollen homelab-alerts nutzen.
• Erfolgsmeldungen sind optional und sollen nicht in homelab-alerts landen, ausser sie sind bewusst als Lebenszeichen gewuenscht.
• Blackbox-Endpoint-Alerts sollen bekannte WAN-/Provider-Sammelausfaelle zusammenfassen, damit kurze DSL-Reconnects keine ntfy-Flut pro Domain erzeugen.