diff --git a/docs/platform/llm-server/monitoring/GNMON-000-DOC_Index.md b/docs/platform/llm-server/monitoring/GNMON-000-DOC_Index.md index 2690ad9..9b639be 100644 --- a/docs/platform/llm-server/monitoring/GNMON-000-DOC_Index.md +++ b/docs/platform/llm-server/monitoring/GNMON-000-DOC_Index.md @@ -96,6 +96,50 @@ Betreiberentscheidung 04.11.2026: Benachrichtigung per E-Mail. - Offen bis M5: echter SMTP-Versand gegen den Betreiber-Mailserver (Operator-Schritt: secrets-Datei + Testmail). +### M3: Blazor-Dashboard (implementiert 04.11.2026, Workstation) + +M3.1–M3.4 in kleinen visuell abnehmbaren Schritten umgesetzt +(Betreiberwunsch 04.11.2026): + +- **M3.1 GUI-Gerüst** (.NET 10, Interactive Server): Layout/Nav im + Hacker-TUI-Stil, Catppuccin-Mocha-Palette, Monospace, ASCII-Button-Navi + mit invers-grünem Aktivzustand; Bootstrap restlos entfernt. +- **M3.2 Live-Ressourcen:** CPU/RAM/Disk-Kacheln mit ASCII-Progressbars + (Schwellenfarben passend zu den vmalert-Severities) im 2-s-Takt; + VictoriaMetricsClient (PromQL, kulturinvariantes Parsing). +- **M3.3 GPU-Detailseite:** Karten-Discovery über `gn_gpu_up`, + Live-Util/VRAM/Temp/Power/Lüfter je Karte; ASCII-Spinner-Komponente + (dots/braille/line, Lüfter-Spinner mit RPM-gekoppelter Rotation); + Reconnect-Dialog deutsch lokalisiert. +- **M3.4 Verläufe — Betreiberentscheidung: Braille-Chart** (btop-Stil). + Vergleichsvarianten ASCII-Sparkline, div-Block-Chart und ApexCharts + wurden bewertet und entfernt (ApexCharts-Paket inkl. CDN-Referenz + raus; null JS-Chart-Abhängigkeiten). Die `AsciiBrailleChart`-Komponente: + 8-Punkt-Braille (2×4 Dots je Zeichen), vertikaler Farbgradient grün + (unten) → gelb → rot (oben), Liniengrid hinter der Grafik + (Betreiberentscheidung gegen Punkte- und Strichgrid), Breite per + JS-Messung von Containerbreite und echter Zeichenbreite + (Range-API, Font-Fallback-tolerant), Proben linear interpoliert. +- **Schrift:** DejaVu Sans Mono wird mit der Website ausgeliefert + (wwwroot/fonts, Bitstream-Vera-Lizenz beigelegt) — vollständige + Braille- und Box-Drawing-Abdeckung, deterministische Metriken. +- **Live-Verzögerung CPU:** statt Fenster-Mittelung läuft die Kette + Scrape 5 s (vorher 10 s) → `rate[10s]` roh → EMA-Glättung (α 0,65) im + Dashboard; Reaktion auf Lastsprünge < 10 s statt Minuten. +- **Fallendokumente (Implementierungsbefunde):** + - Blazor-CSS-Isolation greift nicht auf NavLink-Kindkomponenten; + Nav-Styles laufen über `::deep` (sonst stiller Regelverlust). + - `double.TryParse` von PromQL-Strings ist kulturabhängig: de-DE liest + den Punkt als Gruppentrenner; Parsing invariant. + - Braille-Dot-Füllung muss je Zeichen bottom-up erfolgen (Intra-Zellen- + Inversion macht Kurvenkanten verkehrt herum). + - Leere Chart-Zellen als U+2800 statt Leerzeichen: sonst driftet die + Zeile bei Font-Fallback (abweichende Vorschübe). + - Gemessene Containerbreite muss über Daten-Refresh persistiert + werden (Reset pro Update lies die Grafik zusammenschrumpfen). + - Per-page Render Mode hält das Layout statisch: Layout-Spinner nur + als CSS-Animation, Komponenten-Animation nur in Seiteninhalten. + ## Noch offen 1. Punkte 1–6 aus GNMON-001 v2.0 Abschnitt 9 (Metrics-Account-Identität, @@ -105,8 +149,7 @@ Betreiberentscheidung 04.11.2026: Benachrichtigung per E-Mail. keinen Schwellwert-Alarm (Motivation des Vorfalls). Vorschlag: `vmalert`-Regeln gegen VictoriaMetrics mit Notification-Kanal; Kanal- Auswahl (Mail/ntfy/Matrix) ist eine Betreiberentscheidung. -3. M3 (Blazor-Dashboard) auf der Workstation; Journald-Ingestion nach - Laptop-Neustart verifizieren (M2-Operator-Schritt). -4. M5 Server-Rollout auf `ghostnet-ki` nach Behebung des GPU0-Kühldefekts - (GNAI-010 10.10): System-Scope-Rollen, Konten 983/984, nftables, - Abnahmekriterien aus GNMON-001 Abschnitt 10. +3. M5 Server-Rollout auf `ghostnet-ki` nach Behebung des GPU0-Kühldefekts + (GNAI-010 10.10): System-Scope-Rollen, Konten 983/984, nftables, + Abnahmekriterien aus GNMON-001 Abschnitt 10, Dashboard-Container + (Containerfile, Digest-Pin, OIDC/Keycloak, NPM-Ingress). diff --git a/llm-server/monitoring/ansible/roles/gnmon_victoria_metrics/defaults/main.yml b/llm-server/monitoring/ansible/roles/gnmon_victoria_metrics/defaults/main.yml index 82a569e..2052c77 100644 --- a/llm-server/monitoring/ansible/roles/gnmon_victoria_metrics/defaults/main.yml +++ b/llm-server/monitoring/ansible/roles/gnmon_victoria_metrics/defaults/main.yml @@ -16,7 +16,7 @@ gnmon_victoria_metrics_data_dir: "{{ gnmon_victoria_metrics_user_home }}/.local/ gnmon_victoria_metrics_port: 8428 gnmon_victoria_metrics_retention_days: 60 -gnmon_victoria_metrics_scrape_interval_seconds: 10 +gnmon_victoria_metrics_scrape_interval_seconds: 5 # node_exporter target (same host; NetworkMode=host in the quadlet). gnmon_victoria_metrics_node_target: "127.0.0.1:9100" diff --git a/llm-server/monitoring/src/Ghostnet.Dashboard/Components/App.razor b/llm-server/monitoring/src/Ghostnet.Dashboard/Components/App.razor index f124506..41c3277 100644 --- a/llm-server/monitoring/src/Ghostnet.Dashboard/Components/App.razor +++ b/llm-server/monitoring/src/Ghostnet.Dashboard/Components/App.razor @@ -10,6 +10,7 @@ + diff --git a/llm-server/monitoring/src/Ghostnet.Dashboard/Components/AsciiBrailleChart.razor b/llm-server/monitoring/src/Ghostnet.Dashboard/Components/AsciiBrailleChart.razor new file mode 100644 index 0000000..545bfeb --- /dev/null +++ b/llm-server/monitoring/src/Ghostnet.Dashboard/Components/AsciiBrailleChart.razor @@ -0,0 +1,191 @@ +@* btop-style braille chart: 2x4 dot cells per character, vertical color + gradient (green -> yellow -> red), one span per text row (cheap DOM). + The dot grid is interpolated to the measured container width so the + chart always spans the full panel. *@ + +@inject IJSRuntime JS + +
+ @for (var r = 0; r < _rowStrings.Count; r++) + { + @_rowStrings[r] + } +
+ +@code +{ + /// Sample values in display order (oldest first). + [Parameter] + public IReadOnlyList? Values { get; set; } + + /// Number of text rows (4 dot levels each). + [Parameter] + public int Rows { get; set; } = 22; + + /// Total pixel height of the chart. + [Parameter] + public int HeightPx { get; set; } = 220; + + /// + /// Absolute scale maximum (e.g. 100 for percent metrics). + /// When null, the chart auto-scales to the window maximum. + /// + [Parameter] + public double? Max { get; set; } + + /// Background grid style: lines (default), dots or none. + [Parameter] + public string GridStyle { get; set; } = "lines"; + + /// Fallback dot columns when the container width is unknown + /// (prerendering); replaced by the measured width after the first + /// interactive render. + [Parameter] + public int WidthDots { get; set; } = 160; + + private ElementReference _container; + private ElementReference _rowSpans; + private List _rowStrings = []; + private List _rowColors = []; + private int _charCols = 40; + private bool _widthMeasured; + + private int RowPx => Math.Max(6, HeightPx / Rows); + + protected override void OnParametersSet() + { + // Only fall back before the first measurement; later data refreshes + // must keep the measured width (the reset shrank the chart back to + // half width every 10-second update). + if (!_widthMeasured) + { + _charCols = Math.Max(10, WidthDots / 2); + } + BuildRows(); + } + + protected override async Task OnAfterRenderAsync(bool firstRender) + { + if (!firstRender) + { + return; + } + try + { + // Measure the real container width AND the real per-glyph + // advance (font fallbacks can render braille wider than the + // 0.6em monospace default; fixed ratios under-filled panels). + var width = await JS.InvokeAsync("gnmon.clientWidth", _container); + var advance = await JS.InvokeAsync("gnmon.charAdvance", _rowSpans); + if (width > 0 && advance > 0) + { + _charCols = Math.Max(10, (int)(width / advance)); + _widthMeasured = true; + BuildRows(); + StateHasChanged(); + } + } + catch (JSDisconnectedException) + { + // Circuit already gone; next render retries. + } + catch (InvalidOperationException) + { + } + } + + private void BuildRows() + { + _rowStrings = []; + _rowColors = []; + + var dotsHigh = Rows * 4; + var dotCols = _charCols * 2; + + // Interpolate samples onto the dot grid (btop-style full-width). + var grid = new double[dotCols]; + if (Values is not { Count: > 1 }) + { + if (Values is { Count: 1 }) + { + Array.Fill(grid, Values[0]); + } + } + else + { + for (var d = 0; d < dotCols; d++) + { + var t = dotCols == 1 + ? 0 + : d / (double)(dotCols - 1) * (Values.Count - 1); + var i0 = (int)Math.Floor(t); + var i1 = Math.Min(i0 + 1, Values.Count - 1); + var frac = t - i0; + grid[d] = Values[i0] * (1 - frac) + Values[i1] * frac; + } + } + + var max = Max; + if (max is null or 0) + { + max = Math.Max(grid.DefaultIfEmpty(1).Max(), 1e-9); + } + + for (var visualRow = 0; visualRow < Rows; visualRow++) + { + _rowColors.Add(GradientColor(visualRow)); + var row = new char[_charCols]; + var charRowFromBottom = Rows - 1 - visualRow; + + for (var cx = 0; cx < _charCols; cx++) + { + var pattern = 0; + for (var dx = 0; dx < 2; dx++) + { + var column = grid[cx * 2 + dx]; + if (column <= 0 && charRowFromBottom > 0) + { + continue; + } + var heightDots = (int)Math.Clamp(column / max.Value * dotsHigh, 0, dotsHigh); + for (var k = 0; k < 4; k++) + { + // k=0 is the LOWEST dot of the cell: the fill grows + // bottom-up inside every character (inversion bug + // found 04.11.2026). + var dotLevel = charRowFromBottom * 4 + k + 1; + if (heightDots < dotLevel) + { + continue; + } + var cellRow = 3 - k; // cell row 0 = top of the glyph + pattern |= dx == 0 + ? (cellRow < 3 ? 1 << cellRow : 1 << 6) + : (cellRow < 3 ? 1 << (cellRow + 3) : 1 << 7); + } + } + // U+2800 for empty cells: uniform braille metrics per row + // (mixed space/braille fallback fonts shift bars). + row[cx] = pattern == 0 ? '\u2800' : (char)(0x2800 + pattern); + } + _rowStrings.Add(new string(row)); + } + } + + /// Green (bottom) -> yellow -> red (top), Catppuccin tones. + private string GradientColor(int visualRow) + { + var t = Rows <= 1 ? 1 : (Rows - visualRow) / (double)(Rows - 1); + return t <= 0.5 + ? Lerp(0xa6, 0xe3, 0xa1, 0xf9, 0xe2, 0xaf, t / 0.5) + : Lerp(0xf9, 0xe2, 0xaf, 0xf3, 0x8b, 0xa8, (t - 0.5) / 0.5); + } + + private static string Lerp(int r1, int g1, int b1, int r2, int g2, int b2, double t) + { + var r = (int)Math.Round(r1 + (r2 - r1) * t); + var g = (int)Math.Round(g1 + (g2 - g1) * t); + var b = (int)Math.Round(b1 + (b2 - b1) * t); + return $"rgb({r},{g},{b})"; + } +} diff --git a/llm-server/monitoring/src/Ghostnet.Dashboard/Components/Layout/MainLayout.razor b/llm-server/monitoring/src/Ghostnet.Dashboard/Components/Layout/MainLayout.razor index af6a5c2..514d970 100644 --- a/llm-server/monitoring/src/Ghostnet.Dashboard/Components/Layout/MainLayout.razor +++ b/llm-server/monitoring/src/Ghostnet.Dashboard/Components/Layout/MainLayout.razor @@ -15,8 +15,8 @@
- ● ONLINE - Quelle: VictoriaMetrics · Loki · Alertmanager — M3.1a ASCII-Nav + LIVE + Quelle: VictoriaMetrics · Loki · Alertmanager — M3.3 GPU-Detail ▮
diff --git a/llm-server/monitoring/src/Ghostnet.Dashboard/Components/Layout/ReconnectModal.razor b/llm-server/monitoring/src/Ghostnet.Dashboard/Components/Layout/ReconnectModal.razor index e740b0c..5beeb59 100644 --- a/llm-server/monitoring/src/Ghostnet.Dashboard/Components/Layout/ReconnectModal.razor +++ b/llm-server/monitoring/src/Ghostnet.Dashboard/Components/Layout/ReconnectModal.razor @@ -7,22 +7,22 @@

- Rejoining the server... + Verbindung wird wiederhergestellt ...

- Rejoin failed... trying again in seconds. + Wiederherstellung fehlgeschlagen ... neuer Versuch in Sekunden.

- Failed to rejoin.
Please retry or reload the page. + Wiederherstellung fehlgeschlagen.
Bitte erneut versuchen oder die Seite neu laden.

- The session has been paused by the server. + Die Sitzung wurde vom Server pausiert.

- Failed to resume the session.
Please retry or reload the page. + Sitzung konnte nicht fortgesetzt werden.
Bitte erneut versuchen oder die Seite neu laden.