Delen via

Diagnostische gegevens verzamelen voor clusters

  • Artikel

Van toepassing op: Azure Stack HCI, versies 22H2 en 21H2; Windows Server 2022, Windows Server 2019, Windows Server 2016

Belangrijk

Azure Stack HCI maakt nu deel uit van Azure Local. Oudere versies van Azure Stack HCI, bijvoorbeeld 22H2, blijven verwijzen naar Azure Stack HCI en geven de naamwijziging niet weer. Meer informatie.

Er zijn verschillende diagnostische hulpprogramma's in Opslagruimten Direct die u kunt gebruiken om de gegevens te verzamelen die nodig zijn voor het oplossen van problemen met Azure Stack HCI- en Windows Server-clusters. In dit artikel richten we ons op het installeren en gebruiken van diagnostische hulpprogramma's voor SDDC om relevante informatie te verzamelen voor het diagnosticeren van uw cluster.

Omdat de logboeken en andere informatie gedetailleerd zijn, is dit artikel nuttig voor het oplossen van geavanceerde problemen die al zijn geëscaleerd en waarvoor mogelijk gegevens naar Microsoft moeten worden verzonden voor analyse.

Diagnostische hulpprogramma's installeren en gebruiken met Windows Admin Center

U kunt windows-beheercentrum (versie 1812 en hoger) gebruiken om het volgende te doen:

  • Installeer diagnostische hulpprogramma's voor SDDC en houd ze bijgewerkt.
  • Plan dagelijkse diagnostische uitvoeringen (deze hebben een lage impact op uw systeem, duurt meestal minder dan vijf minuten om op de achtergrond uit te voeren en neemt niet meer dan 500 MB in uw cluster in beslag).
  • Bekijk eerder verzamelde diagnostische gegevens als u deze aan het ondersteuningspersoneel wilt geven of om deze zelf te analyseren.

Voer de volgende stappen uit om de SDDC-diagnosetools te installeren en gegevens te verzamelen:

  1. Start het Windows-beheercentrum en selecteer Diagnostische hulpprogramma's>. Als diagnostische hulpprogramma's nog niet zijn geïnstalleerd, klikt u op de knop Installeren .

    Klik op Installeren om diagnostische hulpprogramma's voor SDDC te installeren.

  2. Klik op Verzamelen om diagnostische gegevens te verzamelen. U ziet een bericht met de tekst 'Diagnostische gegevens verzamelen.' Dit kan enkele minuten duren. Als u na de eerste gegevensverzameling automatisch om de 24 uur gegevens wilt verzamelen, wijzigt u de schuifregelaar in Aan.

    Klik op Verzamelen om diagnostische gegevens te verzamelen.

  3. Het verzamelen van gegevens is pas voltooid als u de onderstaande schermopname ziet. Als u verzamelde diagnostische gegevens wilt weergeven, kiest u Downloaden (.zip) of Openen in het hulpprogramma Bestanden.

    Als u diagnostische gegevens wilt weergeven, kunt u een .zip-bestand downloaden of openen in het hulpprogramma Bestanden.

Get-SDDCDiagnosticInfo installeren met PowerShell

U kunt de Get-SDDCDiagnosticInfo PowerShell-cmdlet (ook wel bekend als , voorheen bekend als Get-PCStorageDiagnosticInfoTest-StorageHealth) gebruiken om logboeken te verzamelen en statuscontroles uit te voeren op failoverclustering (cluster, resources, netwerken, knooppunten), Opslagruimten (fysieke schijven, behuizingen, virtuele schijven), gedeelde clustervolumes, SMB-bestandsshares en ontdubbeling.

Er zijn twee methoden om het script te installeren: PowerShell Gallery en GitHub. Beide worden hieronder beschreven.

De PowerShell Gallery is een momentopname van de GitHub-opslagplaats. Houd er rekening mee dat voor het installeren van items uit de PowerShell Gallery de nieuwste versie van de module PowerShellGet is vereist, die beschikbaar is in Windows 10, in Windows Management Framework (WMF) 5.0 of in het MSI-installatieprogramma (voor PowerShell 3 en 4).

We installeren de nieuwste versie van de diagnostische hulpprogramma's voor Microsoft-netwerken tijdens dit proces, aangezien Get-SDDCDiagnosticInfo dit afhankelijk is van dit. Deze manifestmodule bevat hulpprogramma voor netwerkdiagnose en probleemoplossing, die worden onderhouden door de Microsoft Core Networking-productgroep bij Microsoft.

U kunt de module installeren door de volgende opdracht uit te voeren in PowerShell als beheerder:

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

Voer de volgende opdracht uit in PowerShell om de module bij te werken:

Update-Module PrivateCloud.DiagnosticInfo

GitHub

De GitHub-opslagplaats is de meest up-to-datumversie van de module, omdat we hier voortdurend herhalen. Als u de module wilt installeren vanuit GitHub, downloadt u de meest recente module uit het archief en extraheert u de map PrivateCloud.DiagnosticInfo naar het juiste Pad naar PowerShell-modules dat wordt verwezen door $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

Als u deze module op een offline cluster wilt krijgen, download dan het zip-bestand, verplaats het naar uw doelserver en installeer de module.

Logboeken verzamelen met PowerShell

Nadat u gebeurteniskanalen hebt ingeschakeld en het installatieproces hebt voltooid, kunt u de Get-SDDCDiagnosticInfo PowerShell-cmdlet in de module gebruiken om het volgende op te halen:

  • Rapporten over de opslagstatus, plus details over beschadigde onderdelen.
  • Rapporten van opslagcapaciteit per pool, volume en ontdubbeld volume.
  • Gebeurtenislogboeken van alle clusterknooppunten en een overzichtsfoutrapport.

Stel dat uw opslagcluster de naam heeft CLUS01-.

Uitvoeren op een extern opslagcluster:

Get-SDDCDiagnosticInfo -ClusterName CLUS01

Lokaal uitvoeren op een geclusterd opslagknooppunt:

Get-SDDCDiagnosticInfo

Resultaten opslaan in een opgegeven map:

Get-SDDCDiagnosticInfo -WriteToPath D:\Folder

Hier volgt een voorbeeld van hoe dit eruitziet op een echt cluster:

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

Zoals u kunt zien, voert het script ook de validatie van de huidige clusterstatus uit:

Schermopname van het verzamelen van gegevens in PowerShell.

Alle gegevens worden naar de map SDDCDiagTemp geschreven:

Schermopname van gegevens in Bestandenverkenner.

Nadat het script is voltooid, wordt er een zip-bestand gemaakt in uw gebruikersmap:

Schermafbeelding van PowerShell met gecomprimeerde gegevens.

Een rapport genereren in een tekstbestand:

#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

Ter referentie: hier volgt een koppeling naar het voorbeeldrapport en een zip-bestand.

Uitvoer get-SDDCDiagnosticInfo

De volgende bestanden zijn opgenomen in de zip-uitvoer van Get-SDDCDiagnosticInfo.

Statusoverzichtsrapport

Het statusoverzichtsrapport wordt opgeslagen als 0_CloudHealthSummary.log.

Dit bestand wordt gegenereerd na het parseren van alle verzamelde gegevens en is bedoeld om een beknopt overzicht van uw systeem te bieden. Het bevat:

  • Systeeminformatie.
  • Overzicht van de opslagstatus (het aantal knooppunten online, resources online, gedeelde clustervolumes, beschadigde onderdelen, enzovoort).
  • Details over beschadigde onderdelen (clusterresources die offline, mislukt of online in behandeling zijn).
  • Informatie over firmware en stuurprogramma's.
  • Details van pool, fysieke schijf en volume.
  • Opslagprestaties (performancemeters worden geregistreerd).

Dit rapport wordt voortdurend bijgewerkt met nuttigere informatie. Zie de GitHub-leesmij-voor de meest recente informatie.

Logboeken en XML-bestanden

Het script voert verschillende logboekverzamelingsscripts uit en slaat de uitvoer op als XML-bestanden. We verzamelen cluster- en statuslogboeken, systeeminformatie (MSInfo32), niet-gefilterde gebeurtenislogboeken (failoverclustering, dis diagnostics, Hyper-V, opslagruimten en meer) en diagnostische gegevens over opslag (operationele logboeken). Zie de GitHub-leesmij (wat we verzamelen)voor de meest recente informatie over welke gegevens worden verzameld.

XML-bestanden gebruiken van Get-SDDCDiagnosticInfo

U kunt de gegevens uit de XML-bestanden gebruiken die zijn opgenomen in de door de Get-SDDCDiagnosticInfo cmdlet verzamelde gegevens. Deze bestanden bevatten informatie over de virtuele schijven, fysieke schijven, basisclustergegevens en andere aan PowerShell gerelateerde uitvoer.

Als u de resultaten van deze uitvoer wilt zien, opent u een PowerShell-venster en voert u de volgende opdrachten uit:

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

Volgende stappen

Geef feedback over wat u wilt zien door problemen hier aan te geven. Voel je vrij om nuttige wijzigingen aan het script toe te voegen door een pull request in te dienen.