Steuern der Protokollierung in .NET Framework
Sie können mithilfe der Ereignisablaufverfolgung für Windows (ETW) Common Language Runtime (CLR)-Ereignisse aufzeichnen. Sie können Ablaufverfolgungen mit den folgenden Tools erstellen und anzeigen:
Die Befehlszeilentools Logman und Tracerpt, die im Windows-Betriebssystem enthalten sind.
Die Xperf-Tools im Windows Performance Toolkit. Weitere Informationen zu Xperf finden Sie unter Windows Performance blog.
Wenn Sie CLR-Ereignisinformationen erfassen möchten, muss der CLR-Anbieter auf dem Computer installiert werden. Geben Sie an der Eingabeaufforderung logman query providers ein, um festzustellen, ob der Anbieter installiert ist. Eine Anbieterliste wird angezeigt. Diese Liste sollte wie folgt einen Eintrag für den CLR-Anbieter enthalten.
Provider GUID
-------------------------------------------------------------------------------
.NET Common Language Runtime {E13C0D23-CCBC-4E12-931B-D9CC2EEE27E4}
…………………………………………….
Wenn der CLR-Anbieter nicht aufgeführt ist, können Sie ihn unter Windows Vista und höheren Betriebssystemen mit dem Windows-Befehlszeilentool Wevtutil installieren. Öffnen Sie das Eingabeaufforderungsfenster als Administrator. Legen Sie als Eingabeaufforderungsverzeichnis den Ordner .NET Framework, Version 4 fest (%WINDIR%\Microsoft.NET\Framework[64]\v4.<.NET-Version>\). Dieser Ordner enthält die Datei "CLR-ETW.man". Geben Sie an der Eingabeaufforderung den folgenden Befehl ein, um den CLR-Anbieter zu installieren:
wevtutil im CLR-ETW.man
Erfassen von CLR-ETW-Ereignissen
Sie können mit den Befehlszeilentools Logman und XperfETW-Ereignisse erfassen. Mit den Tools Tracerpt und XPerf können die Ablaufverfolgungsereignisse decodiert werden.
Zum Aktivieren der Protokollierung müssen Benutzer drei Informationen angeben:
Anbieter, mit dem kommuniziert werden soll.
Eine 64-Bit-Zahl, die einen Satz von Schlüsselwörtern darstellt. Jedes Schlüsselwort stellt einen Satz von Ereignissen dar, den der Anbieter aktivieren kann. Die Zahl stellt einen kombinierten Satz von Schlüsselwörtern dar, die aktiviert werden sollen.
Eine kleine Zahl, die die Ebene (den Ausführlichkeitsgrad) der Protokollierung darstellt. Ebene 1 ist die am wenigsten ausführliche, Ebene 5 die ausführlichste. Ebene 0 ist ein Standard mit anbieterspezifischer Bedeutung.
So erfassen Sie CLR-ETW-Ereignisse mit Logman
Geben Sie an der Eingabeaufforderung Folgendes ein:
logman start clrevents -p {e13c0d23-ccbc-4e12-931b-d9cc2eee27e4} 0x1CCBD 0x5 -ets -ct perf
Dabei gilt:
Durch den -p-Parameter wird die Anbieter-GUID identifiziert.
0x1CCBD gibt die Kategorien der Ereignisse an, die ausgelöst werden.
0x5 legt die Ebene der Protokollierung fest (in diesem Fall "Ausführlich" (5)).
Mit dem -ets-Parameter wird Logman angewiesen, Befehle an Ereignisablaufverfolgungs-Sitzungen zu senden.
Der -ct perf-Parameter gibt an, dass mit der QueryPerformanceCounter-Funktion der Zeitstempel für jedes Ereignis protokolliert wird.
Geben Sie Folgendes ein, um die Protokollierung der Ereignisse zu beenden:
logman stop clrevents -ets
Mit diesem Befehl wird eine binäre Ablaufverfolgungsdatei mit dem Namen "clrevents.etl" erstellt.
So erfassen Sie CLR-ETW-Ereignisse mit XPerf
Geben Sie an der Eingabeaufforderung Folgendes ein:
xperf -start clr -on e13c0d23-ccbc-4e12-931b-d9cc2eee27e4:0x1CCBD:5 -f clrevents.etl
Dabei ist die GUID die GUID des CLR-ETW-Anbieters, und 0x1CCBD:5 verfolgt sämtliche Vorgänge auf und unterhalb von Ebene 5 (Ausführlich).
Geben Sie Folgendes ein, um die Ablaufverfolgung zu beenden:
Xperf -stop clr
Mit diesem Befehl wird eine Ablaufverfolgungsdatei mit dem Namen "clrevents.etl" erstellt.
Anzeigen von CLR-ETW-Ereignissen
Verwenden Sie die unten aufgeführten Befehle, um die CLR-ETW-Ereignisse anzuzeigen. Eine Beschreibung der Ereignisse finden Sie unter CLR-ETW-Ereignisse.
So zeigen Sie CLR-ETW-Ereignisse mit Tracerpt an
Geben Sie an der Eingabeaufforderung Folgendes ein:
tracerpt clrevents.etl
Mit diesem Befehl werden zwei Dateien erstellt: "dumpfile.xml" und "summary.txt". In der Datei "dumpfile.xml" werden alle Ereignisse aufgeführt, wohingegen "summary.txt" eine Zusammenfassung der Ereignisse enthält.
So zeigen Sie CLR-ETW-Ereignisse mit Xperf an
Geben Sie an der Eingabeaufforderung Folgendes ein:
xperf clrevents.etl
Mit diesem Befehl wird der ETL-Datei-Viewer von Xperf geöffnet. In diesem Viewer werden die CLR-Ereignisse in der Ansicht Generische Ereignisse angezeigt. Zum Anzeigen eines nach Typen kategorisierten Datenrasters von Ereignissen wählen Sie in der Ansicht einen Zeitraum aus, klicken Sie dann mit der rechten Maustaste, und wählen Sie Zusammenfassung aus.
So konvertieren Sie die ETL-Datei in eine CSV-Datei
Geben Sie an der Eingabeaufforderung Folgendes ein:
xperf -i clrevents.etl -f clrevents.csv
Dieser Befehl bewirkt, dass XPerf die Ereignisse als CSV-Datei (CSV) sichert, die Sie anzeigen können. Da für unterschiedliche Ereignisse auch unterschiedliche Felder verfügbar sind, enthält diese CSV-Datei vor den Daten mehrere Headerzeilen. Das erste Feld jeder Zeile ist für den Ereignistyp vorgesehen, der den Header angibt, der zum Ermitteln der weiteren Felder verwendet werden soll.