Sicherungen, Protokolle und Überwachung¶

Die Variablen hinter den Datenbanksicherungen, dem Serverprotokoll, der Aufbewahrungsdauer des Verlaufs und den Endpunkten für eine externe Überwachung. Die tägliche Praxis steht unter Sicherungen und Updates und Überwachung und Protokolle.

Sicherungen¶

Variable	Standard	Wirkung	Verwaltungsbereich
`EVEY_BACKUP_DIR`	`/data/backups`	Wohin die Datenbanksicherungen geschrieben werden.	keine
`EVEY_BACKUP_INTERVAL_HOURS`	`0` (aus)	Eine Sicherung alle N Stunden, unabhängig vom Zeitplan im Verwaltungsbereich, der der übliche Weg ist.	Sicherung & Wiederherstellung → Zeitplan (Cron-Ausdruck), sofort
`EVEY_BACKUP_RETENTION_DAYS`	`30`	Ältere Sicherungen werden gelöscht, wenn das Intervall darüber gesetzt ist: beim Start und nach jedem seiner Läufe. Der Zeitplan im Verwaltungsbereich hat seine eigene Aufbewahrung.	Sicherung & Wiederherstellung → Zeitplan → Aufbewahrung, sofort

Protokoll¶

Variable	Standard	Wirkung	Verwaltungsbereich
`EVEY_LOG_LEVEL`	`info`	`debug`, `info`, `warn` oder `error`.	Serverkonfiguration → Allgemein → Protokollstufe, sofort
`EVEY_LOG_DIR`	`/data/logs`	Wohin die tägliche Protokolldatei `evey-YYYY-MM-DD.log` geschrieben wird. Vom Image gesetzt. Diese Datei ist maßgeblich: `docker logs` zeigt denselben Strom, aber Docker rotiert ihn.	keine
`EVEY_LOG_MAX_SIZE_MB`	`50`	Größe einer Protokolldatei, bevor sie rotiert wird.	keine
`EVEY_LOG_RETENTION_DAYS`	`90`	Tage, die Protokolldateien aufbewahrt werden.	keine

Aufbewahrung des Verlaufs¶

Die Aufbewahrungsfristen werden bei jeder täglichen Bereinigung neu gelesen. Ein unter Verwaltung → Serverkonfiguration → Daten & Aufbewahrung gespeicherter Wert gilt also ab dem nächsten Durchlauf.

Variable	Standard	Wirkung	Verwaltungsbereich
`EVEY_PLAY_SESSION_RETENTION_DAYS`	`0` (für immer)	Beendete Wiedergabesitzungen im Verlauf.	Serverkonfiguration → Daten & Aufbewahrung → Aufbewahrung des Sitzungsverlaufs, nächster Durchlauf
`EVEY_AUDIT_LOG_RETENTION_DAYS`	`0` (für immer)	Das Audit-Protokoll der Verwaltungsaktionen.	Serverkonfiguration → Daten & Aufbewahrung → Aufbewahrung des Audit-Protokolls, nächster Durchlauf
`EVEY_METRICS_RETENTION_DAYS`	`90`	Die Ressourcenmessungen des Servers (Prozessor, Arbeitsspeicher, Bandbreite).	Serverkonfiguration → Daten & Aufbewahrung → Aufbewahrung der Servermetriken, nächster Durchlauf
`EVEY_QOE_RETENTION_DAYS`	`30`	Die Berichte der Player zur Streaming-Qualität.	Serverkonfiguration → Daten & Aufbewahrung → Aufbewahrung der Wiedergabequalität (QoE), nächster Durchlauf
`EVEY_METRICS_SAMPLE_INTERVAL_SEC`	`60`	Wie oft diese Ressourcenmessungen erfasst werden.	keine

Externe Überwachung¶

Variable	Standard	Wirkung	Verwaltungsbereich
`EVEY_METRICS_SCRAPE_TOKEN`	leer	Ein festes Token, das auf `GET /metrics` neben einer Administratorsitzung akzeptiert wird. So können Prometheus oder Grafana Daten abrufen, ohne eine Anmeldung zu erneuern. Leer: Nur eine Administratorsitzung wird akzeptiert.	keine
`EVEY_OTLP_ENDPOINT`	leer	Ein OpenTelemetry-Endpunkt, an den Traces gesendet werden. Leer: kein Tracing.	keine
`EVEY_TRACING_SERVICE_NAME`	`evey`	Der Dienstname in den Traces.	keine
`EVEY_TRACING_SAMPLE_RATIO`	`0`	Der Anteil der Anfragen, die verfolgt werden, 0 bis 1 (ein Verhältnis, kein Prozentwert).	keine

Nur für die Entwicklung¶

Variable	Standard	Wirkung	Verwaltungsbereich
`EVEY_LOG_DEV_MODE`	`false`	Entwicklermodus: Sicherheitsprüfungen beim Start warnen nur, und Plugins dürfen ohne die Sandbox-Bibliothek laufen. Nie auf einem echten Server; mit `EVEY_ENV=production` verweigert der Server den Start.	keine