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

Článek
11/23/2024

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. Probíhá přejmenování dokumentace k produktu. 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.

V Prostory úložiště s přímým přístupem existují různé diagnostické nástroje, které můžete použít ke shromažďování dat potřebných k ř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).
Zobrazení dříve shromážděných diagnostických informací, pokud je potřebujete poskytnout podpoře nebo analýze sami

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

Spusťte Centrum pro správu Windows a vyberte Diagnostické 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 rutiny 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 prostředí PowerShell je snímek úložiště GitHub. Všimněte si, že instalace položek z Galerie prostředí PowerShell vyžaduje nejnovější verzi modulu PowerShellGet, který je k dispozici ve Windows 10, v rozhraní WMF (Windows Management Framework) 5.0 nebo v instalačním programu založeném na MSI (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 nejaktuálnější verzí tohoto modulu, protože se zde 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 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 získat rutinu Get-SDDCDiagnosticInfo PowerShellu v modulu:

Sestavy o stavu úložiště a podrobnosti o komponentách, které nejsou v pořádku
Sestavy kapacity úložiště podle fondu, svazku a svazku s odstraněnými duplicitními daty
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.

Spuštění v clusteru vzdáleného úložiště:

Get-SDDCDiagnosticInfo -ClusterName CLUS01

Spuštění 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ří zip:

Vygenerujme 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 Get-SDDCDiagnosticInfo

Níže jsou uvedeny soubory zahrnuté ve výstupu zip souboru Get-SDDCDiagnosticInfo.

Sestava souhrnu stavu

Sestava souhrnu stavu se uloží takto:

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 komponentách, které nejsou v pořádku (prostředky clusteru, které jsou offline, neúspěšné nebo online čekající)
Informace o firmwaru a ovladači
Podrobnosti o fondu, fyzickém disku a svazku
Výkon úložiště (shromažďují se čítače výkonu)

Tato sestava se průběžně aktualizuje, aby obsahovala užitečnější informace. 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 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, prostory úložiště 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í kroky.

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

Další kroky

Uveďte zpětnou vazbu k tomu, co byste chtěli vidět tím, že sem zadají problémy. 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