Kontrolowanie logowania w programie .NET Framework
Ś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:
Narzędzia wiersza polecenia Logman i Tracerpt , które są dołączone do systemu operacyjnego Windows.
Narzędzia Xperf w zestawie narzędzi Windows Performance Toolkit. Aby uzyskać więcej informacji na temat xperf, zobacz blog dotyczący wydajności systemu Windows.
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
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, żeQueryPerformanceCounter
funkcja będzie używana do rejestrowania sygnatury czasowej dla każdego zdarzenia.
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
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).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.