Überwachung und Protokolle

Wo Sie sehen, was der Server tut, für den Administrator, der den Zustand prüfen will, statt etwas zu reparieren: von dem, was gerade läuft, bis zur Statistik des Monats, mit den Protokollen dazwischen. Wenn Sie einem bestimmten Fehler nachgehen, beginnen Sie mit der Fehlerbehebung.

Was gerade läuft

Verwaltung → Aktuelle Wiedergabe listet jeden laufenden Stream auf: wer, was, auf welchem Gerät und wie, Spur für Spur (kopiert, transkodiert, und mit welchem Backend umgewandelt). Ein Administrator kann eine Sitzung mit Stoppen beenden oder dem Zuschauer mit Nachricht senden schreiben.

Die Karte Wer ist online im Dashboard listet auf, wer gerade verbunden ist, nach Profil, und wie lange es her ist, dass sich jede App zuletzt gemeldet hat. Ein Chromecast, dessen Fernseher Eveys Empfänger geladen hält, bleibt in der Liste, auch wenn seine Wiedergabe beendet ist und aus Aktuelle Wiedergabe verschwunden ist; Diesen Chromecast stoppen schickt ihm einen Stopp-Befehl, den der Fernseher in etwa 30 Sekunden ausführt.

Verwaltung → Systemzustand zeigt Prozessor, Arbeitsspeicher, Bandbreite und Speicherplatz und wie viel der Kapazität für die Transkodierung belegt ist. Außerdem listet die Seite die Datenträger der Maschine auf, jeden mit der mittleren Wartezeit einer Anfrage in der letzten Minute, seiner Auslastung und seinen Lese- und Schreibraten. Die Wartezeit ist die Zahl, auf die es ankommt: ein Datenträger kann zu 100 % ausgelastet sein und trotzdem mithalten, während einer, der jede Anfrage um ein Mehrfaches länger warten lässt als im Ruhezustand, die Wiedergabe ins Puffern treibt, selbst wenn der Prozessor untätig wirkt. Ein Datenträger gilt als Gesättigt, wenn seine Wartezeit mindestens 20 ms und mindestens das 2,5-Fache seiner Wartezeit im Ruhezustand erreicht und entweder der Datenträger ausgelastet ist oder der Prozessor auf ihn wartet. Die CPU-Karte nennt den Anteil der Prozessorzeit, der mit Warten auf Datenträger verging.

Trends unter den Live-Karten zeichnet die letzten 24 Stunden, 7 Tage oder 30 Tage aus den Proben, die der Server jede Minute speichert: Prozessor und Datenträger-Wartezeit, Arbeitsspeicher, die Datenträger-Wartezeit mit ihrer Ruhe- und Sättigungslinie, Auslastung und Durchsatz der Datenträger, eingehendes und ausgehendes Netzwerk neben dem tatsächlich ausgelieferten Streaming, Streams und Transkodierungen sowie den Füllstand der Bibliotheksdatenträger. Prozessor, Datenträger und Netzwerk betreffen die gesamte Maschine: ein Kopiervorgang oder ein benachbarter Dienst, der dieselben Datenträger liest, erscheint dort ebenfalls. Das Dashboard trägt eine Kachel Datenträger mit dem Datenträger, der am längsten wartet.

Verwaltung → Systemzustand, mit den Hintergrundarbeiten darunter (Oberfläche auf Englisch).

Protokolle

Verwaltung → Protokolle & Debug durchsucht das Protokoll des Servers und folgt ihm live (Live), mit Bereich eingegrenzt auf einen Teil (Player und Transkodierung, Seek-Index, Untertitel, Intro-Erkennung, Chromecast, Anmeldung, Infrastruktur...). Hier sehen Sie zuerst nach, wenn ein Benutzer ein Problem meldet.

Dasselbe Protokoll liegt auf der Festplatte, eine JSON-Datei pro Tag in ./evey-data/logs/ (/data/logs/evey-YYYY-MM-DD.log im Container), dazu eine Datei mit Stundensuffix (evey-YYYY-MM-DD-HH.log), sobald eine Datei 50 MB überschreitet (EVEY_LOG_MAX_SIZE_MB), standardmäßig 90 Tage aufbewahrt. docker compose logs evey zeigt nur, was der Container beim Start ausgibt. Das lesen Sie, wenn der Server nicht startet. Siehe Fehlerbehebung.

Wie die Wiedergabe wirklich lief

Verwaltung → Streaming-Qualität beruht auf dem, was die Player während der Wiedergabe melden (Pufferstand, erneutes Puffern, Durchsatz, im Format CMCD): wie oft Zuschauer gewartet haben, welche Titel am häufigsten hängen und bei welchen Gerätearten Probleme auftreten, über den letzten Tag oder die letzte Woche.

Der Server reagiert auch darauf. Lässt eine bestimmte Art von Quelle die Zuschauer immer wieder warten, senkt er für eine Weile die höchste Qualität für diese Art von Quelle, zusätzlich zur kalibrierten Obergrenze, und hebt die Grenze danach von selbst wieder auf. Die aktiven Grenzen stehen unter Automatische Qualitätsgrenzen, mit Grund und Ablaufzeit; Zurücksetzen hebt eine sofort auf.

Verlauf und Statistik

• Verwaltung → Analysen: Wiedergaben heute und in dieser Woche, aktive Benutzer, die meistgesehenen Titel der letzten 30 Tage.
• Verwaltung → Aktivität: der Verlauf der Wiedergaben und der Verwaltungsaktionen sowie die laufenden Hintergrundarbeiten.

Wie lange jede Art von Verlauf aufbewahrt wird, legen Sie unter Verwaltung → Serverkonfiguration → Daten & Aufbewahrung fest (Wiedergabesitzungen, Audit-Protokoll, Servermesswerte, Streaming-Qualität). Eine Änderung gilt ab der nächsten täglichen Bereinigung.

Prometheus-Metriken

GET /metrics liefert die Zähler des Servers im Textformat von Prometheus, alle mit Namen evey_.... Es antwortet einem festen Token, das in EVEY_METRICS_SCRAPE_TOKEN gesetzt und als Authorization: Bearer <token> gesendet wird, damit Prometheus oder Grafana die Werte von überall abrufen können, ohne sich anzumelden; eine Administratorsitzung wird nur vom eigenen Loopback des Containers akzeptiert (Sicherungen, Protokolle und Überwachung). Die Gruppen, die sich für ein erstes Diagramm lohnen:

Metrik	Was sie zeigt
evey_transcodes_active, evey_transcode_queue_depth	Transkodierungsaufträge im Hintergrund (außerhalb der laufenden Wiedergabe), die laufen und die auf einen freien Platz warten.
evey_hlsvod_sessions_active, evey_hlsvod_sessions_rejected_total	FFmpeg-Prozesse, die Segmente für die Wiedergabe erzeugen, und Starts, die abgelehnt wurden, weil der Server an seiner Grenze war.
evey_hlsvod_cache_size_bytes, evey_hlsvod_cache_evicted_bytes_total	Größe des Segment-Caches auf der Festplatte und was die Bereinigung freigegeben hat.
evey_mkvgo_walks_in_flight, evey_mkvgo_plan_stats	Der eingebaute Packager: Abschnitte, die gerade gelesen werden, Lesevorgänge in der Warteschlange (stat="slot_waits"), siehe MKVGo in Evey.
evey_http_requests_total, evey_http_request_duration_seconds	Anfragen und Antwortzeit nach Methode und Pfad.
evey_watcher_alive, evey_scan_queue_depth	Ob die Ordnerüberwachung jeder Bibliothek auf ihre letzte Prüfung geantwortet hat (1 oder 0), und Dateien, die auf den Scan warten.

Kommandozeile

evey admin doctor prüft den ganzen Server in einem Bericht; die anderen Befehle zur Diagnose stehen unter Kommandozeile.