Shromažďování diagnostických dat pro clustery

Článek
03/09/2025

Platí pro: Azure Stack HCI, verze 22H2 a 21H2; Windows Server 2022, Windows Server 2019, Windows Server 2016

Důležité

Azure Stack HCI je teď součástí Azure Local. Starší verze Azure Stack HCI, například 22H2, ale budou dál odkazovat na Azure Stack HCI a nebudou odrážet změnu názvu. Další informace.

Existují různé diagnostické nástroje v úložištích Storage Spaces Direct, které můžete použít ke shromažďování dat potřebných k diagnostice a řešení potíží s clustery Azure Stack HCI a Windows Server. V tomto článku se zaměříme na instalaci a použití diagnostických nástrojů SDDC ke shromažďování relevantních informací, které vám pomůžou diagnostikovat váš cluster.

Vzhledem k tomu, že protokoly a další informace jsou zhuštěné, jsou informace uvedené v tomto článku užitečné pro řešení pokročilých problémů, které byly eskalovány a které můžou vyžadovat odeslání dat do Microsoftu pro třídění.

Instalace a používání diagnostických nástrojů v Centru pro správu Windows

Windows Admin Center (verze 1812) můžete použít k:

Nainstalujte diagnostické nástroje SDDC a udržujte je v aktualizovaném stavu.
Naplánujte každodenní diagnostická spuštění (to má nízký dopad na váš systém, obvykle trvá méně než pět minut, než se spustí na pozadí a nebude trvat déle než 500 MB v clusteru).
Pokud potřebujete poskytnout pracovníkům podpory nebo sami analyzovat, prohlédněte si dříve shromážděné diagnostické informace.

Pokud chcete nainstalovat diagnostické nástroje SDDC a začít shromažďovat data, postupujte takto:

Spusťte Centrum pro správu Windows a vyberte > nástroje. Pokud diagnostické nástroje ještě nejsou nainstalované, klikněte na tlačítko Instalovat .
Pokud chcete začít shromažďovat diagnostická data, klikněte na Shromáždit. Měla by se zobrazit zpráva o shromažďování diagnostických informací. Může to trvat několik minut." Pokud chcete automaticky shromažďovat data každých 24 hodin po počátečním shromažďování dat, změňte posuvník na Zapnuto.
Shromažďování dat není dokončeno, dokud se nezobrazí následující snímek obrazovky. Pokud chcete zobrazit shromážděné diagnostické informace, zvolte Nástroj Stáhnout (.zip) nebo Otevřít v souborech.

Instalace Get-SDDCDiagnosticInfo pomocí PowerShellu

Pomocí rutiny PowerShellu Get-SDDCDiagnosticInfo (označované také jako Get-PCStorageDiagnosticInfo, dříve označované jakoTest-StorageHealth) můžete shromažďovat protokoly a provádět kontroly stavu clusteringu s podporou převzetí služeb při selhání (cluster, prostředky, sítě, uzly), Prostory úložiště (fyzické disky, skříně, virtuální disky), sdílené svazky clusteru, sdílené složky SMB a odstranění duplicitních dat.

Existují dvě metody instalace skriptu: Galerie prostředí PowerShell a GitHub. Obě jsou uvedeny níže.

Galerie prostředí PowerShell

Galerie PowerShellu je kopií úložiště GitHub. Všimněte si, že instalace položek z PowerShell galerie vyžaduje nejnovější verzi modulu PowerShellGet, který je k dispozici ve Windows 10, v Windows Management Framework (WMF) 5.0 nebo v MSI-based instalačním programu (pro PowerShell 3 a 4).

Během tohoto procesu nainstalujeme nejnovější verzi nástrojů Microsoft Networking Diagnostics, protože Get-SDDCDiagnosticInfo na to spoléháme. Tento modul manifestu obsahuje nástroj pro diagnostiku sítě a řešení potíží, který udržuje skupina produktů Microsoft Core Networking v Microsoftu.

Modul můžete nainstalovat spuštěním následujícího příkazu v PowerShellu jako správce:

Install-PackageProvider NuGet -Force
Install-Module PrivateCloud.DiagnosticInfo -Force
Import-Module PrivateCloud.DiagnosticInfo -Force
Install-Module -Name MSFT.Network.Diag

Pokud chcete modul aktualizovat, spusťte v PowerShellu následující příkaz:

Update-Module PrivateCloud.DiagnosticInfo

GitHub

Úložiště GitHubu je nejvíce up-todatovou verzí modulu, protože sem neustále iterujeme. Pokud chcete nainstalovat modul z GitHubu, stáhněte si nejnovější modul z archivu a extrahujte adresář PrivateCloud.DiagnosticInfo do správné cesty modulů PowerShellu, na kterou odkazuje $env:PSModulePath:

# Allowing Tls12 and Tls11 -- e.g. github now requires Tls12
# If this is not set, the Invoke-WebRequest fails with "The request was aborted: Could not create SSL/TLS secure channel."
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
$module = 'PrivateCloud.DiagnosticInfo'
Invoke-WebRequest -Uri https://github.com/PowerShell/$module/archive/master.zip -OutFile $env:TEMP\master.zip
Expand-Archive -Path $env:TEMP\master.zip -DestinationPath $env:TEMP -Force
if (Test-Path $env:SystemRoot\System32\WindowsPowerShell\v1.0\Modules\$module) {
    rm -Recurse $env:SystemRoot\System32\WindowsPowerShell\v1.0\Modules\$module -ErrorAction Stop
    Remove-Module $module -ErrorAction SilentlyContinue
} else {
    Import-Module $module -ErrorAction SilentlyContinue
}
if (-not ($m = Get-Module $module -ErrorAction SilentlyContinue)) {
    $md = "$env:ProgramFiles\WindowsPowerShell\Modules"
} else {
    $md = (gi $m.ModuleBase -ErrorAction SilentlyContinue).PsParentPath
    Remove-Module $module -ErrorAction SilentlyContinue
    rm -Recurse $m.ModuleBase -ErrorAction Stop
}
cp -Recurse $env:TEMP\$module-master\$module $md -Force -ErrorAction Stop
rm -Recurse $env:TEMP\$module-master,$env:TEMP\master.zip
Import-Module $module -Force

Pokud potřebujete tento modul získat v offline clusteru, stáhněte si soubor ZIP, přesuňte ho do uzlu cílového serveru a nainstalujte modul.

Shromažďování protokolů pomocí PowerShellu

Po povolení kanálů událostí a dokončení procesu instalace můžete v modulu použít PowerShell cmdlet Get-SDDCDiagnosticInfo k získání:

Zaznamenává stav úložiště a podrobnosti o komponentách, které nejsou v pořádku.
Sestavy kapacity úložiště podle fondu, svazku a deduplikovaného svazku.
Protokoly událostí ze všech uzlů clusteru a souhrnná zpráva o chybách.

Předpokládejme, že váš cluster úložiště má název CLUS01 .

Proti vzdálenému datovému clusteru:

Get-SDDCDiagnosticInfo -ClusterName CLUS01

Pro provedení místně na uzlu clusterovaného úložiště:

Get-SDDCDiagnosticInfo

Uložení výsledků do zadané složky:

Get-SDDCDiagnosticInfo -WriteToPath D:\Folder

Tady je příklad, jak to vypadá na skutečném clusteru:

New-Item -Name SDDCDiagTemp -Path d:\ -ItemType Directory -Force
Get-SddcDiagnosticInfo -ClusterName S2D-Cluster -WriteToPath d:\SDDCDiagTemp

Jak vidíte, skript také provede ověření aktuálního stavu clusteru:

Všechna data se zapisují do složky SDDCDiagTemp:

Po dokončení skriptu se v uživatelském adresáři vytvoří soubor ZIP:

Generujte sestavu do textového souboru.

#find the latest diagnostic zip in UserProfile
    $DiagZip=(get-childitem $env:USERPROFILE | where Name -like HealthTest*.zip)
    $LatestDiagPath=($DiagZip | sort lastwritetime | select -First 1).FullName
#expand to temp directory
    New-Item -Name SDDCDiagTemp -Path d:\ -ItemType Directory -Force
    Expand-Archive -Path $LatestDiagPath -DestinationPath D:\SDDCDiagTemp -Force
#generate report and save to text file
    $report=Show-SddcDiagnosticReport -Path D:\SDDCDiagTemp
    $report | out-file d:\SDDCReport.txt

Tady je odkaz na ukázkovou sestavu a ukázkový zip.

Výstup příkazu Get-SDDCDiagnosticInfo

Následující soubory jsou zahrnuty do komprimovaného výstupu Get-SDDCDiagnosticInfo.

Sestava souhrnu stavu

Sestava souhrnu stavu se uloží jako 0_CloudHealthSummary.log.

Tento soubor se vygeneruje po analýze všech shromážděných dat a slouží k rychlému shrnutí vašeho systému. Obsahuje:

Systémové informace.
Přehled stavu úložiště (počet uzlů, online prostředky, sdílené svazky clusteru online, součásti, které nejsou v pořádku atd.).
Podrobnosti o problematických komponentách (prostředky clusteru, které jsou offline, selhaly, nebo čekající na online).
Informace o firmwaru a ovladači.
Podrobnosti o fondu, fyzickém disku a svazku
Shromažďuje se výkon úložiště (čítače výkonu).

Tato sestava se průběžně aktualizuje, aby zahrnovala více užitečných informací. Nejnovější informace najdete v souboru readme GitHubu .

Protokoly a soubory XML

Skript spustí různé skripty pro shromažďování protokolů a uloží výstup jako soubory XML. Shromažďujeme protokoly týkající se clusteru a stavu, systémové informace (MSInfo32), nefiltrované protokoly událostí (clustering s podporou převzetí služeb při selhání, diagnostika dis, Hyper-V, úložné prostory a další) a diagnostické informace o úložišti (provozní protokoly). Nejnovější informace o shromažďovaných informacích najdete v souboru readme GitHubu (co shromažďujeme).

Jak využívat soubory XML z Get-SDDCDiagnosticInfo

Můžete využívat data ze souborů XML poskytovaných v datech shromážděných rutinou Get-SDDCDiagnosticInfo . Tyto soubory obsahují informace o virtuálních discích, fyzických discích, základních informacích o clusteru a dalších výstupech souvisejících s PowerShellem.

Pokud chcete zobrazit výsledky těchto výstupů, otevřete okno PowerShellu a spusťte následující příkazy:

ipmo storage
$d = import-clixml <filename>
$d

Další kroky

Poskytněte nám zpětnou vazbu na to, co byste chtěli vidět, podáním problémů zde. Můžete také přispět užitečnými změnami skriptu odesláním žádosti o přijetí změn.

Sdílet prostřednictvím