Delen via

.NET Framework-logboekregistratie beheren

  • Artikel

U kunt gebeurtenistracering voor Windows (ETW) gebruiken om CLR-gebeurtenissen (Common Language Runtime) vast te leggen. U kunt traceringen maken en weergeven met behulp van de volgende hulpprogramma's:

Als u CLR-gebeurtenisgegevens wilt vastleggen, moet de CLR-provider op uw computer zijn geïnstalleerd. Als u wilt controleren of de provider is geïnstalleerd, typt logman query providers u bij de opdrachtprompt. Er wordt een lijst met providers weergegeven. Deze lijst moet als volgt een vermelding voor de CLR-provider bevatten.

Provider                                 GUID
-------------------------------------------------------------------------------
.NET Common Language Runtime    {E13C0D23-CCBC-4E12-931B-D9CC2EEE27E4}.

Als de CLR-provider niet wordt vermeld, kunt u deze installeren op Windows Vista en latere besturingssystemen met behulp van het opdrachtregelprogramma Windows Wevtutil . Open het venster met de opdrachtprompt als beheerder. Wijzig de promptmap in de map .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<. NET-versie>\ ). Deze map bevat het BESTAND CLR-ETW.man. Typ bij de opdrachtprompt de volgende opdracht om de CLR-provider te installeren:

wevtutil im CLR-ETW.man

CLR ETW-gebeurtenissen vastleggen

U kunt de opdrachtregelprogramma's logman en Xperf gebruiken om ETW-gebeurtenissen vast te leggen, en de hulpprogramma's Tracerpt en Xperf om de traceringsgebeurtenissen te decoderen.

Als u logboekregistratie wilt inschakelen, moet een gebruiker drie dingen opgeven:

  • De provider om mee te communiceren.

  • Een 64-bits getal dat een set trefwoorden vertegenwoordigt. Elk trefwoord vertegenwoordigt een set gebeurtenissen die de provider kan inschakelen. Het getal vertegenwoordigt een gecombineerde set trefwoorden die moeten worden ingeschakeld.

  • Een klein getal dat het niveau (uitgebreidheid) aangeeft dat moet worden aangemeld. Niveau 1 is het minst uitgebreid en niveau 5 is het uitgebreidst. Niveau 0 is een standaardinstelling waarvan de betekenis providerspecifiek is.

CLR ETW-gebeurtenissen vastleggen met behulp van Logman

  1. Typ bij de opdrachtprompt:

    logman start clrevents -p {e13c0d23-ccbc-4e12-931b-d9cc2eee27e4} 0x1CCBD 0x5 -ets -ct perf

    waarbij geldt:

    • De -p parameter identificeert de provider-GUID.

    • 0x1CCBD geeft de categorieën gebeurtenissen op die worden gegenereerd.

    • 0x5 stelt het niveau van logboekregistratie in (in dit geval uitgebreid (5)).

    • De -ets parameter geeft Logman opdracht om opdrachten te verzenden naar gebeurtenistraceringssessies.

    • De -ct perf parameter geeft aan dat de QueryPerformanceCounter functie wordt gebruikt om het tijdstempel voor elke gebeurtenis te registreren.

  2. Als u de logboekregistratie van de gebeurtenissen wilt stoppen, typt u:

    logman stop clrevents -ets

    Met deze opdracht maakt u een binair traceringsbestand met de naam clrevents.etl.

CLR ETW-gebeurtenissen vastleggen met xperf

  1. Typ bij de opdrachtprompt:

    xperf -start clr -on e13c0d23-ccbc-4e12-931b-d9cc2eee27e4:0x1CCBD:5 -f clrevents.etl

    waarbij de GUID de GUID van de CLR ETW-provider is en 0x1CCBD:5 alles traceert op en onder niveau 5 (uitgebreid).

  2. Als u wilt stoppen met traceren, typt u:

    Xperf -stop clr

    Met deze opdracht maakt u een traceringsbestand met de naam clrevents.etl.

CLR ETW-gebeurtenissen weergeven

Gebruik de onderstaande opdrachten om de CLR ETW-gebeurtenissen weer te geven. Zie CLR ETW-gebeurtenissen voor een beschrijving van de gebeurtenissen.

CLR ETW-gebeurtenissen weergeven met Tracerpt

  • Typ bij de opdrachtprompt:

    tracerpt clrevents.etl

    Met deze opdracht worden twee bestanden gemaakt: dumpfile.xml en summary.txt. Het bestand dumpfile.xml bevat alle gebeurtenissen en summary.txt geeft een overzicht van de gebeurtenissen.

CLR ETW-gebeurtenissen weergeven met xperf

  • Typ bij de opdrachtprompt:

    xperf clrevents.etl

    Met deze opdracht opent u de ETL-bestandsviewer xperf. In deze viewer worden de CLR-gebeurtenissen weergegeven in de weergave Algemene gebeurtenissen . Als u een gegevensraster wilt weergeven van gebeurtenissen die zijn gecategoriseerd op type, selecteert u een tijdsgebied in deze weergave en klikt u met de rechtermuisknop en selecteert u Samenvatting.

Het ETL-bestand converteren naar een bestand met door komma's gescheiden waarden

  • Typ bij de opdrachtprompt:

    xperf -i clrevents.etl -f clrevents.csv

    Deze opdracht zorgt ervoor dat XPerf de gebeurtenissen dumpt als een csv-bestand (door komma's gescheiden waarden) dat u kunt bekijken. Omdat verschillende gebeurtenissen verschillende velden hebben, bevat dit CSV-bestand meer dan één headerregel voor de gegevens. Het eerste veld van elke regel is het gebeurtenistype, dat aangeeft welke koptekst moet worden gebruikt om de rest van de velden te bepalen.

Zie ook