Ablaufverfolgung für Sync Framework-Komponenten

Sync Framework ermöglicht die Ablaufverfolgung für die Ausführung mehrerer Komponenten. Dies kann beim Debuggen einer Anwendung hilfreich sein. Für die meisten der Sync Framework-Komponenten wird die Ablaufverfolgung auf Ebene des systemeigenen Codes mithilfe der Ereignisablaufverfolgung für Windows (Event Tracing for Windows, ETW)-Infrastruktur ausgeführt. Weitere Informationen über die ETW-Infrastruktur finden Sie unter Ereignisablaufverfolgung.

Selbst wenn Sie für die verwaltete Version einer API entwickeln, verwenden Sie weiterhin ETW, da die verwaltete API ein schlanker Wrapper über der systemeigenen API ist. Sync Framework-Datenbankanbieter stellen eine verwaltete Ablaufverfolgung auf Grundlage der .NET Framework-Implementierung bereit. Weitere Informationen finden Sie unter Vorgehensweise: Ablaufverfolgung des Synchronisierungsvorgangs.

Herunterladen und Verwenden der Ablaufverfolgungtools

Die für ETW erforderlichen Ablaufverfolgungstools sind in den Windows-Supporttools enthalten, die für jede Version von Windows verfügbar sind. Die Tools für Windows XP SP2 sind beispielsweise auf dieser Seite vom Microsoft Download Center erhältlich. Die für die Sync Framework-Ablaufverfolgung relevanten Tools werden in der folgenden Tabelle beschrieben:

Um die Ausgabe einer Ablaufverfolgung anzuzeigen, starten Sie das Ablaufverfolgungsprotokoll, aktivieren die Ablaufverfolgung und formatieren anschließend die Ablaufverfolgung für die Anzeige.

So starten Sie eine Ablaufverfolgungsprotokollierung

Um eine Ablaufverfolgungsprotokollierung zu starten, geben Sie einen Namen für die Protokollierung, einen Namen für die Ablaufverfolgungsdatei sowie einige Parameter ein, durch die festgelegt wird, wie die Datei geschrieben wird: tracelog.exe -start <LoggerName> <LoggerParameters> -f <PathToEtlFile>. Beispielsweise kann der folgende Befehl verwendet werden:

tracelog.exe -start "Sync" -paged -b 32 -max 100 -cir 20 -ls -f %TEMP%\SyncFramework.etl

So aktivieren Sie die Ablaufverfolgung

Geben Sie zur Aktivierung der Ablaufverfolgung die GUID der Komponente an, deren Ablauf verfolgt werden soll, eine Bitmaske von Flags, um anzuzeigen, für welche Unterkomponenten der Ablauf verfolgt werden soll, und eine ganze Zahl, die die Ablaufverfolgungsebene darstellt: tracelog.exe - enable <LoggerName> -guid <ComponentTracingId> -flags <Flags> -level <Level>. In diesem Beispiel wird die Ablaufverfolgung für die Sync Framework-Kernkomponente und alle ihre Unterkomponenten auf einer Ablaufverfolgungsebene von 4 (Informationsmeldungen, die Nichtfehlerfälle beinhalten) aktiviert:

tracelog.exe -enable "Sync" -guid #5978339c-8ab2-467e-bb85-8832659d5ed0 -flags 0xffff -level 4

Eine vollständige Liste der Optionen für Sync Framework finden Sie in diesem Thema unter Ablaufverfolgungsreferenz für Sync Framework.

So formatieren Sie die Ablaufverfolgungsdatei und zeigen sie an

Um eine Ablaufverfolgung anzuzeigen, entleeren Sie die Protokollierung und formatieren die binäre Ablaufverfolgungsdatei mithilfe der TMF-Dateien, die für Sync Framework im Microsoft Download Center verfügbar sind. Mit Befehlen wie dem folgenden können Sie die Ablaufverfolgung über die „Sync“-Protokollierung abrufen:

1. Führen Sie zum Entleeren der Protokollierung tracelog.exe -flush "Sync" aus.

2. Kopieren Sie die TMF-Dateien vom Sync Framework-Installationspfad (Programme\Microsoft SDKs\Microsoft Sync Framework\v2.0) in ein Arbeitsverzeichnis, wie z. B. %TEMP%\TMF.

3. Führen Sie zum Formatieren der Datei tracefmt.exe %TEMP%\SyncFramework.etl -p %TEMP%\TMF -o %TEMP%\SyncFrameworkTrace.txt aus.

4. Öffnen Sie %TEMP%\SyncFrameworkTrace.txt, um die Datei anzuzeigen.

So beenden Sie die Ablaufverfolgung

Um die zuvor gestartete „Sync“-Protokollierung zu beenden, führen Sie tracelog.exe -stop "Sync" aus.

Ablaufverfolgungsreferenz für Sync Framework

In der folgenden Tabelle sind die GUIDs aufgeführt, die die einzelnen Sync Framework-Komponenten darstellen:

Ablaufverfolgungsflags

In den folgenden Tabellen sind die Bitmaskenflags aufgeführt, die an den -flags -Parameter von tracelog.exe übergeben werden können, um anzugeben, für welche Unterkomponenten der Ablauf verfolgt werden soll:

Hauptframework und Laufzeitflags

Einfache Anbieterflags

Websynchronisierungskomponenten-Flags

Metadaten-Speicherdienstflags

Dateisynchronisierungsanbieter-Flags

Ablaufverfolgungsebenen

In der folgenden Tabelle sind die von Sync Framework verwendeten Ablaufverfolgungsebenen aufgeführt. Eine Erhöhung der Ebene steht für eine Erhöhung der Ausführlichkeit der Protokollierung, und die Ebenen sind kumulativ. Eine Ablaufverfolgung der Ebene 4 enthält beispielsweise alle Informationen der Ebenen 1 bis 3 sowie zusätzliche Informationen:

Siehe auch

Konzepte

Problembehandlung für Sync Framework