Supervisor-Webterminal
Das Supervisor-Webterminal verbindet die Ephraim-Administration mit den Betriebsdiensten der Spark. Es zeigt Status, Logs und Runtime-Daten und stellt ausgewählte, abgesicherte Administrationsaktionen bereit.
1. Rolle des Webterminals
Das Webterminal ist kein allgemeiner Shell-Zugang für beliebige Kommandos. Es ist eine administrierte Konsole mit vordefinierten Betriebsfunktionen. Administratoren können Dienste prüfen, Logs lesen, Containerstatus sehen und ausgewählte Aktionen auslösen, ohne direkt auf die Spark per Systemterminal wechseln zu müssen.
2. Authentifizierung zur Runtime
Der Zugriff auf Runtime und Supervisor wird mit kurzlebigen signierten Tokens abgesichert. Ephraim erzeugt diese Tokens serverseitig für berechtigte Admins. Die Runtime prüft Signatur, Aussteller, Ziel und Ablaufzeit. Dadurch reicht eine normale Browsersitzung allein nicht aus, um dauerhaft Runtimezugriff zu erhalten.
3. Verfügbare Funktionen
| Bereich | Typische Nutzung |
|---|---|
| Status | Runtime, Supervisor, Inference, TTS und Containerzustände prüfen. |
| Logs | Fehler und Betriebsereignisse lesen, ohne private Chatinhalte zu dumpen. |
| Statistiken | Ressourcen, Auslastung und Dienstzustände für Diagnose einordnen. |
| Aktionen | Gezielte Betriebsaktionen auslösen, wenn Berechtigung und Bestätigung passen. |
4. Super-Admin-Aktionen
Einige Aktionen sind Super-Admins vorbehalten, etwa besonders tiefgreifende Updates, Audits oder Benutzeränderungen mit Systemwirkung. Solche Aktionen sind nicht nur durch Rolle, sondern auch durch Bestätigungsmechanismen und serverseitige Prüfungen geschützt. Das verhindert, dass ein versehentlicher Klick oder ein alter Tab unmittelbar kritische Betriebszustände verändert.
5. Umgang mit Logs
Logs sind Betriebsdaten, keine Datensammlung für Unterrichtsinhalte. Bei Fehlersuche suchen Administratoren nach Statuscodes, Dienstnamen, Job-IDs und Fehlerzeitpunkten. Private Prompts oder Dateien dürfen nicht als Debug-Ausgabe in Logs kopiert werden. Wenn ein Log unerwartet sensible Daten enthält, ist das ein Sicherheitsproblem.
Die Grundregeln für Production-Logging, Webservergrenzen, Spark-Logs und Admin-Problem-Mails sind im Artikel Logging zusammengefasst.
6. Betriebspraxis
Das Webterminal ist besonders hilfreich, wenn die Statusseite ein Problem zeigt, aber der betroffene Dienst noch nicht feststeht. Die Reihenfolge lautet: Status prüfen, betroffene Komponente identifizieren, Logs lesen, aktuelle Jobs oder Container prüfen, dann gezielt handeln.