Diagnosedaten eines Azure Stack HCI-Clusters automatisch erfassen

Steht man vor der Herausforderung, einen Fehler in einem HCI-Cluster zu diagnostizieren, dann existieren dafür mehrere Möglich­keiten. Wie immer gilt bei Windows, dass viele Wege zum Ziel führen können. Erster Einstiegspunkt ist für die meisten Administratoren sicher das Eventlog.

Doch welche Bereiche sind für ein Cluster-Troubleshooting mit Hyper-V und S2D (hyper-converged) relevant? Ein PowerShell-Cmdlet soll uns dabei helfen: Get-SDDCDiagnosticInfo. Es dient nicht nur der selbstständigen Suche nach Fehlern, sondern kann auch von Microsoft Support Engineers angefordert werden.

Daten für verschiedene Systemkomponenten

Das Cmdlet Get-SDDCDiagnosticInfo sammelt unter­schiedlichste Daten ein. Dazu zählen auch Logs und Health Checks. Für Cluster berücksichtigt es dabei:

• Cluster-Ressourcen
• Netzwerke
• die einzelnen Knoten

Und bei Storage Spaces:

• Physische Datenträger
• Virtual Disks
• Enclosures

Außerdem noch:

• Cluster Shared Volumes (CSVs)
• SMB File Shares
• Deduplizierung

Installation auf allen Knoten

Für die erfolgreiche Diagnose mit PowerShell oder im WAC muss das PrivateCloud.DiagnosticInfo-Modul auf allen Nodes installiert und importiert werden. Dafür füge ich zunächst den NuGet-Provider hinzu:

Install-PackageProvider NuGet -Force

Anschließend kann das Modul installiert und mittels Import-Module importiert werden.

Install-Module PrivateCloud.DiagnosticInfo -Force
Import-Module PrivateCloud.DiagnosticInfo -Force

Ein Aufruf von Get-Module zeigt den erfolgreichen Import. Das Modul liegt in Version 1.1.20 vor und ist demnach aktuell (Stand: 26. 01. 2020). Auf PowerShell Gallery können Sie hin und wieder verfolgen, welche Versionierung das Modul durchläuft.

Über Get-Command lasse ich mir alle Funktionen dazu ausgeben. Interessant in diesem Zusammen­hang ist auch der Alias gsddcdi für Get-SddcDiagnosticInfo.

Remote Datenerfassung starten

Da ich die Diagnosedaten von meinem Remote-Management-Server sammeln möchte, braucht dieser zuvor die Failover Clustering Tools, darunter die Module für PowerShell.

Erst danach können wir über das Cmdlet Get-SddcDiagnosticInfo die Daten­sammlung und die Health-Checks starten. Mein hyper­konvergenter Cluster mit Hyper-V und S2D heißt hier StackHCI (Cluster Name Object, CNO).

Das Abrufen aller nötigen Logs, Konfigurationen, System­informationen und Gesundheits­daten dauert natürlich ein paar Minuten.

Diagnose-Daten auswerten

Alle erfassten Daten werden am Ende in einer ZIP-Datei zusammen­gepackt, und wir können mit der Auswertung der Diagnoseinformationen beginnen.

Innerhalb des ZIPs finden sich EventLogs, Textdateien, XMLs und auch Files für den Performance-Monitor. Die Auswertung bis zum Augenblick der Ereignisse erfordert wie immer Zeit, die gesammelten Daten liefern jedoch alle nötigen Hinweise.

Diagnose über das Windows Admin Center

Auch innerhalb des Windows Admin Center (WAC) lassen sich diese Daten erfassen. Unter Cluster Manager befindet sich der Punkt Diagnostics. Hier wird auch die Aktualität des Modules überprüft.

Zudem kann man die Diagnos­einformationen regelmäßig einmal pro Tag automatisch erfassen lassen. Das hilft, um Daten vergleichen können und Hinweise auf problematische Ereignisse zu erhalten.