Tracefmt-Befehle

Um Tracefmt zu verwenden, geben Sie die Befehle in ein Eingabeaufforderungsfenster ein. Die folgende Syntax zeigt die Elemente eines Tracefmt-Befehls an.

Um die Ablaufverfolgungsmeldungen in lesbarer Form anzuzeigen, muss Tracefmt die Formatierungsanweisungen in einer Ablaufverfolgungsnachrichtenformatdatei auf die Ablaufverfolgungsmeldungen anwenden. Die verwendete Syntax hängt davon ab, ob Sie über eine TMF-Datei für den Ablaufverfolgungsanbieter verfügen oder ob Tracefmt eine TMF-Datei erstellen soll.

So geben Sie eine TMF-Datei oder einen Pfad zu einem Verzeichnis von TMF-Dateien an:

    tracefmt [EtlFile | -rt SessionName][-tmf TMFFile | -p TMFPath ] [Options]

So erstellen Sie eine TMF-Datei:

    tracefmt [EtlFile | -rt SessionName]-i ImageFiles [-r SymbolPath ] [-p TmfPath ] [Options]

So zeigen Sie die Syntax an der Befehlszeile an.

    tracefmt -h | /?

Parameter

EtlFile
Gibt die Etl-Datei (Ereignisablaufverfolgungsprotokoll) an, die die Ablaufverfolgungsmeldungen enthält. Geben Sie den Pfad (optional) und den Dateinamen ein. Der Standardwert ist c:\logfile.etl.

-rtSessionName
Echtzeit. Formatiert Ablaufverfolgungsmeldungen aus den angegebenen Echtzeitablaufverfolgungssitzungen anstelle von aus einem Ablaufverfolgungsprotokoll.

SessionName ist der Name der Ablaufverfolgungssitzung. Der Standardwert ist NT Kernel Logger.

-tmfTMFFile
Gibt den Pfad (optional) und den Dateinamen einer Ablaufverfolgungsnachrichtenformatdatei (TMF) für die Ablaufverfolgungsmeldungen an. Der Standardwert ist Default.tmf, eine Datei, die im WDK enthalten ist.

-iImageFiles
Weist Tracefmt an, die PDB-Symboldateien für die angegebenen Bilddateien zu suchen und eine TMF-Datei aus den Formatierungsanweisungen in den PDB-Dateien zu erstellen.

ImageFiles stellt den Pfad und die Dateinamen einer oder mehrerer Binärdateien (.exe, .dll oder .sys) für Ablaufverfolgungsanbieter dar. Verwenden eines Semikolons (;) , um Imagedateinamen zu trennen.

-rSymbolPaths
Gibt den Speicherort der privaten PDB-Symboldateien für die in -i angegebenen Bilddateien an.

SymbolPaths stellt einen oder mehrere Pfade zu Verzeichnissen dar, in denen private Symbole oder Symbolserverpfade gespeichert werden. Verwenden eines Semikolons (;) , um Pfadnamen zu trennen. Die Pfadnamen in SymbolPaths können Platzhalterzeichen enthalten, z. B. ein Sternchen (*) zur Darstellung mehrerer Zeichen und ein Fragezeichen (?), um ein einzelnes Zeichen darzustellen.

Wenn Sie -i in einen Befehl einschließen, aber -r auslassen, sucht Tracepdb nach den PDB-Dateien für die angegebenen Bilder in den Pfaden, die durch die Umgebungsvariable %_NT_SYMBOL_PATH% angegeben werden. Wenn die Umgebungsvariable nicht festgelegt ist, sucht Tracepdb im Standardsymbolpfad srv*\\\\\symbols\\symbols.

-pTMFPath
Gibt den Pfad zu dem Verzeichnis an, in dem TMF-Dateien gespeichert sind.

Wenn -p ohne -i verwendet wird, sucht Tracefmt im durch -p angegebenen Pfad nach einer vorhandenen TMF-Datei. Wenn -p ausgelassen wird, sucht Tracefmt nach der TMF-Datei im Wert der Umgebungsvariablen %TRACE_FORMAT_SEARCH_PATH%, wenn sie festgelegt ist. Andernfalls versucht Tracefmt, die Formatierungsanweisungen in der Datei Default.tmf anzuwenden.

Wenn -p mit -i verwendet wird, platziert Tracefmt die tmfmt-Datei, die erstellt wird, in dem durch -p angegebenen Verzeichnis. Wenn -p ausgelassen wird, platziert Tracefmt die TMF-Datei in dem Verzeichnis, das durch den Wert der Umgebungsvariablen %TRACE_FORMAT_SEARCH_PATH% angegeben wird, sofern sie festgelegt ist. Andernfalls platziert Tracefmt die Datei im lokalen Verzeichnis.

-H | /?
Zeigt die Hilfe an.

-oOutputFile
Gibt alternative Namen für die Tracefmt-Ausgabedatei und die Tracefmt-Zusammenfassungsmeldungsdatei an. Die Standardwerte sind FmfFile.txt (für die Ausgabedatei) und FmtSum.txt.sum (für die Zusammenfassungsdatei) im lokalen Verzeichnis.

OutputFile ist ein Pfad und Dateiname mit einer .txt Dateinamenerweiterung, z. B. c:\traces\trace.txt.

Wenn Sie diesen Parameter mit den Optionen -displayonly oder -summaryonly verwenden, wirkt sich dies nur auf die Zusammenfassungsmeldungsdatei aus.

-Csv
Formatiert die Tracefmt-Ausgabedatei als durch Trennzeichen getrennte Datei mit variabler Länge (.csv). Dieses Format fügt jeder Nachricht zusätzlich zum Standardpräfix der Ablaufverfolgungsnachricht ein detailliertes, strukturiertes Präfix hinzu.

Diese Option wirkt sich ggf. auf die Ausgabedatei und die Anzeige von Ablaufverfolgungsmeldungen im Eingabeaufforderungsfenster aus.

-csvheader
Fügt der CSV-Datei eine Zeile mit beschreibenden Spaltenüberschriften hinzu. Dieser Header ist besonders nützlich für die Interpretation des strukturierten Präfixes, das Tracefmt CSV-Dateien hinzufügt. Standardmäßig enthalten Tracefmt-CSV-Dateien keine Spaltenüberschriften.

-csvquote
Verdoppelt alle Anführungszeichen (") in der CSV-Datei. Dieses Feature ist für Anwendungen konzipiert, die Nur in Anführungszeichen angezeigt werden, wenn sie in Anführungszeichen eingeschlossen sind.

-Anzeigen
Zeigt die Ablaufverfolgungsmeldungen im Eingabeaufforderungsfenster an, zusätzlich zum Schreiben in die Ausgabedatei.

-displayonly
Zeigt die Ablaufverfolgungsmeldungen nur im Eingabeaufforderungsfenster an und erstellt keine Ausgabedatei.

-nosummary
Erstellt keine Zusammenfassungsmeldungsdatei.

-summaryonly
Erstellt nur eine Zusammenfassungsmeldungsdatei. Tracefmt erstellt keine Ausgabedatei.

-noprefix
Das Präfix der Ablaufverfolgungsnachricht wird weggelassen. Diese Option wirkt sich auf Ablaufverfolgungsmeldungen in der Ausgabedatei und der Tracefmt-Anzeige aus.

-Hires
Hohe Auflösung. Zeigt die Anzahl von Mikrosekunden und Nanosekunden im Zeitstempel der Ablaufverfolgungsnachricht an. Standardmäßig werden nur Millisekunden angezeigt.

Verwenden Sie diese Option, wenn ein Leistungsindikatoruhrwert für den Zeitstempel der Ablaufverfolgungsmeldung anstelle des Systemtimers verwendet wird, z. B. wenn der Parameter Tracelog -UsePerfCounter verwendet wird. Informationen zu Tracelog-Befehlen finden Sie unter Ablaufverfolgungsbefehlssyntax.

-Seq
Zeigt die lokalen oder globalen Sequenznummern im Präfix der Ablaufverfolgungsnachricht an. Wenn Sequenznummern in der Nachricht nicht aufgezeichnet wurden, wird das Feld nicht initialisiert oder mit Nullen oder "f"s gefüllt.

-Ods
Sendet die formatierten Ablaufverfolgungsmeldungen zur Anzeige an den Debugger.

-Gmt
Zeigt den Zeitstempel für jede Ablaufverfolgungsnachricht in Greenwich Mean Time (GMT) an.

Diese Option wirkt sich nur auf die Tracefmt-Ausgabedatei aus. Die Zeitstempel in der Etl-Datei (Ereignisablaufverfolgungsprotokoll) werden nicht konvertiert. Die Zeitzone des Ablaufverfolgungsprotokolls wird angezeigt, wenn Sie einen Tracefmt-Befehl übermitteln.

-Utc
Zeigt den Zeitstempel für jede Ablaufverfolgungsnachricht in koordinierter Weltzeit (UTC) an. UTC ist fast identisch mit GMT, stellt aber Mitternacht als Null dar.

Diese Option wirkt sich nur auf die Tracefmt-Ausgabedatei aus. Die Zeitstempel in der Etl-Datei (Ereignisablaufverfolgungsprotokoll) werden nicht konvertiert. Die Zeitzone der Ablaufverfolgungsprotokolldatei wird angezeigt, wenn Sie einen Tracefmt-Befehl übermitteln.

-Spur
Zeigt Ablaufverfolgungsaktionen an, wenn sie auftreten. Diese Informationen sind nützlich, wenn die Formatierung falsch ist oder Tracefmt einen Fehler oder eine Ausnahme meldet.

Die Anzeige der Ablaufverfolgung kann umfangreich sein. Erwägen Sie, die Tracefmt-Ausgabe zur späteren Prüfung an eine Textdatei umzuleiten.

-V
Ausführlich. Zeigt detaillierte Informationen im Eingabeaufforderungsfenster an, während Tracefmt jeden Block oder Puffer von Ablaufverfolgungsmeldungen verarbeitet. Verwenden Sie diese Option, wenn Sie Dateischäden oder Inkonsistenzen vermuten.

Kommentare

Suchen nach der TMF-Datei

Wenn Sie den - i-Parameter weglassen, verwendet Tracefmt die folgenden Methoden, um die TMF-Datei zu finden. Die Methoden werden in der Reihenfolge aufgeführt, in der Tracefmt sie verwendet.

• Der -tmf-Parameter .

• Der -p-Parameter .

• Die Umgebungsvariable %TRACE_FORMAT_SEARCH_PATH%.

• Default.tmf, eine Datei, die im WDK enthalten ist.

Wenn Tracefmt keine TMF-Datei finden kann oder die TMF-Datei keine Formatierungsinformationen für die Ablaufverfolgungsmeldungen enthält, kann Tracefmt die Nachrichten nicht anzeigen. Stattdessen wird die folgende Fehlermeldung anstelle der Ablaufverfolgungsmeldung geschrieben.

No Format Information found.

Ausnahme ausgelöst

Wenn Tracefmt keinen Ablaufverfolgungsmeldungsparameter formatieren kann, löst es eine Ausnahme aus und zeigt eine Meldung an, z. B.:

*****FormatMessage Header(Header) of EventTrace, parameter 23 raised an exception*****

Wenn eine ähnliche Ausnahme angezeigt wird, überprüfen Sie die Nachrichtendefinition im Quellcode mit besonderem Augenmerk auf alle benutzerdefinierten Variablentypen. Weitere Informationen finden Sie unter DoTraceMessage.

TMF-Dateien mit Nicht-GUID-Dateinamen

Wenn der TMF-Dateiname keine Meldungs-GUID ist, müssen Sie den Parameter -tmf verwenden, um die Datei zu identifizieren und den vollqualifizierten Pfad zur Datei einzugeben.

Formatieren von NT Kernel Logger-Ablaufverfolgungsmeldungen

Verwenden Sie zum Formatieren von Nachrichten aus der NT-Kernelprotokollierungs-Ablaufverfolgungssitzung oder einer Global Logger-Ablaufverfolgungssitzung den Parameter -tmf, um die Datei system.tmf anzugeben, eine Im WDK enthaltene Ablaufverfolgungsnachrichtformatdatei .

Formatieren von Ablaufverfolgungsmeldungen aus Echtzeitablaufverfolgungssitzungen

Wenn Sie den Parameter -rt (Echtzeit) verwenden, zeigt Tracefmt eine Meldung an, die bestätigt, dass er sich im Echtzeitmodus befindet, und wartet dann auf Ablaufverfolgungsmeldungen vom angegebenen Ablaufverfolgungsanbieter. Es kehrt erst zur Eingabeaufforderung zurück, wenn die Ablaufverfolgungssitzung beendet wird.

Formatieren von QPC-Zeitstempeln

Tracefmt formatiert die Werte der Systemleistungsindikatoruhr (QueryPerformanceCounter) nicht ordnungsgemäß. Wenn Sie diese hochauflösende Zeit verwenden, verwenden Sie Tracerpt, ein in Windows enthaltenes Tool, um die Ablaufverfolgungsmeldungen zu formatieren. Weitere Informationen finden Sie in der Beschreibung des - UsePerfCounter-Parameters in der Tracelog-Befehlssyntax.

Ablaufverfolgungsmeldungen außerhalb der Sequenz

Wenn Sie eine Ablaufverfolgungsmeldungsdatei auf einem Computer mit Windows XP anzeigen, werden auf der Anzeige möglicherweise Ablaufverfolgungsmeldungen angezeigt, die nicht sequenzieren. Um dieses Problem zu beheben, können Sie die Sequenznummer-Option verwenden, wenn Sie die Ablaufverfolgungssitzung starten und die Ablaufverfolgung mithilfe von Tracefmt anzeigen. Anschließend können Sie die Ablaufverfolgung mit Traceview anzeigen und nach Sequenznummer sortieren. Sie können die Ablaufverfolgung auch auf einem Computer anzeigen, auf dem Windows Server 2003 oder höhere Versionen von Windows ausgeführt werden.