Überwachung und Zustand

Installationsstatus

System → Installationsstatus prüft alles, wovon Vaultigen abhängt, und zeigt für jede Prüfung grün, gelb oder rot:

Prüfung	Betrachtet
Datenbank	Verbindung und System
Sodium	Die PHP-Erweiterung für Verschlüsselung
Installationsidentität	installation.json oder ihre Umgebungsvariablen
Anwendungsschlüssel	APP_KEY
Unabhängige Sicherheitsschlüssel	KEK-Schlüsselbund und Audit-Schlüssel
Freier Speicher	Freier Platz auf dem Speichervolume
E-Mail	Transport konfiguriert; Testversand möglich
Scheduler	Aktueller Heartbeat des Schedulers
Queue	Aktueller Heartbeat des Workers
Sicherheitsbenachrichtigungen	Ausstehende oder fehlgeschlagene Zustellungen
Lizenz	Lizenzstatus und belegte Plätze

Heartbeats gelten nach drei Minuten als veraltet. Die Prüfungen zeigen nur, ob etwas vorhanden ist, nie einen Wert, und beweisen nicht, dass Backups wiederherstellbar sind.

Hintergrundprozesse

Prozess	Zuständig für
Queue-Worker (queue:work)	Backups, Schlüsselrotation, Importe, Website-Icons, Worker-Heartbeat
Scheduler (schedule:work oder Cron)	Sicherheitsbenachrichtigungen, Ablauf von Notfallzugriffen, Papierkorb-Löschung, Import-Aufräumen, Audit-Bereinigung, Heartbeats

Beide müssen unter einem Supervisor laufen. Jobs sind dauerhaft gespeichert: War der Worker ausgefallen, holt er sie nach dem Neustart nach. Bei Docker Compose sind die Dienste worker und scheduler dieser Supervisor: Sie starten automatisch neu und melden ihre Heartbeats über Container-Health-Checks.

Queue-Timeouts sind wichtig: retry_after der Queue-Verbindung muss länger sein als der längste Job (VAULTIGEN_BACKUP_JOB_TIMEOUT und VAULTIGEN_ROTATION_JOB_TIMEOUT, standardmäßig eine Stunde). Die mitgelieferten Standardwerte erfüllen das.

Freier Speicher

Backups, Anhänge und Import-Staging belegen Speicher. Konfigurieren Sie Volume und Warnschwelle:

VAULTIGEN_STORAGE_PATH=/var/www/vaultigen/storage/app/private
VAULTIGEN_MIN_FREE_BYTES=268435456   # 256 MB, der Standard

Die Prüfung warnt; sie legt die Anwendung nicht lahm. Behalten Sie auch das temporäre Verzeichnis von PHP im Blick. Bei Docker Compose prüft der Standard bereits data/storage/; Backup-Sätze in backups/ liegen meist auf demselben Dateisystem.

Tägliche Prüfungen

• Installationsstatus: alles grün, Heartbeats aktuell.
• System → Operations: das letzte Backup ist abgeschlossen, nichts hängt in running.
• Aktivität: unerwartete auth.*-Ablehnungen, Notfallsitzungen oder Schlüsselrotationen, die Sie nicht gestartet haben.

Docker Compose

docker compose ps                                     # alle Dienste laufend und gesund?
docker compose logs --tail=100 web worker scheduler   # aktuelle Ausgaben
docker compose logs --tail=100 migrate                # warum die Anwendung nicht startet

• web ist gesund, wenn er lokal antwortet; worker und scheduler, wenn ihre Heartbeats aktuell sind (php artisan vaultigen:health worker|scheduler). Ein ungesunder Dienst erscheint in docker compose ps als (unhealthy).
• migrate läuft bei jedem Start und beendet sich dann. Exit-Code 0 ist normal; alles andere lässt die Anwendung gestoppt.
• Beobachten Sie den freien Speicher mit df -h auf dem Dateisystem, das ~/vaultigen enthält: Datenbank, Anhänge und Backup-Sätze liegen alle dort.
• Laufende Container starten nach einem Neustart wieder. Prüfen Sie nach Wartungsarbeiten am Host docker compose ps und den Installationsstatus.

Logs

Bei Docker Compose gehen Anwendungs- und Webserver-Logs in die Container-Ausgabe (docker compose logs); ein Zugriffslog gibt es nicht. Rotieren Sie Dockers Logs über die Einstellungen des Logging-Treibers. Bei einer manuellen Installation liegen Anwendungslogs in storage/logs. Sie enthalten nie geheime Werte, und niemand sollte je ein echtes Geheimnis in ein Ticket oder Log kopieren.

Externe Überwachung

Empfohlen außerhalb von Vaultigen: ein HTTPS-Verfügbarkeitscheck, ein Alarm, wenn ein Backup fehlschlägt oder seit einem Tag keines gelungen ist (die Seite Operations warnt nach 48 Stunden), Speicherplatz-Alarme auf dem Host und ein Alarm bei fehlgeschlagenen Sicherheitsbenachrichtigungen.