Tracefmt-Befehle

  • Artikel

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 stellen Sie eine TMF-Datei oder einen Pfad zu einem Verzeichnis von TMF-Dateien bereit:

    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 Datei des Ereignisprotokolls (.etl) an, die die Trace-Meldungen enthält. Geben Sie den Pfad (optional) und den Dateinamen ein. Die Standardeinstellung ist c:\logfile.etl.

-Rt SessionName
In Echtzeit. Formatiert Ablaufverfolgungsmeldungen aus den angegebenen Echtzeitablaufverfolgungssitzungen anstelle eines Ablaufverfolgungsprotokolls.

SessionName ist der Name der Trace-Session. Der Standardwert ist NT Kernel Logger.

-tmf TMFFile
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.

-Ich ImageFiles
Leitet Tracefmt an, um die PDB-Symboldateien für die angegebenen Bilddateien zu finden und eine TMF-Datei aus den Formatierungsanweisungen in den PDB-Dateien zu erstellen.

ImageFiles stellt den Pfad und Dateinamen einer oder mehrerer Binärdateien (.exe, .dll oder .sys) für Ablaufverfolgungsanbieter dar. Verwenden Sie ein Semikolon (;) zum Trennen von Bilddateinamen.

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

SymbolPaths stellt einen oder mehrere Pfade zu Verzeichnissen dar, die private Symbole oder Symbolserverpfade speichern. Verwenden Sie ein Semikolon (;) zum Trennen von Pfadnamen. 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" weglassen, sucht Tracepdb nach den PDB-Dateien nach den angegebenen Bildern in den pfaden, die durch die Umgebungsvariable %_NT_SYMBOL_PATH% angegeben wurden. Wenn die Umgebungsvariable nicht festgelegt ist, durchsucht Tracepdb den Standardsymbolpfad srv*\\\\symbols\\symbols.if the environment variable is not set, Tracepdb searches in the default symbol path, srv*\\\symbols\.

-p TMFPath
Gibt den Pfad zum Verzeichnis an, in dem TMF-Dateien gespeichert werden.

Wenn "-p " ohne "-i" verwendet wird, sucht Tracefmt in dem pfad, der von -p für eine vorhandene TMF-Datei angegeben ist. Wenn "-p " ausgelassen wird, sucht Tracefmt die TMF-Datei im Wert der Umgebungsvariable %TRACE_FORMAT_SEARCH_PATH%, falls sie festgelegt ist. Andernfalls versucht Tracefmt, die Formatierungsanweisungen in der Datei Default.tmf anzuwenden.

Wenn "-p " mit "-i" verwendet wird, platziert Tracefmt die von -p erstellte TMF-Datei im durch -p angegebenen Verzeichnis. Wenn -p ausgelassen wird, platziert Tracefmt die TMF-Datei im Verzeichnis, das durch den Wert der Umgebungsvariablen %TRACE_FORMAT_SEARCH_PATH% angegeben wird, falls sie festgelegt ist. Andernfalls platziert Tracefmt die Datei im lokalen Verzeichnis.

-h | /?
Zeigt die Hilfe an.

-o OutputFile
Gibt alternative Namen für die Tracefmt-Ausgabedatei und die Tracefmt-Zusammenfassungsnachrichtendatei 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 ein Dateiname mit einer .txt-Erweiterung, z. B. c:\traces\trace.txt.

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

-csv
Formatiert die Tracefmt-Ausgabedatei als kommagetrennte, variable Länge (.csv)-Datei. Dieses Format fügt jeder Nachricht zusätzlich zum Standardmäßigen Nachrichtenpräfix ein detailliertes, strukturiertes Präfix hinzu.

Diese Option wirkt sich auf die Ausgabedatei und die Anzeige von Ablaufverfolgungsmeldungen im Eingabeaufforderungsfenster aus, falls vorhanden.

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

-csvquote
Verdoppelt alle Anführungszeichen (") in der CSV-Datei. Dieses Feature wurde für Anwendungen entwickelt, die Anführungszeichen nur dann anzeigen, wenn sie in Anführungszeichen eingeschlossen sind.

-zeigen
Zeigt die Trace-Meldungen im Eingabeaufforderungsfenster an und schreibt sie zusätzlich in die Ausgabedatei.

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

-nosummary
Es wird keine Kurzmeldungsdatei erstellt.

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

-noprefix
Lässt das Trace Message Prefix aus. Diese Option wirkt sich auf Ablaufverfolgungsmeldungen in der Ausgabedatei und die Tracefmt-Anzeige aus.

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

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

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

-Ods
Sendet die formatierten Trace-Meldungen zur Anzeige an den Debugger.

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

Diese Option betrifft nur die Tracefmt-Ausgabedatei. Die Zeitstempel in der Ereignisablaufverfolgungsprotokolldatei (ETL) 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, aber sie stellt Mitternacht als Null dar.

Diese Option betrifft nur die Tracefmt-Ausgabedatei. Die Zeitstempel in der Ereignisablaufverfolgungsprotokolldatei (ETL) werden nicht konvertiert. Die Zeitzone der Ablaufverfolgungsprotokolldatei wird angezeigt, wenn Sie einen Tracefmt-Befehl senden.

-Spur
Zeigt Tracefmt-Aktionen an, sobald sie auftreten. Diese Informationen sind hilfreich, wenn die Formatierung falsch ist oder Wenn Tracefmt einen Fehler oder eine Ausnahme meldet.

Die Spuranzeige kann umfangreich sein. Erwägen Sie, die Tracefmt-Ausgabe zur späteren Untersuchung an eine Textdatei umzuleiten.

-v
Verbose. Zeigt detaillierte Informationen im Eingabeaufforderungsfenster an, während Tracefmt jeden Block oder Puffer von Trace-Meldungen verarbeitet. Verwenden Sie diese Option, wenn Sie dateibeschädigungen oder Inkonsistenzen vermuten.

Kommentare

Suchen der TMF-Datei

Wenn Sie den Parameter "-i " weglassen, verwenden Tracefmt die folgenden Methoden, um die TMF-Datei zu finden. Die Methoden werden aufgelistet, damit Tracefmt sie verwendet.

  • Der Parameter -tmf .

  • Der Parameter -p .

  • Die Umgebungsvariable %TRACE_FORMAT_SEARCH_PATH%.

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

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

No Format Information found.

Ausnahme ausgelöst

Wenn Tracefmt keinen Ablaufverfolgungsmeldungsparameter formatieren kann, löst sie eine Ausnahme aus und zeigt eine Meldung wie:

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

Wenn eine ähnliche Ausnahme angezeigt wird, überprüfen Sie die Nachrichtendefinition im Quellcode mit besonderer Aufmerksamkeit auf alle vom Benutzer angegebenen Variablentypen. Weitere Informationen finden Sie unter DoTraceMessage.

TMF-Dateien mit Nicht-GUID-Dateinamen

Wenn der NAME der TMF-Datei keine Nachrichten-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

Um Nachrichten aus der NT Kernel Logger-Ablaufverfolgungssitzung oder einer globalen Logger-Ablaufverfolgungssitzung zu formatieren, verwenden Sie den Parameter "-tmf", um die Datei "system.tmf" anzugeben, eine In der WDK enthaltene Ablaufverfolgungsformatdatei .

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. Sie kehrt erst an die Eingabeaufforderung zurück, wenn die Ablaufverfolgungssitzung beendet wird.

Formatieren von QPC-Zeitstempeln

Tracefmt formatiert die Werte der Systemleistungszähleruhr (QueryPerformanceCounter) nicht richtig. 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 Parameters "-UsePerfCounter " in der Tracelog-Befehlssyntax.

Ablaufverfolgungsmeldungen außerhalb der Sequenz

Wenn Sie eine Ablaufverfolgungsmeldungsdatei auf einem Computer unter Windows XP anzeigen, zeigt die Anzeige möglicherweise Ablaufverfolgungsmeldungen an, die nicht sequenziert sind. Um dieses Problem zu beheben, können Sie die Option "Sequenznummer" 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 mit Windows Server 2003 oder höheren Versionen von Windows anzeigen.