Hyper-V-Host-Check – Referenz

Alle Konfigurationsfelder, Schwellenwerte und Ergebniszustände des Hyper-V-Host-Checks in octoja.

Hyper-V-Host-Check – Referenz

Der Hyper-V-Host-Check – in der Check-Auswahl als Microsoft Hyper-V Host aufgeführt – läuft auf dem octoja-Agenten, der auf einem Hyper-V-Host installiert ist, und meldet den Zustand auf Host-Ebene: den Status virtueller Maschinen, Hyper-V-Replica, Checkpoints, Integrationsdienste und die Belegung von Speichervolumes. Der Check läuft alle 15 Minuten; das Intervall lässt sich nicht ändern. Er unterscheidet sich vom Check Hyper-V VM-Status, der je VM ausgeführt wird.

Konfigurationsfelder

Die Tabelle listet jedes Feld in der Reihenfolge auf, in der es im Check-Editor erscheint.

Feld	Typ	Erforderlich	Standard	Beschreibung
VMs, die laufen müssen	Liste von Strings	Nein	—	Virtuelle Maschinen, die laufen müssen; jede, die nicht läuft, setzt das Ergebnis auf Kritisch
Zu ignorierende VMs	Liste von Strings	Nein	—	Virtuelle Maschinen, die von Zählungen und Benachrichtigungen ausgenommen sind; eine ignorierte VM ist auch dann ausgenommen, wenn sie zusätzlich in der Liste der Pflicht-VMs steht
Checkpoint-Alter Warnung (Tage)	Zahl	Nein	7	Warnt, wenn der älteste Checkpoint einer VM älter als dieser Wert ist
Checkpoint-Anzahl Warnung	Zahl	Nein	3	Warnt, wenn eine VM mehr Checkpoints als diesen Wert hat
Volume-Warnschwelle (%)	Prozent	Nein	85	Volume-Belegung, die eine Warnung auslöst
Volume-Kritisch-Schwelle (%)	Prozent	Nein	95	Volume-Belegung, die ein kritisches Ergebnis auslöst
Storage-Volumes / Pfade (optional)	Liste von Strings	Nein	—	Explizite Volumes oder Pfade, die geprüft werden sollen (z. B. D:, E:\Hyper-V, ein Mountpoint-Ordner oder eine UNC-Freigabe). Bleibt das Feld leer, erfolgt eine automatische Erkennung aus den VHD-Speicherorten und den Standard-Pfaden des Hosts
Hyper-V-Replica prüfen	Schalter	Nein	Ein	Bezieht den Zustand der Replikation in das Ergebnis ein
Integrationsdienste prüfen	Schalter	Nein	Ein	Bezieht den Zustand der Integrationsdienste für laufende VMs ein
Integrationsdienst-Ausnahmen pro VM	Liste von Einträgen	Nein	Leer	Bei aktiver Integrationsdienst-Prüfung: pro Eintrag mindestens einen exakten VM-Namen und einen Integrationsdienst wählen. Nur diese Kombinationen sind ausgenommen; alle anderen Prüfungen bleiben aktiv. Siehe Einrichtung.
Abfrage-Timeout (Sekunden)	Ganzzahl	Nein	120	Wartezeit für das Erfassen der Hostdaten, 30–240 Sekunden. Bei Timeouts auf großen Hosts erhöhen.

Werden die Warn- und die kritische Volume-Schwelle vertauscht eingegeben, tauscht der Check sie automatisch.

Ergebniszustände

Bedingung	Schweregrad
Der Host kann nicht abgefragt werden (Modul und WMI schlagen beide fehl)	Kritisch
Eine erforderliche VM läuft nicht oder fehlt; eine VM befindet sich in einem kritischen Zustand	Kritisch
Ein Volume erreicht seine kritische Schwelle; der Replikations-Zustand ist kritisch	Kritisch
Ein Volume erreicht seine Warnschwelle	Warnung
Ein angegebenes Volume oder ein angegebener Pfad lässt sich nicht messen	Warnung
Ein Checkpoint ist älter oder zahlreicher als seine Schwelle	Warnung
Der Replikations-Zustand ist beeinträchtigt oder die Integrationsdienste sind beeinträchtigt	Warnung
Alle Prüfungen bestehen	OK
Der Check selbst konnte nicht ausgeführt werden	Fehlgeschlagen

Das Gesamtergebnis ist der schlechteste Schweregrad über alle VM-, Volume-, Replikations- und Integrationsdienst-Prüfungen hinweg. Fehlgeschlagen steht außerhalb dieser Zusammenfassung: Der Check hat dann überhaupt kein Ergebnis geliefert, und die Check-Details nennen den Grund.

Erfasste Metriken

Ob der Host erreichbar ist
Anzahl der laufenden, gestoppten, kritischen und sonstigen VMs
Anzahl der Replikationsaufträge und wie viele davon fehlerhaft sind
Höchstes Checkpoint-Alter (Tage) und höchste Volume-Belegung (%)
Name und Status je VM
Stammverzeichnis, belegter Prozentsatz und freie Bytes je Volume
Eine Liste von Problemen, jeweils mit Schweregrad und Gegenstand sowie – sofern zutreffend – Wert, Schwelle oder Detail

Plattformunterstützung

Plattform	Unterstützt
Windows Server (Hyper-V-Host)	Ja
Windows Desktop	Ja, sofern das Hyper-V-Feature aktiviert ist
Linux	Nein
macOS	Nein

Hinweise

Der Check läuft lokal auf dem Host – es sind keine Netzwerk-Anmeldedaten erforderlich.
Mit installiertem Hyper-V-PowerShell-Modul überwacht er VMs, Replikation, Checkpoints, Integrationsdienste und Speicher. Steht nur WMI zur Verfügung, meldet er den VM-Status und misst den Speicher nur für die Volumes, die du selbst angibst – Replikation, Checkpoints, Integrationsdienste und die automatische Volume-Erkennung benötigen alle das Modul.

Siehe auch: Einen Hyper-V-Host-Check konfigurieren.