Administratorhandbuch

Status

Die Statusseite ist der schnelle Betriebsüberblick für Ephraim: Spark-Erreichbarkeit, Runtime, Containerzustände, Auslastung und Hinweise auf Dienste, die aktiv, bereit, problematisch oder bewusst deaktiviert sind.

· Stand: Juli 2026

1. Zweck der Statusseite

Die Statusseite beantwortet die Betriebsfrage: „Kann Ephraim gerade KI-Funktionen zuverlässig anbieten?“ Sie ist bewusst als Übersicht gebaut und nicht als Reparaturkonsole. Administratoren sehen auf einen Blick, ob Webserver, Spark-Dienste und Runtime-Container erwartungsgemäß erreichbar sind.

Admin-Statusseite mit Betriebsübersicht und sechs bereiten Spark-Containern
Die Statusseite ist der erste Diagnosepunkt: Sie zeigt technische Zustände, aber keine privaten Chatinhalte.

2. Welche Signale angezeigt werden

Signal Bedeutung
Spark und Inference Erreichbarkeit der lokalen KI-Inferenz und Antwortfähigkeit des Modells.
Runtime und Supervisor Technische Betriebsdienste für Terminal, Logs, Status und administrative Aktionen.
Container Zustand von Inference, Embedding, Observer, Runtime, TTS und der technischen Logrotation: laufend, bereit, problematisch oder deaktiviert.
school-ui-observer Liefert der Runtime über einen internen Unix-Socket nur freigegebene Containerzustände und begrenzte Logstreams. Er besitzt keinen Netzwerkport und erscheint als eigener überwachter Container.
school-ui-logrotate Rotiert technische Spark-Logdateien täglich. Der Dienst besitzt keinen eigenen Web-Endpunkt und wird deshalb über seinen Docker-Zustand bewertet.
Ressourcen Auslastungs- und Gesundheitswerte wie Speicher, VRAM, Temperatur oder Stromdaten. Die Anzeige hängt davon ab, welche Werte die Runtime im Snapshot liefert.

3. Status richtig lesen

Ein rotes oder gelbes Signal bedeutet nicht automatisch, dass die Anwendung komplett ausgefallen ist. Manche Dienste sind optional oder nur für bestimmte Funktionen relevant. Ein deaktivierter Container ist kein Fehler, wenn er bewusst deaktiviert wurde. Problematisch wird es, wenn ein Dienst aktiv sein soll, aber nicht antwortet oder wiederholt fehlschlägt. school-ui-observer und school-ui-logrotate sollen im normalen Betrieb als eigene bereite Container erscheinen. Fehlt der Observer, kann die Runtime Containerzustände und Logstreams nicht zuverlässig liefern. Fehlt Logrotate oder ist der Dienst gestoppt, läuft die vorgesehene Rotation der technischen Logdateien nicht.

Praktisch: Bei Nutzerbeschwerden zuerst prüfen, ob die Inference erreichbar ist. Bei Admin-Terminal-Problemen dagegen Runtime und Supervisor prüfen.

Fehlende Temperatur-, Strom- oder VRAM-Werte sind deshalb nicht automatisch ein Fehler der Statusseite. Entscheidend ist, ob der Runtime-Snapshot diese Werte für die aktuelle Spark-Konfiguration liefert.

4. Datenschutz und Sichtbarkeit

Die Statusseite zeigt technische Zustände, keine privaten Chatinhalte. Sie dient der Betriebsdiagnose und soll nicht zur Analyse einzelner Nutzerverläufe verwendet werden. Wenn Detaildiagnose nötig ist, erfolgt sie über Logs, Cronstatus oder das Supervisor-Terminal mit klarer Fragestellung.

5. Typische Reaktion auf Probleme

  1. Prüfen, ob der Webserver selbst erreichbar ist und Anmeldungen funktionieren.
  2. Auf der Statusseite Spark, Inference, Observer und Runtime vergleichen.
  3. Bei Containerproblemen im Supervisor-Webterminal Logs und Status abfragen.
  4. Bei wiederkehrenden Wartungsproblemen Cronstatus und letzte Läufe prüfen.
  5. Erst danach Dienste gezielt neu starten oder Super-Admin-Aktionen ausführen.