Sdílet prostřednictvím

Správa protokolování rozhraní .NET Framework

Trasování událostí pro Windows (ETW) můžete použít k zaznamenání událostí modulu CLR (Common Language Runtime). Trasování můžete vytvářet a zobrazovat pomocí následujících nástrojů:

Aby bylo možné zachytit informace o událostech CLR, musí být na vašem počítači nainstalovaný zprostředkovatel CLR. Pokud chcete ověřit, že je poskytovatel nainstalovaný, zadejte logman query providers na příkazovém řádku. Zobrazí se seznam poskytovatelů. Tento seznam by měl obsahovat položku pro zprostředkovatele CLR následujícím způsobem.

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

Pokud není uveden poskytovatel CLR, můžete ho nainstalovat do windows Vista a novějších operačních systémů pomocí nástroje příkazového řádku Windows Wevtutil . Otevřete okno příkazového řádku jako správce. Změňte adresář výzvy na složku rozhraní .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<. NET version>\ ). Tato složka obsahuje soubor CLR-ETW.man. Na příkazovém řádku zadejte následující příkaz, který nainstaluje zprostředkovatele CLR:

wevtutil im CLR-ETW.man

Zachytávání událostí CLR ETW pro Windows

Pomocí nástrojů příkazového řádku Logman a Xperf můžete zaznamenávat události ETW a nástroje Tracerpt a Xperf můžete použít k dekódování událostí sledování.

Pokud chcete zapnout protokolování, musí uživatel zadat tři věci:

  • Poskytovatel, se který má komunikovat.

  • 64bitové číslo, které představuje sadu klíčových slov. Každé klíčové slovo představuje sadu událostí, které může poskytovatel zapnout. Číslo představuje kombinovanou sadu klíčových slov, která se mají aktivovat.

  • Malé číslo představující úroveň (úroveň podrobností) pro přihlášení. Úroveň 1 je nejméně výřečná a úroveň 5 je nejvíce výřečná. Úroveň 0 je výchozí hodnota, jejíž význam je specifický pro poskytovatele.

Zachycení událostí TRASOVÁNÍ UDÁLOSTÍ CLR pomocí Logmanu

  1. Do příkazového řádku zadejte:

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

    kde:

    • Parametr -p identifikuje GUID poskytovatele.

    • 0x1CCBD určuje kategorie událostí, které budou vyvolány.

    • 0x5 nastaví úroveň protokolování (v tomto případě podrobné (5)).

    • Parametr -ets dává Logman pokyn k odesílání příkazů do relací trasování událostí.

    • Parametr -ct perf určuje, že QueryPerformanceCounter funkce se použije k protokolování časového razítka pro každou událost.

  2. Pokud chcete protokolování událostí zastavit, zadejte:

    logman stop clrevents -ets

    Tento příkaz vytvoří binární trasovací soubor s názvem clrevents.etl.

Zachycení ETW událostí CLR pomocí Xperf

  1. Do příkazového řádku zadejte:

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

    kde GUID je GUID zprostředkovatele CLR ETW a 0x1CCBD:5 trasuje vše na úrovni 5 a níže (podrobné úrovně).

  2. Pokud chcete trasování zastavit, zadejte:

    Xperf -stop clr

    Tento příkaz vytvoří trasovací soubor s názvem clrevents.etl.

Zobrazení událostí sledování událostí CLR pro Windows (ETW)

Pomocí níže uvedených příkazů zobrazte události CLR ETW. Popis událostí naleznete v tématu CLR ETW události.

Zobrazení událostí ETW CLR pomocí Tracerpt

  • Do příkazového řádku zadejte:

    tracerpt clrevents.etl

    Tento příkaz vytvoří dva soubory: dumpfile.xml a summary.txt. Soubor dumpfile.xml obsahuje seznam všech událostí a summary.txt obsahuje souhrn událostí.

Jak zobrazit události trasování CLR ETW pomocí xperf

  • Do příkazového řádku zadejte:

    xperf clrevents.etl

    Tento příkaz otevře prohlížeč souborů ETL xperf. V tomto prohlížeči se události CLR zobrazí v zobrazení Obecné události . Pokud chcete zobrazit datovou mřížku událostí zařazených podle typu, vyberte v tomto zobrazení oblast času a potom klikněte pravým tlačítkem myši a vyberte Souhrn.

Převod souboru .etl na soubor hodnot oddělený čárkami

  • Do příkazového řádku zadejte:

    xperf -i clrevents.etl -f clrevents.csv

    Tento příkaz způsobí, že XPerf zobrazí události jako soubor hodnot oddělených čárkami (CSV), který můžete zobrazit. Vzhledem k tomu, že různé události mají různá pole, obsahuje tento soubor CSV před daty více než jeden řádek záhlaví. První pole každého řádku je typ události, který označuje, které záhlaví se má použít k určení zbývajících polí.

Viz také

  • Last updated on