Ein Plex-Health-Check sollte einen kleinen, für Benutzer sichtbaren Pfad überprüfen und nicht lediglich bestätigen, dass der Serverprozess läuft.
Trennen Sie Liveness und Readiness. Der Plex-Prozess kann aktiv sein, während der Medienspeicher nicht verfügbar, die App-Daten schreibgeschützt oder eine Proxy-Route defekt ist. Verwenden Sie kostengünstige Prüfungen mit klarer Zuständigkeit: Server-Endpunkt, Schreibzugriff auf den Zustandspfad, Lesezugriff auf den Medienpfad und optional die Erreichbarkeit von außen. Vermeiden Sie Probes, die Produktionsmedien verändern oder umfangreiche Hintergrundaufgaben auslösen.
Liveness und Readiness getrennt definieren
Liveness fragt, ob der Dienst neu gestartet werden sollte; Readiness fragt, ob er die vorgesehene Arbeitslast derzeit bedienen kann. Werden beide kombiniert, kann dies während einer vorübergehenden Verzögerung bei einer Abhängigkeit unnötige Neustarts auslösen.
Readiness- und Liveness-Signale erfüllen unterschiedliche Zwecke. Eine vorübergehende Speicherverzögerung sollte daher nicht automatisch als Grund für einen Neustart des Plex-Prozesses gelten.
Verwenden Sie für Liveness einen leichtgewichtigen lokalen Endpunkt oder eine Prozessprüfung und für Speicher- und Netzwerkabhängigkeiten ein separates Readiness-Ergebnis. Nur eine fehlgeschlagene Liveness-Bedingung sollte automatisch den Ersatz des Prozesses auslösen.
App-Daten und Medien mit unkritischen Vorgängen prüfen
Plex benötigt dauerhaften Zugriff auf seinen Zustand und Zugriff auf die Quellmedien. Ein Health-Check sollte jedoch weder die aktive Datenbank verändern noch Produktionsdateien umbenennen. Verwenden Sie einen temporären Testpfad und eine bekannte schreibgeschützte Medienprüfung.
Ein Dienst kann gesund erscheinen, bevor eine Abhängigkeit nutzbar ist. Das Timing der Abhängigkeitsprüfung ist der Grund, warum Speicher- und Netzwerkprüfungen getrennt vom Prozessstatus gemeldet werden sollten.
Erstellen und entfernen Sie eine winzige Datei in einem dedizierten Health-Verzeichnis für die App-Daten und lesen Sie anschließend eine kleine bekannte Datei aus dem Medien-Mount. Schlägt eine der Prüfungen fehl, melden Sie den fehlerhaften Pfad, ohne Bibliotheksinhalte anzutasten.
Netzwerkprüfungen nur für tatsächlich benötigte Pfade hinzufügen
Wiedergabe im LAN, Zugriff über einen Reverse-Proxy, VPN-Zugriff und Remote-Portweiterleitung sind unterschiedliche Pfade. Eine einzelne Probe kann sie nicht alle abbilden, ohne die Fehlergrenze zu verschleiern.
Prüfen Sie zuerst die lokale Serverroute und anschließend den ausgewählten Remote-Pfad von außerhalb des Netzwerks. Eine Prüfung des Remote-Plex-Streamings ist nur dann sinnvoll, wenn der Fernzugriff Bestandteil des Serviceversprechens ist.
Benennen Sie jede Netzwerkprobe nach dem von ihr validierten Pfad, etwa LAN, Proxy oder VPN. Wenn eine Prüfung fehlschlägt und eine andere erfolgreich ist, leiten Sie den Alarm an die betreffende Schicht weiter, anstatt den gesunden Server neu zu starten.
Fehlerschwellen verwenden, die kurze Störungen ignorieren
Eine einzelne fehlgeschlagene Probe kann durch den Start, das Aufwecken des Speichers, eine DNS-Verzögerung oder ein vorübergehendes Netzwerkereignis verursacht werden. Health-Checks sollten anhaltende Nichtverfügbarkeit erkennen, ohne bei harmlosen Pausen ständig zwischen Zuständen zu wechseln.
Wählen Sie Wiederholungs- und Intervallgrenzen anhand gemessener Fehler, Sättigung und Auslastung, damit eine kurze Ressourcenpause nicht dieselbe Reaktion auslöst wie eine anhaltende Nichtverfügbarkeit.
Verursachen Sie in einem Testfenster zunächst eine kurze Verzögerung einer Abhängigkeit und anschließend einen anhaltenden Ausfall. Passen Sie die Schwellenwerte an, bis die kurze Verzögerung keinen Neustart auslöst, der anhaltende Ausfall jedoch innerhalb Ihrer akzeptablen Reaktionszeit erkannt wird.
Support & Tipps
Mehr zum Lesen

Kann Jellyfin sicher eine GPU oder einen Beschleuniger mit einem anderen Container teilen?
Die gemeinsame GPU-Nutzung ist an Bedingungen geknüpft: Überprüfen Sie die Gerätesichtbarkeit und die Treiberunterstützung, führen Sie anschließend beide Workloads aus und achten Sie auf...

So erkennen Sie, ob ein Jellyfin-Fehler vom Client oder Server stammt
Ein Jellyfin-Fehler liegt am Client, wenn er nur auf einem Gerät auftritt; er liegt am Server, wenn mehrere Clients über denselben Pfad fehlschlagen und...

So konfigurierst du den Cache und temporären Speicher von Jellyfin
Trenne dauerhaften Zustand, wiederaufbaubaren Cache und temporären Transkodierungsspeicher und überprüfe anschließend Kapazität und Berechtigungen mit einem echten Wiedergabetest.

