🛡️ Backup Monitor – The Sentinel

Zentrales Backup-Monitoring-Dashboard für Borgmatic-Backups mit MongoDB Backend, Sentinel UI, Prometheus Metrics und Webhook-Alerts.

Features

Sentinel Web-UI – Dashboard, Alert Center, Host Grid, 30-Tage Kalender-Heatmap
Prometheus /metrics – Scrape-fähig für Grafana Dashboards
Uptime Kuma Push-Forwarding – Single Point of Contact (Borgmatic → Monitor → Kuma)
Webhook Alerts – Error/Stale Events an n8n, Telegram, etc.
Auto-Register – Hosts registrieren sich automatisch beim ersten Push
90 Tage Retention – MongoDB TTL-Index, automatisch

Stack

Python 3.12 / Flask / Gunicorn
MongoDB 8
Tailwind CSS, Material 3 Design Tokens, Glassmorphism

Deployment

Läuft als Teil des monitoring Stacks auf 10.1.1.111:9999.

backup-monitor:
  build: ./backup-monitor
  ports:
    - "9999:9999"
  environment:
    - MONGO_URI=mongodb://backup-mongo:27017
    - STALE_HOURS=26
    - API_KEY=<optional>
    - WEBHOOK_URLS=<kommasepariert>
    - WEBHOOK_EVENTS=error,stale

Borgmatic Integration

Borgmatic pusht nach jedem Backup via after_backup Hook:

curl -X POST -H "Content-Type: application/json" \
  -d '{"host":"<hostname>","status":"ok","duration_sec":123,...}' \
  http://10.1.1.111:9999/api/push

Template: roles/borg/templates/borgmatic.yml.j2 im Ansible-Repo.

API

Method	Endpoint	Auth	Beschreibung
GET	`/`	❌	Web UI
GET	`/metrics`	❌	Prometheus Metriken
GET	`/api/summary`	❌	Dashboard-Zusammenfassung
GET	`/api/hosts`	❌	Alle Hosts mit Status
GET	`/api/history/<host>`	❌	Backup-History
GET	`/api/calendar/<host>`	❌	Kalender-Heatmap
POST	`/api/push`	🔑	Backup-Status pushen
POST	`/api/hosts`	🔑	Host hinzufügen
PUT	`/api/hosts/<name>`	🔑	Host bearbeiten
DELETE	`/api/hosts/<name>`	🔑	Host + History löschen

🔑 = benötigt API_KEY falls gesetzt (Header X-API-Key oder ?api_key=)

Neuen Host hinzufügen

Borgmatic auf dem Host deployen: ./pfannkuchen.sh backup <host>
Oder manuell über Web-UI: http://10.1.1.111:9999 → Host hinzufügen
Uptime Kuma Push-URL eintragen (optional)
Host registriert sich automatisch beim ersten Backup-Push

2.3 KiB Raw Blame History Unescape Escape