Monitoring & Logs

Health-Endpunkt

GET /api/health

Gibt einen JSON-Status zurück:

{
  "status": "ok",
  "database": "ok",
  "storage": "ok"
}

Nutze diesen Endpunkt für externe Monitoring-Systeme (z. B. Uptime Kuma).

Log-Streams

Clavis schreibt vier Log-Dateien:

Stream	Pfad	Inhalt
audit.log	/logs/audit.log	Sicherheitsrelevante Ereignisse (HMAC-Kette)
app.log	/logs/app.log	Anwendungs-Logs
error.log	/logs/error.log	Fehler und Exceptions
access.log	/logs/access.log	HTTP-Anfragen

Die Logs sind im Docker-Volume clavis_logs gespeichert und werden täglich rotiert.

Aufbewahrungsfristen

Stream	Aufbewahrung
Audit-Logs	365 Tage
App-Logs	90 Tage
Error-Logs	90 Tage
Access-Logs	90 Tage

Log-Bereinigung

Das Bereinigungsskript entfernt Logs nach Ablauf der Aufbewahrungsfrist:

deployment/scripts/log-cleanup.sh

Als Cron-Job empfohlen (täglich):

# crontab -e
0 4 * * * /path/to/App/deployment/scripts/log-cleanup.sh

Externer Monitoring-Dienst

Empfehlung: Uptime Kuma auf einem separaten Server, der den Health-Endpunkt alle 60 Sekunden abfragt und Alarm-Benachrichtigungen (z. B. Telegram) sendet.