Udostępnij za pośrednictwem

Zbieranie danych diagnostycznych dla klastrów

  • Artykuł

Dotyczy: Azure Stack HCI, wersje 22H2 i 21H2; Windows Server 2022, Windows Server 2019, Windows Server 2016

Ważne

Usługa Azure Stack HCI jest teraz częścią usługi Azure Local. Trwa zmiana nazwy dokumentacji produktu. Jednak starsze wersje rozwiązania Azure Stack HCI, na przykład 22H2 będą nadal odwoływać się do rozwiązania Azure Stack HCI i nie będą odzwierciedlać zmiany nazwy. Dowiedz się więcej.

W usłudze Miejsca do magazynowania Direct dostępne są różne narzędzia diagnostyczne, których można użyć do zbierania danych potrzebnych do rozwiązywania problemów z klastrami rozwiązania Azure Stack HCI i Windows Server. W tym artykule skoncentrujemy się na instalowaniu i używaniu narzędzi diagnostycznych SDDC w celu zebrania odpowiednich informacji ułatwiających diagnozowanie klastra.

Ponieważ dzienniki i inne informacje są gęste, informacje przedstawione w tym artykule są pomocne w rozwiązywaniu zaawansowanych problemów, które zostały eskalacji i które mogą wymagać wysłania danych do firmy Microsoft w celu klasyfikacji.

Instalowanie i używanie narzędzi diagnostycznych w centrum administracyjnym systemu Windows

Możesz użyć programu Windows Admin Center (nowszej wersji 1812), aby:

  • Instalowanie narzędzi diagnostycznych SDDC i aktualizowanie ich
  • Zaplanuj codzienne uruchomienia diagnostyczne (mają one niewielki wpływ na system, zwykle trwa mniej niż pięć minut w tle i nie będą trwać więcej niż 500 MB w klastrze)
  • Wyświetlanie wcześniej zebranych informacji diagnostycznych, jeśli musisz przekazać je do pomocy technicznej lub samodzielnie je przeanalizować

Aby zainstalować narzędzia diagnostyczne SDDC i rozpocząć zbieranie danych, wykonaj następujące kroki:

  1. Uruchom Centrum administracyjne systemu Windows i wybierz pozycję Diagnostyka narzędzi>. Jeśli narzędzia diagnostyczne nie są jeszcze zainstalowane, kliknij przycisk Zainstaluj .

    Kliknij przycisk Zainstaluj, aby zainstalować narzędzia diagnostyczne SDDC.

  2. Aby rozpocząć zbieranie danych diagnostycznych, kliknij pozycję Zbieraj. Powinien zostać wyświetlony komunikat "Zbieranie informacji diagnostycznych. Może to potrwać kilka minut. Jeśli po początkowym zbieraniu danych chcesz automatycznie zbierać dane co 24 godziny, zmień suwak na Włączone.

    Kliknij pozycję Zbieraj, aby zbierać dane diagnostyczne.

  3. Zbieranie danych nie zostanie ukończone, dopóki nie zostanie wyświetlony poniższy zrzut ekranu. Aby wyświetlić zebrane informacje diagnostyczne, wybierz pozycję Pobierz (.zip) lub Otwórz w plikach.

    Aby wyświetlić informacje diagnostyczne, możesz pobrać plik .zip lub otworzyć go w narzędziu Pliki.

Instalowanie polecenia Get-SDDCDiagnosticInfo za pomocą programu PowerShell

Możesz użyć Get-SDDCDiagnosticInfo polecenia cmdlet programu PowerShell (znanego wcześniej Test-StorageHealthjako Get-PCStorageDiagnosticInfo), aby zebrać dzienniki dla klastra trybu failover (klaster, zasoby, sieci, węzły), Miejsca do magazynowania (dyski fizyczne, obudowy, dyski wirtualne), udostępnione woluminy klastra, udziały plików SMB i deduplikację.

Istnieją dwie metody instalowania skryptu: Galeria programu PowerShell i GitHub. Oba elementy zostały opisane poniżej.

Galeria programu PowerShell to migawka repozytorium GitHub. Należy pamiętać, że instalowanie elementów z Galeria programu PowerShell wymaga najnowszej wersji modułu PowerShellGet, który jest dostępny w systemie Windows 10, w programie Windows Management Framework (WMF) 5.0 lub w instalatorze opartym na msi (dla programu PowerShell 3 i 4).

W trakcie tego procesu instalujemy najnowszą wersję narzędzi diagnostyki sieci firmy Microsoft, ponieważ Get-SDDCDiagnosticInfo opiera się na tym. Ten moduł manifestu zawiera narzędzie do diagnostyki sieci i rozwiązywania problemów, które jest obsługiwane przez grupę produktów sieciowych microsoft Core w firmie Microsoft.

Moduł można zainstalować, uruchamiając następujące polecenie w programie PowerShell jako administrator:

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

Aby zaktualizować moduł, uruchom następujące polecenie w programie PowerShell:

Update-Module PrivateCloud.DiagnosticInfo

GitHub

Repozytorium GitHub jest najbardziej aktualną wersją modułu, ponieważ stale iterujemy tutaj. Aby zainstalować moduł z usługi GitHub, pobierz najnowszy moduł z archiwum i wyodrębnij katalog PrivateCloud.DiagnosticInfo do właściwej ścieżki modułów programu PowerShell wskazywanej przez $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

Jeśli chcesz pobrać ten moduł w klastrze offline, pobierz plik zip, przenieś go do węzła serwera docelowego i zainstaluj moduł.

Zbieranie dzienników za pomocą programu PowerShell

Po włączeniu kanałów zdarzeń i zakończeniu procesu instalacji możesz użyć Get-SDDCDiagnosticInfo polecenia cmdlet programu PowerShell w module , aby uzyskać następujące informacje:

  • Raporty dotyczące kondycji magazynu oraz szczegółowe informacje na temat składników w złej kondycji
  • Raporty dotyczące pojemności magazynu według puli, woluminu i woluminu deduplikowanego
  • Dzienniki zdarzeń ze wszystkich węzłów klastra i raport o błędach podsumowania

Załóżmy, że klaster magazynu ma nazwę "CLUS01".

Aby wykonać działanie względem klastra magazynu zdalnego:

Get-SDDCDiagnosticInfo -ClusterName CLUS01

Aby wykonać lokalnie w klastrowym węźle magazynu:

Get-SDDCDiagnosticInfo

Aby zapisać wyniki w określonym folderze:

Get-SDDCDiagnosticInfo -WriteToPath D:\Folder

Oto przykładowy wygląd rzeczywistego klastra:

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

Jak widać, skrypt przeprowadzi również walidację bieżącego stanu klastra:

Zrzut ekranu programu PowerShell zbierania danych.

Wszystkie dane są zapisywane w folderze SDDCDiagTemp:

Dane na Eksplorator plików zrzut ekranu.

Po zakończeniu działania skryptu zostanie utworzony plik ZIP w katalogu użytkownika:

Zrzut ekranu przedstawiający plik zip danych w programie PowerShell.

Wygenerujmy raport w pliku tekstowym:

#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

Aby uzyskać informacje, poniżej znajduje się link do przykładowego raportu i przykładowego pliku zip.

Dane wyjściowe Get-SDDCDiagnosticInfo

Poniżej przedstawiono pliki zawarte w spakowanych danych wyjściowych Get-SDDCDiagnosticInfopliku .

Raport podsumowania kondycji

Raport podsumowania kondycji jest zapisywany jako:

  • 0_CloudHealthSummary.log

Ten plik jest generowany po przeanalizowaniu wszystkich zebranych danych i ma na celu szybkie podsumowanie systemu. Zawiera:

  • Informacje o systemie
  • Omówienie kondycji magazynu (liczba węzłów w górę, zasoby w trybie online, udostępnione woluminy klastra w trybie online, składniki w złej kondycji itp.)
  • Szczegółowe informacje na temat składników w złej kondycji (zasoby klastra, które są w trybie offline, niepowodzeniem lub oczekujące w trybie online)
  • Informacje o oprogramowaniu układowym i sterowniku
  • Szczegóły puli, dysku fizycznego i woluminu
  • Wydajność magazynu (zbierane są liczniki wydajności)

Ten raport jest stale aktualizowany w celu uwzględnienia bardziej przydatnych informacji. Aby uzyskać najnowsze informacje, zobacz plik README usługi GitHub.

Dzienniki i pliki XML

Skrypt uruchamia różne skrypty zbierania dzienników i zapisuje dane wyjściowe jako pliki XML. Zbieramy dzienniki klastra i kondycji, informacje o systemie (MSInfo32), niefiltrowane dzienniki zdarzeń (klaster trybu failover, diagnostyka, funkcja Hyper-V, miejsca do magazynowania i nie tylko) oraz informacje diagnostyczne dotyczące magazynu (dzienniki operacyjne). Aby uzyskać najnowsze informacje na temat zbieranych informacji, zobacz Plik README usługi GitHub (co zbieramy)..

Jak korzystać z plików XML z polecenia Get-SDDCDiagnosticInfo

Dane z plików XML podanych w danych zebranych przez Get-SDDCDiagnosticInfo polecenie cmdlet można używać. Te pliki zawierają informacje o dyskach wirtualnych, dyskach fizycznych, podstawowych informacjach o klastrze i innych danych wyjściowych związanych z programem PowerShell.

Aby wyświetlić wyniki tych danych wyjściowych, otwórz okno programu PowerShell i uruchom następujące kroki.

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

Następne kroki

Prześlij opinię na temat tego, co chcesz zobaczyć, zgłaszając tutaj problemy. Ponadto możesz współtworzyć przydatne zmiany w skrypcie, przesyłając żądanie ściągnięcia.