Athena-Deck/DASHBOARD.md

Dashboard und übernommene Historie

Dashboard steht an erster Stelle der Deck-Navigation. Die frühere Hardware-Seite entfällt. Die Übersicht für Endpunkt und GPU-Modus bleibt als separater Bereich erhalten; die alten Router-, Bild- und Modus-Umschalter werden im Dashboard nicht eingeblendet.

Das Dashboard ist Teil des normalen Deck-DOM und nutzt dessen Navigation, Typografie, Karten und responsive Layoutregeln. Es übernimmt die Messwerte und Funktionen ab „Aktives Profil“ aus dem alten Athena-Dashboard: CPU, RAM, beide GPUs mit VRAM/Temperatur/Takt/Leistung, Inferenzraten, Prompt-Cache, Anfragen, Slots, Kontextfenster, MTP, Tokenzähler, GPU- und Slot-Verlauf, Nutzung nach Profil, Modellwechsel, Profile, Dienste, Host/Netzwerk, GPU-Prozesse, llama.cpp-Parameter, GGUF-Dateien und verschlüsselte portable Backups. Die Anzeige ist im Deck-Design neu aufgebaut. Nicht verfügbare Laufzeitwerte erscheinen als „–“; sie werden nicht aus historischen Werten geschätzt. Profil und Modell beziehen sich auf Decks eigenen Worker, nicht auf den alten Router.

Datenquellen

• CPU, RAM, Host-Uptime und Netzwerk: Host-/proc, im Docker-Testbetrieb ausschließlich lesend nach /host/proc eingebunden. Für das Host-Netzwerk wird /host/proc/1/net/dev verwendet; /host/proc/net/dev würde die Container-Namespace messen.
• GPU, VRAM, Temperatur, Leistung, Takt und Prozesse: nvidia-smi.
• Inferenz, Slots und Modellparameter: Decks eigener llama-server, dessen lesende /metrics, /slots und /props-Routen; --metrics wird beim Modellstart aktiviert. Deck liest daraus nur Zahlen und Slotzustände.
• Profile und GGUF-Dateien: Deck-Bibliothek plus, sofern vorhanden, das lesend eingebundene alte /data/models.
• Backups: optionales, lesend eingebundenes /data/emergency-backups. Downloads laufen nur über die angemeldete Deck-Oberfläche.

Das Dashboard verwendet die internen, sitzungsgeschützten GET-Routen /api/v1/dashboard, /api/v1/dashboard/history?range=24h und /api/v1/dashboard/backups. Mögliche Zeiträume sind 1 Stunde, 24 Stunden, 7 Tage, 21 Tage und Gesamt. Die Live-Ansicht aktualisiert jede Sekunde, die History alle 15 Sekunden. Die Aufzeichnung schreibt alle 15 Sekunden; Detailwerte bleiben 21 Tage, ältere GPU- und Slotwerte werden auf Stundenwerte verdichtet. Prompts, Antworten, Medien und Anwendungslogs werden nicht in die History geschrieben.

Bestehende History einmalig übernehmen

Vor dem ersten Start einer Deck-Version mit Dashboard die alte SQLite-Datei mit der mitgelieferten Importfunktion kopieren:

python3 deploy/import_dashboard_history.py \
  /data/llama-dashboard/history.sqlite3 \
  /opt/athena-deck-dev/runtime/state/dashboard-history.sqlite3

Der Import nutzt SQLite-Backup und schließt die laufende WAL-Datei ein. Die Quelle bleibt unverändert; ein vorhandenes Deck-Ziel wird nicht überschrieben. Im installierten Deck liegt die neue Datenbank allgemein unter <Installationsverzeichnis>/state/dashboard-history.sqlite3. Auf einem frisch installierten Debian-Server ohne alte Datenbank beginnt Deck automatisch eine neue History. Historische Tokenzahlen und Modellwechsel aus dem alten Router bleiben nach dem Import erhalten; neue Messungen werden als Deck-Messungen fortgeführt. Das alte Dashboard muss dafür nicht gestoppt werden.