# Monitoring – Dokumentationsindex und Projektstand

**Dokumenten-ID:** GNMON-000-DOC
**Stand:** 2026-10-19
**Status:** Planungsabschluss; Implementierung noch nicht begonnen

## Dokumente

| Dokument | Zweck / Zielgruppe |
| --- | --- |
| [GNMON-001-PLAN_Architecture.md](GNMON-001-PLAN_Architecture.md) | Host-Monitoring: Metriken, Collector, Dashboard, Anbindung Encoding; Infrastrukturadministratoren |

## Bestätigter Stand

- Planungsabschluss 19.10.2026: host-weites Monitoring für `ghostnet-ki`,
  fachlich getrennt vom Encoding-Workload (aus GNENC ausgegliedert).
- Komponenten: host-seitiger Metrics-Collector (systemd-Service, schreibt
  `state/system.json` alle 10 s) und Dashboard-Container unter `gn-dashboard`
  (984).
- Metriken: CPU, RAM, Disk (Root + NFS-Export), GPU-Util, VRAM.
- Dashboard: Python/Flask, read-only Mounts, kein GPU-/Schreibzugriff;
  erreichbar über NPM (CT-103) mit Keycloak.
- Anbindung Encoding: Dashboard liest `state/jobs/*.json` read-only
  (`state/` group-readable via `gn-media`).
- Noch nicht implementiert: Konto `gn-dashboard`, Collector-Service,
  Dashboard-Quadlet, Image-Bau.

## Noch offen

1. NPM-Hostname und Keycloak-Client (Umsetzung).
2. Collector-Identität (root vs. Metrics-Account mit `render`-Gruppe).
3. Erweiterung um LLM-Metriken (später).