AGDiag gebruiken om statussen van beschikbaarheidsgroepen vast te stellen

2025-10-31

Notitie

Zie Problemen met failover van AlwaysOn-beschikbaarheidsgroepen oplossen om statusproblemen met alwayson-beschikbaarheidsgroepen vast te stellen die failover van beschikbaarheidsgroepen activeren.

AGDiag is een toepassing die de handmatige analyse van clusterlogboeken automatiseert en relevante gebeurtenissen uit de andere logboeken correleert en rapporteert (SQL Server-foutlogboeken, Windows-gebeurtenislogboeken, enzovoort). AGDiag genereert een overzichtsrapport van Windows-cluster- en AlwaysOn-status gebeurtenissen en biedt gedetailleerdere analyseresultaten voor elke gedetecteerde status gebeurtenis. Het automatiseert ook veel van het werk wanneer u de juiste logboeken verstrekt van de primaire replica van de beschikbaarheidsgroep tijdens het gezondheidsevenement.

Logboeken genereren voor AGDiag om een diagnose uit te voeren

U kunt verschillende methoden gebruiken om de logboeken te genereren die AGDiag als invoer gebruikt. AGDiag is afhankelijk van de volgende basislogboeken voor analyse:

Diagnostische logboeken voor Windows-clusters
SQL Server-foutenlogboeken
Logboeken voor Windows-systeemevenementen
XEL-bestanden (System Health Extended Events)
XEL-bestanden voor AlwaysOn Health Session

Als alternatieve methode voor het handmatig verzamelen van deze logboeken kunt u een van de volgende hulpprogramma's voor logboekverzameling gebruiken om ze vast te leggen:

LogScout
TSS

SQL LogScout gebruiken om logboeken vast te leggen voor AGDiag-analyse

Als u een statusgebeurtenis van een beschikbaarheidsgroep wilt diagnosticeren, gebruikt u SQL LogScout om logboeken te verzamelen op het SQL Server-exemplaar dat zich op het moment van de gebeurtenis in de primaire rol bevond:

Download de meest recente SQL LogScout als een .zip-bestand.
Sla het .zip-bestand op en pak het uit op de computer waarop SQL Server als host fungeert voor de primaire replica. Dit systeem is waar de failover is gestart of waar de beschikbaarheidsgroep bezig was met oplossen.
Open een powerShell-opdrachtpromptvenster met verhoogde bevoegdheid en wijzig de map in de map SQL LogScout waarin u het .zip bestand hebt uitgepakt.
Voer de volgende opdracht uit om het Basic scenario vast te leggen en volg de aanwijzingen.
```
.\SQL_LogScout.ps1 -Scenario "Basic" -ServerName "<Your_Sql_Instance_Name>"
```
Wanneer het logboekopnameproces is voltooid, kunt u AGDiag naar de \output map verwijzen die is gemaakt in de SQL LogScout-map. Deze map bevat de logboeken die worden verzameld door SQL LogScout.

TSS gebruiken om logboeken te genereren voor AGDiag om diagnoses uit te voeren

U kunt de logboeken ook vastleggen met behulp van TSS op het SQL Server-exemplaar dat zich op het moment van de gebeurtenis in de primaire rol bevond:

Download de toolset (TSSv2.zip) als een .zip-bestand. Zie Introduction to TroubleShootingScript toolset (TSSv2) voor meer informatie.
Sla het .zip-bestand op en pak het uit in een map op het SQL Server-exemplaar waarop de primaire replica van de beschikbaarheidsgroep werd gehost toen de failover werd gestart of de beschikbaarheidsgroep werd hersteld.
Open een opdrachtpromptvenster met verhoogde bevoegdheid, wijzig de map in de map TSS waarin u het TSSv2.zip-bestand hebt opgeslagen en uitgepakt, voer het uit TSS SDP:SQLBaseen reageer op de prompts.
Nadat TSS het SQLBase-.cab-bestand heeft gemaakt, extraheert u het .cab bestand in een map.

Het hulpprogramma AGDiag downloaden

Volg deze stappen om AGDiag te downloaden:

Open Release AGDiag Windows Release oktober 2021 (ondertekend).
Selecteer de agdiag.zip koppeling om het hulpprogramma te downloaden.

Start AGDiag en voer de uitgepakte TSS-logbestanden in

Nadat u de toepassing hebt gedownload, volgt u deze stappen om AGDiag te starten en de uitgepakte TSS-logboeken aan te leveren:

Pak het .zip-bestand uit en dubbelklik op agdiag.exe om AGDiag te starten.

Er wordt een dialoogvenster weergegeven dat lijkt op het volgende vak.
Selecteer Logboekmap selecteren, zoom in op de map waarnaar u de TSS SQLBase-.cab bestanden hebt uitgepakt en selecteer vervolgens OK.

Het AGDiag-rapport interpreteren

De standaardsysteembrowser opent het AGDiag-rapport. Met de volgende illustraties kunt u het rapport interpreteren:

In het volgende AGDiag Splash Screen worden de mogelijkheden en versiegegevens van AGDiag beschreven.
AGDiag rapporteert over de logboeken die het analyseert in de initiatiefase. Als u meer gedetailleerde informatie wilt zien, selecteert u de driehoeken (gemarkeerd in rode vakken in de volgende afbeelding).
Het overzichtsrapport bevat de status gebeurtenissen van de beschikbaarheidsgroep uit het clusterlogboek. Als u naar het gedetailleerde rapport van een specifieke gezondheidsgebeurtenis wilt gaan, selecteert u de numerieke koppeling (gemarkeerd in het rode vak in de volgende afbeelding).
Er bestaat een gedetailleerd rapport voor iedere gezondheidsevenement die wordt gedetecteerd. Dit rapport bevat logboekresultaten die correleren met het gezondheidsevenement, de diagnose en de aanbevelingen. Als u meer gedetailleerde informatie wilt zien, selecteert u de driehoeken (gemarkeerd in rode vakken in de volgende afbeelding).