Freigeben über

Aktivieren und Anzeigen von WDTF-Ablaufverfolgungen

  • Artikel

WDTF-Ablaufverfolgung bezieht sich auf das Melden von Ereignissen, die intern in WDTF-Objekten auftreten. Da WDTF stark instrumentiert ist, stellen alle WDTF-Objekte während ihrer Ausführung Ablaufverfolgungsinformationen bereit. WDTF verarbeitet die Ablaufverfolgung mithilfe der WPP-Softwareablaufverfolgung. Diese Art der Ablaufverfolgung ist ein standardisiertes Format, das Sie mithilfe von WDK-Tools, einschließlich TraceView, lesen können. In diesem Thema wird erläutert, wie Sie Mit Logman und Tracefmt WDTF-Laufzeitablaufverfolgungen anzeigen. In diesem Thema wird auch erläutert, wie Sie WDTF-Ablaufverfolgungsebenen programmgesteuert konfigurieren können.

Sammeln und Speichern von WDTF-Ablaufverfolgungen

So beginnen Sie mit dem Sammeln von WDTF-Ablaufverfolgungen

  1. Öffnen Sie auf dem Testcomputer ein Eingabeaufforderungsfenster mit erhöhten Rechten (Als Administrator ausführen), und geben Sie die folgenden Befehle ein:

    logman.exe create trace "autosession\WDTF" -p {6210f559-c7f7-4d2f-b674-4bc9315cecc7} 0xffffffff 0xff -o c:\WDTF_Traces\TraceFile.etl
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v LogFileMode /t REG_DWORD /d 1 /f
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v FileMax /t REG_DWORD /d 16 /f
reg add HKLM\SYSTEM\CurrentControlSet\Control\WMI\Autologger\WDTF /v MaxFileSize /t REG_DWORD /d 0 /f

  2. Starten Sie den Computer neu.

Weitere Informationen zu anderen Optionen finden Sie unter Logman (Logman.exe). Informationen zum Erstellen einer Ablaufverfolgungssaison finden Sie unter Konfigurieren und Starten einer AutoLogger-Sitzung.

So beenden Sie das Sammeln von WDTF-Ablaufverfolgungen und speichern Protokolldateien

  1. Sie können das Sammeln von WDTF-Ablaufverfolgungen beenden und den Datensammler mit den folgenden Befehlen löschen:

    logman.exe -stop -ets WDTF
logman.exe delete "autosession\WDTF"

  2. Starten Sie den Computer neu.

  3. Kopieren Sie die Protokolldateien vom Testcomputer auf einen anderen Computer zur späteren Analyse.

    Die gesammelten ETL-Protokolldateien können sehr groß sein. Kopieren Sie die Protokolldateien vom Testcomputer (z. B. c:\WDTF_Traces\TraceFile.etl) auf einen anderen Computer, um optimale Ergebnisse zu erzielen. Anschließend können Sie die Protokolldateien vom Testcomputer löschen.

Anzeigen von WDTF-Ablaufverfolgungen

Das Anzeigen von WDTF-Ablaufverfolgungen erfordert die Formatierung der ETL-Dateien. Die folgenden Schritte zeigen, wie SieTracefmt.exe verwenden, um die ETL-Dateien in Text- oder CSV-Dateien zu konvertieren.

So zeigen Sie WDTF-Ablaufverfolgungen an

  1. Der folgende Befehl konvertiert beispielsweise die ETL-Datei, die als c:\WDTF_Traces\TraceFile.etl gespeichert wurde, in Text.

    Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -o OutputTxtFile.txt

  2. Mit dem folgenden Befehl wird die ETL-Datei, die als c:\WDTF_Traces\TraceFile.etl gespeichert wurde, in die durch Kommas getrennte Datei (CSV) konvertiert.

    Tracefmt.exe –r http://msdl.microsoft.com/download/symbols c:\WDTF_Traces\TraceFile.etl -csv –o OutputCsvFile.csv

  3. Öffnen Sie die CSV-Dateien in Microsoft Excel, damit Sie Filterfunktionen von Excel verwenden können, um die gesammelten Ablaufverfolgungen zu filtern. Sie können die Ablaufverfolgungen für bestimmte Zeiträume filtern. Sie können die Ablaufverfolgungen filtern, um Ablaufverfolgungen zu untersuchen, die von bestimmten WDTF-Komponenten protokolliert wurden.

Programmgesteuertes Konfigurieren von WDTF-Ablaufverfolgungsebenen

Alle WDTF-Objekte stellen während der Ausführung Ablaufverfolgungsinformationen bereit.

WDTF stellt eine Reihe konfigurierbarer TTraceLevel-Ebenen bereit. Informationen zum Festlegen des TTraceLevel eines bestimmten Objekts instance zur Laufzeit finden Sie in der ITracing::SetTraceLevel-Methode.

Informationen zum Festlegen des Standard-TTraceLevel für eine Schnittstelle finden Sie in der Referenz zu Windows Device Testing Framework.

Eine ausführliche Beschreibung der Ablaufverfolgungstypen, die in jedem TTraceLevel enthalten sind, finden Sie in der ITracer-Schnittstelle . Sie können diese Ebenen mithilfe des TraceLevel-Pfads für die Registrierung von ITracer global konfigurieren.

In der folgenden Tabelle werden die Ablaufverfolgungsebenen beschrieben, die Sie festlegen können.

Ebene BESCHREIBUNG
0 Aus. Es wird keine Ablaufverfolgung bereitgestellt.
1 Niedrig
2 Mittel. Diese Ebene ist die Standardebene der Ablaufverfolgung.
3 High
4 Vollständig. Alle Ablaufverfolgungsinformationen werden gemeldet.
5–8 Benutzerdefinierte Ebenen.
9 Legt das Objekt auf die ursprüngliche Ablaufverfolgungsebene zurück.

Beim Debuggen mithilfe von Ablaufverfolgungsinhalten sollten Sie die Ablaufverfolgungsebenen für alle Objekte auf 1 festlegen und dann die Ablaufverfolgungsebenen für die objekte, die Sie untersuchen, viel höher festlegen.

Weitere Informationen zu Ablaufverfolgungsebenen finden Sie unter ITracer-Schnittstelle .

Konfigurieren und Starten einer AutoLogger-Sitzung
Logman
Tracefmt
TraceView
WPP-Softwareverfolgung