> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/learn-the-platform/de/modul-9-monitoring-und-fehlerbehebung/01-dashboard-health.md).
# Dashboard & Systemzustand
## Überwachungsphilosophie
VergeOS verfolgt einen **Single-Pane-of-Glass** Ansatz zur Infrastrukturüberwachung. Jede Komponente -- Rechenleistung, Speicher, Netzwerk und Hardwarezustand -- ist über die integrierte Benutzeroberfläche sichtbar, ohne externe Überwachungstools. Das System bietet Echtzeitmetriken, historische Trends und Ereignisprotokolle auf jeder Ebene: einzelne Knoten, Cluster, vSAN-Ebenen, Netzwerke, VMs und Mandanten.
Diese Seite behandelt die wichtigsten Überwachungsbereiche, die Sie täglich verwenden, um den Systemzustand zu beurteilen und Probleme zu beheben.
```mermaid
graph TB
subgraph ui["VergeOS-Benutzeroberfläche — Überwachungshierarchie"]
direction TB
MAIN["Haupt-Dashboard
Systemweite Übersicht"]
CLUSTER["Cluster-Ansichten
Aggregierte Ressourcenpools"]
NODE["Knoten-Dashboards
Hardware & Metriken pro Knoten"]
VSAN["vSAN-Status
Zustand & Kapazität der Ebene"]
NET["Netzwerkstatus
Konnektivität & Verkehr"]
VM["VM- / Mandanten-Dashboards
Metriken pro Workload"]
MAIN --> CLUSTER
MAIN --> VSAN
MAIN --> NET
CLUSTER --> NODE
NODE --> VM
end
style ui fill:#f0f4ff,stroke:#336
```
## Knoten-Dashboard
Das **Knoten-Dashboard** ist Ihre primäre Oberfläche zur Überwachung einzelner physischer (oder virtueller) Server in der Umgebung. Navigieren Sie dorthin über **Infrastruktur → Knoten**, und wählen Sie dann einen bestimmten Knoten.
### Knotenstatusinformationen
Am oberen Rand des Knoten-Dashboards finden Sie die wichtigsten Statusfelder:
| Feld | Beschreibung |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Status** | Der aktuelle Betriebszustand -- Läuft oder Offline; während Wartungsabläufen kann er Migration, Wartungsmodus oder Verlassen des Wartungsmodus anzeigen |
| **Wartungsmodus** | Ob sich der Knoten im Wartungszustand befindet (Workloads wurden weg migriert) |
| **Zuletzt eingeschaltet** | Zeitstempel des letzten Starts |
| **IPMI-Status** | Status der Intelligent Platform Management Interface |
| **IPMI-Netzwerkadresse** | BMC-/iDRAC-/iLO-Verwaltungs-IP für den Fernzugriff |
| **Systemversion** | Aufschlüsselung der VergeOS-Versionen -- OS-, vSAN-, Appserver- und Kernel-Versionen |
### Hardwarekonfiguration
Das Dashboard zeigt außerdem das physische Hardwareprofil:
* **CPU** -- Prozessormodell und Generation
* **CPU-Kerne** -- Anzahl der physischen Kerne
* **RAM** -- Gesamtkapazität des physischen Arbeitsspeichers
* **Ausfallsicherer RAM** -- Für Ausfallszenarien reservierter Speicher
* **Überbelegter RAM** -- Für Überbuchung verfügbarer Speicher
* **Cluster** -- Zu welchem Cluster dieser Knoten gehört
* **Modell / Asset-Tag** -- Hardwareplattform und Inventar-Asset-Tag
### CPU-Auslastungsgrafik
Die CPU-Auslastungsgrafik ist eine der am häufigsten konsultierten Metriken. Sie bietet Echtzeit- und historische Trendvisualisierung mit mehreren Aufschlüsselungskategorien:
| Metrik | Was angezeigt wird |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| **Gesamte CPU** | Aggregierte CPU-Auslastung über alle Kerne |
| **Kern mit der höchsten Auslastung** | Der einzelne Kern mit der höchsten Auslastung (hilft, Single-Thread-Flaschenhälse zu identifizieren) |
| **Benutzer** | Zeit, die in Benutzerprozessen verbracht wird |
| **System** | Zeit, die in Kernelraum-Operationen verbracht wird |
| **I/O-Wartezeit** | Zeit, in der die CPU untätig auf den Abschluss von I/O-Operationen wartet |
| **VM-Auslastung** | Von auf diesem Knoten laufenden virtuellen Maschinen verbrauchte CPU |
| **IRQ** | Zeit, die mit der Behandlung von Hardware- und Software-Interrupts verbracht wird |
### Knoten-Statistikkarten
Unterhalb der CPU-Grafik zeigt das Dashboard Schnellübersicht-Metrikkarten:
* **Physischer RAM** -- Aktuelle Speicherauslastung in Prozent und Gesamtkapazität
* **Virtueller RAM** -- Zugewiesener virtueller Speicher (typischerweise 0 %, wenn nicht überbucht)
* **Temperatur** -- Aktuelle Knotentemperatur mit einer farbcodierten Anzeige (grün / gelb / rot je nach Schwellenwerten)
* **Laufende Maschinen** -- Anzahl aktiver VMs, vNet-Container und Systemdienste auf diesem Knoten
* **Kernauslastung** -- Prozentsatz der derzeit genutzten CPU-Kerne
* **RAM-Auslastung** -- Speichernutzung über alle laufenden Maschinen
## Bereich Hardware-Ressourcen
Der untere Abschnitt des Knoten-Dashboards bietet detaillierte Ansichten aller physischen Hardwarekomponenten.
### Laufwerke
Alle physischen Laufwerke, die an den Knoten angeschlossen sind, werden mit vollständigen Gesundheitsdaten aufgelistet:
| Spalte | Zweck |
| ----------------------- | -------------------------------------------------------------- |
| **Status** | Online-/Offline-Anzeige |
| **Namen** | Gerätekennung (z. B., `nvme0n1`, `sda`) |
| **Modell** | Hersteller und Modellnummer |
| **Tier** | vSAN-Speicherebenenzuordnung (bei der Installation festgelegt) |
| **vSAN-Laufwerks-ID** | Eindeutige Kennung innerhalb des vSAN |
| **Firmware** | Aktuelle Firmwareversion des Laufwerks |
| **Bus** | Art der Hardware-Busverbindung (NVMe, SATA, SAS) |
| **Nutzung** | Kapazitätsauslastung mit visuellem Fortschrittsbalken |
| **Wird repariert** | Ob das Laufwerk derzeit neu aufgebaut wird |
| **Lese-/Schreibfehler** | Fehlerzähler für proaktive Zustandsüberwachung |
Sie können auf jedes Laufwerk klicken, um dessen **S.M.A.R.T.** Diagnosen zu öffnen -- neu zugeordnete Sektoren, Temperatur, Betriebsstunden, Wear-Leveling und andere prädiktive Ausfallindikatoren.
### Netzwerkschnittstellenkarten (NICs)
Jede NIC im Knoten wird mit Betriebs- und Fabric-Status angezeigt:
* **Status** -- Hoch oder herunter
* **Fabric-Status** -- Kern-Fabric-Konnektivität. **Bestätigt** zeigt an, dass die NIC ordnungsgemäß integriert ist; **Kein Pfad** und **Beeinträchtigt** sind die Problemstatus, auf die Sie achten sollten; **Keine** wird für NICs angezeigt, die nicht Teil der Kern-Fabric sind. Ein Globus-Symbol zeigt NICs an, die mit der Kern-Fabric verbunden sind
* **Port** -- Physische Portkennung auf der NIC
* **Namen** -- Schnittstellenkennung (z. B., `enp2s0f0`)
* **Modell / Hersteller / Treiber** -- Hardware- und Softwaredetails
* **Geschwindigkeit** -- Ausgehandelte Link-Geschwindigkeit (z. B. 10000 Mb/s, 25000 Mb/s)
* **MAC** -- Hardware-MAC-Adresse
* **Netzwerk** -- Zugeordnetes VergeOS-Netzwerk
* **RX / TX** -- Insgesamt empfangene und übertragene Daten
* **RX / TX-Rate** -- Aktuelle Übertragungsraten
### Zusätzliche Hardwareabschnitte
| Abschnitt | Was angezeigt wird |
| ---------------------- | ------------------------------------------------------------------------------------------------- |
| **Speichermodule** | Installierter RAM -- Modulanzahl, Kapazität, Typ und Spezifikationen |
| **LLDP-Nachbarn** | Daten des Link Layer Discovery Protocol -- verbundener Switch, Portzuordnungen, Netzwerktopologie |
| **PCI-Geräte** | Alle PCI/PCIe-Geräte mit Buszuordnungen und Passthrough-Verfügbarkeit |
| **SR-IOV-NIC-Geräte** | Anzahl der virtuellen Funktionen und Zuweisungsstatus für SR-IOV-fähige NICs |
| **NVIDIA-vGPU-Geräte** | GPU-Modell, verfügbare vGPU-Profile und Zuweisungsstatus |
| **USB-Geräte** | Angeschlossene USB-Geräte mit Passthrough-Fähigkeit |
## Überwachung des Fabric-Status
Das **Core Fabric** ist das Backbone-Netzwerk, das alle VergeOS-Knoten verbindet. Die Überwachung des Fabric-Zustands ist entscheidend, da eine Beeinträchtigung der Fabric vSAN-Replikation, VM-Live-Migration und die Kommunikation zwischen Knoten beeinträchtigt.
Achten Sie in der NIC-Tabelle jedes Knotens auf die **Fabric-Status** Spalte:
* **Bestätigt** -- Die NIC ist ordnungsgemäß in die Kern-Fabric integriert und kommuniziert mit Peer-Knoten
* **Kein Pfad** oder **Beeinträchtigt** -- Problemstatus, die anzeigen, dass die NIC nicht erfolgreich an der Fabric teilnimmt. Kann auf ein Kabelproblem, eine Fehlkonfiguration des Switches oder einen NIC-Ausfall hinweisen
* **Keine** -- Wird für NICs angezeigt, die nicht Teil der Kern-Fabric sind (z. B. externe Netzwerk-NICs)
{% hint style="success" %}
**Schneller Fabric-Gesundheitscheck**
Navigieren Sie vom Haupt-Dashboard zu **Infrastruktur → Knoten** und prüfen Sie den NIC-Fabric-Status über alle Knoten hinweg. Jede Kern-Fabric-NIC sollte **Bestätigt**Bestätigt **Kein Pfad** oder **Beeinträchtigt** Problemstatus erfordert sofortige Untersuchung -- überprüfen Sie die physische Verkabelung, die Portkonfiguration des Switches und den Status des NIC-Treibers.
{% endhint %}
## Ereignisprotokolle
Jedes Knoten-Dashboard enthält einen **Ereignisprotokolle** Abschnitt, der systembezogene Ereignisse für diesen Knoten anzeigt. Ereignisse werden nach Schweregrad klassifiziert:
| Ebene | Beschreibung | Beispiele |
| ------------ | -------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| **Kritisch** | Systemgefährdende Zustände, die sofortiges Handeln erfordern | Knoten offline, vSAN beeinträchtigt |
| **Fehler** | Fehler, die die Funktionalität beeinträchtigen | Laufwerksausfall, fehlgeschlagene Vorgänge |
| **Warnung** | Zustände, die sich verschärfen können, wenn sie nicht behoben werden | Temperaturschwellenwert überschritten, Laufwerksfehler nehmen zu |
| **Meldung** | Normale Betriebsereignisse | Änderungen des Energiezustands, Übergänge in den Wartungsmodus, VM-Migrationen |
### Häufige Protokolleinträge
* **Temperaturwarnungen** -- `"Der Kern hat die Warntemperatur '96 / 95' erreicht"` zeigt an, dass ein CPU-Kern den konfigurierten Schwellenwert überschritten hat. Die beiden Zahlen sind der aktuelle Messwert und der berechnete Warnschwellenwert für diese CPU. Standardmäßig (`max_core_temp = 0` in Cluster-Einstellungen → Knotentemperatur) fragt VergeOS für jede CPU das hardwareseitig angegebene Maximum ab und löst die Warnung bei `max_core_temp_warn_perc` (Standard **10%**) unterhalb dieses Maximums
* **Laufwerksstatusereignisse** -- Benachrichtigungen, wenn Laufwerke offline gehen, mit der Reparatur beginnen oder neue Lese-/Schreibfehler melden
* **Änderungen des Energiezustands** -- Aufzeichnungen von Knoten-Neustarts, Herunterfahrten und Einschaltvorgängen
* **Übergänge in den Wartungsmodus** -- Protokolle, wenn ein Knoten in den Wartungsmodus wechselt oder ihn verlässt
Jeder Protokolleintrag enthält den **Zeitstempel**, **source** (z. B. `node1`), und ein **detaillierte Nachricht**. **Mehr anzeigen** um auf den vollständigen Protokollverlauf zuzugreifen.
## Knotenverwaltungsaktionen
Das Menü auf der linken Seite im Knoten-Dashboard bietet grundlegende Verwaltungsoperationen:
### Energieverwaltung
* **Ein-/Ausschalten** -- Standard-Energieoperationen über IPMI
* **Neu starten** -- Schonender Neustart des Knotens
* **Strom hart ausschalten** -- Erzwingen des Herunterfahrens (nur verwenden, wenn schonende Methoden versagen)
### Wartungsmodus
**Aktivieren Sie immer den Wartungsmodus, bevor Sie Hardwareänderungen oder Systemaktualisierungen durchführen.** Wenn Sie einen Knoten in den Wartungsmodus versetzen, migriert VergeOS geeignete laufende Workloads live auf andere Knoten im Cluster. VMs mit GPU-Passthrough oder einem Host-Passthrough-CPU-Typ (ebenso USB-Passthrough oder SR-IOV-NICs) können nicht migriert werden und müssen heruntergefahren werden -- manuell oder automatisch, wenn die Migrationsmethode der VM auf Automatisch gesetzt ist.
### Remote-Konsole
Bietet direkten Konsolenzugriff auf den Knoten über IPMI/iDRAC/iLO. Verwenden Sie dies für Fehlerszenarien, in denen die VergeOS-Oberfläche nicht erreichbar ist oder Sie Zugriff auf BIOS-Ebene benötigen.
### Weitere Aktionen
* **Bearbeiten** -- Knoten-Einstellungen ändern (Failover-RAM, Überbelegung, Tags)
* **Hochskalieren** -- Von diesem Knoten aus Ressourcen zum Cluster hinzufügen
* **Diagnose** -- Zugriff auf Diagnosewerkzeuge auf Knotenebene (ARP-Scan, ethtool, IPMI-Sensoren, S.M.A.R.T.-Tests und mehr)
* **Aktualisieren** -- Alle Dashboard-Daten zwangsweise aktualisieren
## Ansichten auf Cluster-Ebene
Während Knoten-Dashboards den Zustand einzelner Server anzeigen, **Cluster-Ansichten** bieten eine aggregierte Ressourcenauslastung über alle Knoten in einem Cluster.
Navigieren Sie zu **System → Cluster** um Folgendes zu sehen:
* **Gesamte CPU** -- Kombinierte Verarbeitungskapazität und Auslastung über alle Knoten
* **Gesamter RAM** -- Aggregierter Speicher mit Aufschlüsselung der Auslastung
* **Knotenzahl** -- Anzahl aktiver gegenüber der Gesamtzahl der Knoten im Cluster
* **Workload-Verteilung** -- Wie VMs und Dienste auf die Knoten verteilt sind
Cluster-Ansichten sind für die Kapazitätsplanung unerlässlich -- sie helfen Ihnen zu erkennen, wann ein Cluster sich den Ressourcengrenzen nähert und wann es Zeit ist, mit zusätzlichen Knoten zu skalieren.
## vSAN-Statusübersicht
Der vSAN-Status ist vom Haupt-Dashboard aus zugänglich, indem Sie auf die **vSAN-Tiers** Zählerbox klicken, oder über **Infrastruktur → vSAN-Ebenen**.
Zu den wichtigsten Indikatoren gehören:
* **Ebenenzustand** -- Status pro Ebene, angezeigt über das `Status` Feld (`online`, `nicht redundant`, `wird repariert`, `kein Speicherplatz`, `offline`, ...) und die `redundant` boolesche Variable. Das `laufend` Flag zeigt an, ob derzeit ein Journal Walk läuft, nicht den allgemeinen Zustand der Ebene (eine gesunde, inaktive Ebene zeigt `working=false`)
* **Kapazität pro Ebene** -- Gesamter, genutzter und verfügbarer Speicher für jede Ebene
* **Redundanzstatus** -- Ob die Anforderungen an die Datenredundanz erfüllt sind (kritisch nach einem Laufwerks- oder Knotenausfall)
* **Reparaturstatus** -- Aktive Reparaturvorgänge und Fortschritt (sollten im Normalbetrieb allesamt 0 sein)
* **Geräteanzahl** -- Anzahl der Laufwerke, die an jeder Ebene teilnehmen
{% hint style="warning" %}
**Schwellenwerte für Speicher-Drosselung**
VergeOS wendet automatisch I/O-Drosselung an, wenn sich der Speicher füllt:
* **Unter 91 %** -- Normalbetrieb, keine Drosselung
* **91–95 %** -- Drosselung bei geringem Speicherplatz beginnt (10 ms zusätzliche Latenz)
* **96%+** -- Kritische Drosselung (50 ms zusätzliche Latenz) mit erheblicher Leistungsminderung
Überwachen Sie die Ebenenkapazität proaktiv und konfigurieren Sie Warnungen, bevor diese Schwellenwerte erreicht werden.
{% endhint %}
## Netzwerkstatus
Die Netzwerkgesundheit wird von **Netzwerke** in der Hauptnavigation überwacht. Für jedes Netzwerk (extern, intern, DMZ, Mandantennetzwerke) können Sie Folgendes anzeigen:
* **Konnektivitätsstatus** -- Ob das Netzwerk läuft und erreichbar ist
* **Verkehrsdaten** -- RX-/TX-Volumen und -Raten pro Netzwerk
* **Verbundene Maschinen** -- Welche VMs und Dienste angeschlossen sind
* **Firewall-Regel-Trefferraten** -- Aktivität bei konfigurierten Firewall-Regeln
* **Netzwerkbezogene Protokolle** -- Ereignisse, die auf dieses spezielle Netzwerk beschränkt sind
## Ansicht laufender Maschinen
Jedes Knoten-Dashboard enthält einen **Laufende Maschinen** Abschnitt, der alle aktiven Workloads anzeigt:
| Spalte | Beschreibung |
| --------------------- | ---------------------------------------------------- |
| **Status** | Anzeige des Laufzustands |
| **Typ** | Virtuelle Maschine, vNet-Container oder Systemdienst |
| **Namen** | Maschinenkennung |
| **CPU-Kerne** | Anzahl der zugewiesenen Kerne |
| **CPU-Auslastung** | Aktueller Prozentsatz der Prozessorauslastung |
| **RAM** | Zugewiesener Speicher mit Auslastungsprozentsatz |
| **Zuletzt gestartet** | Zeitstempel des Startzeitpunkts des Workloads |
Zu den gängigen Maschinentypen gehören VMs, vNet-Container (Netzwerkdienste) und Systemdienste (NAS, DMZ, externes Netzwerk usw.).
{% hint style="info" %}
**Kommen Sie von VMware oder Nutanix?**
In VergeOS befinden sich Knotenhardware, Clusterressourcen, Speichergesundheit, Netzwerkstatus und Workload-Metriken alle in derselben integrierten Benutzeroberfläche -- kein separater Verwaltungsserver, keine separate Überwachungssuite und keine CLI müssen für die tägliche Übersicht installiert werden.
{% endhint %}
## Best Practices
### Tägliche Gesundheitsprüfungen
Überprüfen Sie Knotentemperaturen, Laufwerk-Fehlerzähler und Fabric-Status über alle Knoten hinweg. Beheben Sie alle Fabric-NICs, die **Kein Pfad** oder **Beeinträchtigt**Kein Pfad
### Wartungsmodus verwenden
Aktivieren Sie immer den Wartungsmodus vor Hardwareänderungen, Firmware-Updates oder Systemaktualisierungen. Geeignete Workloads werden live migriert, bevor Sie den Knoten anfassen; VMs, die nicht live migriert werden können (GPU-Passthrough, Host-Passthrough-CPU-Typ, USB-Passthrough, SR-IOV) müssen heruntergefahren werden.
### vSAN-Kapazität überwachen
Halten Sie die Ebenenauslastung unter 85 %, um Leistungsreserven zu erhalten. Konfigurieren Sie Warnabonnements (im nächsten Abschnitt behandelt), damit Sie benachrichtigt werden, bevor Drosselungsschwellenwerte erreicht werden.
### Protokolle regelmäßig prüfen
Prüfen Sie regelmäßig die Ereignisprotokolle auf Temperaturwarnungen, Laufwerksfehler und unerwartete Zustandsänderungen. Probleme frühzeitig zu erkennen, verhindert Kaskadenausfälle.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.verge.io/learn-the-platform/de/modul-9-monitoring-und-fehlerbehebung/01-dashboard-health.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.