Dela via

Hantera .NET Framework loggning

Du kan använda händelsespårning för Windows (ETW) för att registrera CLR-händelser (Common Language Runtime). Du kan skapa och visa spårningar med hjälp av följande verktyg:

För att samla in CLR-händelseinformation måste CLR-providern vara installerad på datorn. Bekräfta att providern är installerad genom att skriva logman query providers i kommandotolken. En lista över leverantörer visas. Den här listan bör innehålla en post för CLR-providern, vilket framgår av följande.

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

Om CLR-providern inte visas kan du installera den i Windows Vista och senare operativsystem med hjälp av kommandoradsverktyget Windows Wevtutil . Öppna kommandotolken som administratör. Ändra promptkatalogen till mappen .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<. NET-version>\ ). Den här mappen innehåller FILEN CLR-ETW.man. I kommandotolken skriver du följande kommando för att installera CLR-providern:

wevtutil im CLR-ETW.man

Uppfånga CLR ETW-händelser

Du kan använda kommandoradsverktygen Logman och Xperf för att samla in ETW-händelser och verktygen Tracerpt och Xperf för att avkoda spårningshändelserna.

Om du vill aktivera loggning måste en användare ange tre saker:

  • Leverantören som man ska kommunicera med.

  • Ett 64-bitarsnummer som representerar en uppsättning nyckelord. Varje nyckelord representerar en uppsättning händelser som providern kan aktivera. Talet representerar en kombinerad uppsättning nyckelord som ska aktiveras.

  • Ett litet tal som representerar nivån (verbosity) att logga in på. Nivå 1 är den minst utförliga och nivå 5 är den mest utförliga. Nivå 0 är en standard vars innebörd är providerspecifik.

Samla in CLR ETW-händelser med Logman

  1. Skriv i kommandotolken:

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

    där:

    • Parametern -p identifierar providerns GUID.

    • 0x1CCBD anger de kategorier av händelser som ska aktiveras.

    • 0x5 anger loggningsnivån (i det här fallet utförlig (5)).

    • Parametern -ets instruerar Logman att skicka kommandon till händelsespårningssessioner.

    • Parametern -ct perf anger att QueryPerformanceCounter funktionen ska användas för att logga tidsstämpeln för varje händelse.

  2. Om du vill sluta logga händelserna skriver du:

    logman stop clrevents -ets

    Det här kommandot skapar en binär spårningsfil med namnet clrevents.etl.

Samla in CLR ETW-händelser med Xperf

  1. Skriv i kommandotolken:

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

    där GUID är CLR ETW-providerns GUID och 0x1CCBD:5 spårar allt på och under nivå 5 (utförligt).

  2. Om du vill sluta spåra skriver du:

    Xperf -stop clr

    Det här kommandot skapar en spårningsfil med namnet clrevents.etl.

Visa CLR ETW-händelser

Använd kommandona nedan för att visa CLR ETW-händelserna. En beskrivning av händelserna finns i CLR ETW-händelser.

Så här visar du CLR ETW-händelser med Hjälp av Tracerpt

  • Skriv i kommandotolken:

    tracerpt clrevents.etl

    Det här kommandot skapar två filer: dumpfile.xml och summary.txt. Filen dumpfile.xml visar en lista över alla händelser och summary.txt innehåller en sammanfattning av händelserna.

Så här visar du CLR ETW-händelser med Xperf

  • Skriv i kommandotolken:

    xperf clrevents.etl

    Det här kommandot öppnar Xperf ETL-filvisningsprogrammet. I det här visningsprogrammet visas CLR-händelserna i vyn Allmänna händelser . Om du vill visa ett datarutnät med händelser kategoriserade efter typ väljer du en tidsregion i den här vyn och högerklickar och väljer Sammanfattning.

Konvertera .etl-filen till en kommaavgränsad värdefil

  • Skriv i kommandotolken:

    xperf -i clrevents.etl -f clrevents.csv

    Det här kommandot gör att XPerf dumpar händelserna som en CSV-fil (kommaavgränsat värde) som du kan visa. Eftersom olika händelser har olika fält innehåller den här CSV-filen mer än en rubrikrad före data. Det första fältet på varje rad är händelsetypen, vilket anger vilken rubrik som ska användas för att fastställa resten av fälten.

Se även