Kontrolowanie logowania w programie .NET Framework

  • Artykuł

Śledzenia zdarzeń systemu Windows (ETW) można użyć do rejestrowania zdarzeń środowiska uruchomieniowego języka wspólnego (CLR). Można tworzyć i przeglądać ślady za pomocą następujących narzędzi:

Aby można było przechwytywać informacje o zdarzeniu CLR, dostawca CLR musi być zainstalowany na komputerze. Aby potwierdzić, że dostawca jest zainstalowany, wpisz logman query providers w wierszu polecenia. Zostanie wyświetlona lista dostawców. Ta lista powinna zawierać następujący wpis dla dostawcy CLR.

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

Jeśli dostawca CLR nie znajduje się na liście, można zainstalować go w systemie Windows Vista i nowszych systemach operacyjnych przy użyciu narzędzia wiersza polecenia windows Wevtutil . Otwórz okno wiersza polecenia jako administrator. Zmień katalog monitu na folder .NET Framework 4 (%WINDIR%\Microsoft.NET\Framework[64]\v4.<. Wersja> net\ ). Ten folder zawiera plik CLR-ETW.man. W wierszu polecenia wpisz następujące polecenie, aby zainstalować dostawcę CLR:

wevtutil im CLR-ETW.man

Przechwytywanie zdarzeń CLR ETW

Narzędzia wiersza polecenia Logman i Xperf umożliwiają przechwytywanie zdarzeń ETW oraz narzędzi Tracerpt i Xperf do dekodowania zdarzeń śledzenia.

Aby włączyć rejestrowanie, użytkownik musi określić trzy rzeczy:

  • Dostawca do komunikacji.

  • 64-bitowa liczba, która reprezentuje zestaw słów kluczowych. Każde słowo kluczowe reprezentuje zestaw zdarzeń, które dostawca może włączyć. Ta liczba przedstawia połączony zestaw słów kluczowych do włączenia.

  • Mała liczba reprezentująca poziom (szczegółowości) rejestrowania. Poziom 1 jest najmniej szczegółowy, a poziom 5 jest najbardziej szczegółowy. Poziom 0 jest domyślny, a jego znaczenie jest specyficzne dla dostawcy.

Aby przechwytywać zdarzenia CLR ETW przy użyciu narzędzia Logman

  1. W wierszu polecenia wpisz:

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

    gdzie:

    • Parametr -p identyfikuje identyfikator GUID dostawcy.

    • 0x1CCBD określa kategorie zdarzeń, które zostaną zgłoszone.

    • 0x5 Ustawia poziom rejestrowania (w tym przypadku pełne (5)).

    • Parametr -ets nakazuje logmanowi wysyłanie poleceń do sesji śledzenia zdarzeń.

    • Parametr -ct perf określa, że QueryPerformanceCounter funkcja będzie używana do rejestrowania sygnatury czasowej dla każdego zdarzenia.

  2. Aby zatrzymać rejestrowanie zdarzeń, wpisz polecenie:

    logman stop clrevents -ets

    To polecenie tworzy plik binarny śledzenia o nazwie clrevents.etl.

Aby przechwytywać zdarzenia CLR ETW przy użyciu narzędzia Xperf

  1. W wierszu polecenia wpisz:

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

    gdzie identyfikator GUID jest identyfikatorEM GUID dostawcy CLR ETW i 0x1CCBD:5 śledzi wszystko na poziomie i poniżej 5 (pełne).

  2. Aby zatrzymać śledzenie, wpisz polecenie:

    Xperf -stop clr

    To polecenie tworzy plik śledzenia o nazwie clrevents.etl.

Wyświetlanie zdarzeń CLR ETW

Aby wyświetlić zdarzenia CLR ETW, należy użyć poleceń wymienionych poniżej. Aby uzyskać opis zdarzeń, zobacz ZDARZENIA CLR ETW.

Aby wyświetlić zdarzenia CLR ETW przy użyciu narzędzia Tracerpt

  • W wierszu polecenia wpisz:

    tracerpt clrevents.etl

    To polecenie tworzy dwa pliki: dumpfile.xml i summary.txt. Plik dumpfile.xml zawiera listę wszystkich zdarzeń, a plik summary.txt zawiera podsumowanie wszystkich zdarzeń.

Aby wyświetlić zdarzenia CLR ETW przy użyciu narzędzia Xperf

  • W wierszu polecenia wpisz:

    xperf clrevents.etl

    To polecenie otwiera podgląd plików Xperf ETL. W tej przeglądarce zdarzenia CLR są wyświetlane w widoku Zdarzenia ogólne. Aby wyświetlić siatkę danych zdarzeń sklasyfikowanych według typu, wybierz region czasu w tym widoku, a następnie kliknij prawym przyciskiem myszy i wybierz pozycję Podsumowanie.

Aby przekonwertować plik etl na plik z wartościami rozdzielanymi przecinkami

  • W wierszu polecenia wpisz:

    xperf -i clrevents.etl -f clrevents.csv

    To polecenie powoduje zrzucenie przez narzędzie XPerf zdarzeń do pliku z wartościami rozdzielanymi przecinkami (CSV), który można wyświetlać. Różne zdarzenia mają różne pola, więc ten plik CSV zawiera więcej niż jeden wiersz nagłówka przed danymi. Pierwsze pole w każdym wierszu jest typem zdarzenia wskazującym, który nagłówek powinien być używany do określenia pozostałych pól.

Zobacz też