TraceView-Steuerungsbefehle
Hinweis
Die Befehlszeilenoptionen für TraceView sind veraltet. Verwenden Sie tracepdb.exe und tracefmt.exe, um PDBs in TMF-Dateien zu analysieren und ETL-Dateien in Text zu analysieren.
Verwenden Sie einen Traceview-Steuerelementbefehl zum Verwalten von Ablaufverfolgungssitzungen, einschließlich starten und beenden der Sitzung, Aktivieren und Deaktivieren von Anbietern, Aktualisieren der Eigenschaften der Ablaufverfolgungssitzung und Leeren von Ablaufverfolgungspuffern.
traceview {-start | -stop | -update | -enable | -disable | -flush | -q} SessionName [Parameters]
traceview {-enumguid | -l | -h | -x}
Befehlsparameter
Aktionen
| Aktion | Beschreibung |
|---|---|
| -anfangen | Startet die angegebene Ablaufverfolgungssitzung. |
| -aufhören | Beendet die angegebene Ablaufverfolgungssitzung. |
| -aktualisieren | Aktualisiert die Eigenschaften für die angegebene Ablaufverfolgungssitzung. |
| -ermöglichen | Aktiviert Anbieter für die angegebene Ablaufverfolgungssitzung. |
| -abschalten | Deaktiviert Anbieter für die angegebene Sitzung. |
| -erröten | Löscht die aktiven Puffer der angegebenen Ablaufverfolgungssitzung. Diese erzwungene Spülung ist zusätzlich zu den automatischen Leerungen, die auftreten, wenn ein Puffer voll ist und wenn die Ablaufverfolgungssitzung beendet wird. |
| -q | Fragen Sie den Status der angegebenen Ablaufverfolgungssitzung ab. |
| -enumguid | Listet Anbieter auf dem System auf, die bei der Ereignisablaufverfolgung für Windows (ETW) registriert sind. |
| -l | Auflisten aller Ablaufverfolgungssitzungen, die auf dem Computer ausgeführt werden. |
| -x | Beendet alle Ablaufverfolgungssitzungen. |
Parameter
SessionName
Bei Verwendung mit "-start" ist SessionName ein Name, den Sie zur Darstellung der Ablaufverfolgungssitzung auswählen. Mit allen anderen Befehlen identifiziert SessionName die Ablaufverfolgungssitzung.
-f [LogFile]
Bei Verwendung mit -start startet -f eine Ablaufverfolgungsprotokollsitzung. LogFile gibt den Pfad (optional) und den Dateinamen der Ereignisablaufverfolgungsprotokolldatei (ETL) an. Der Standardwert ist "C:\LogFile.etl".
Bei Verwendung mit -update sendet -f alle neuen Ablaufverfolgungsmeldungen nur an das angegebene Ablaufverfolgungsprotokoll. Verwenden Sie diesen Parameter, um eine Echtzeitablaufverfolgungssitzung in eine Ablaufverfolgungssitzung zu konvertieren oder ein neues Ablaufverfolgungsprotokoll für eine vorhandene Ablaufverfolgungsprotokollsitzung zu starten. Verwenden Sie zum Senden von Ablaufverfolgungsnachrichten an einen Consumer in Echtzeit und an ein Ablaufverfolgungsprotokoll sowohl die Parameter "-rt " als auch "-f " im Befehl "-update ".
-Rt
Bei Verwendung mit -start startet -rt eine Echtzeitablaufverfolgungssitzung (eine Ablaufverfolgungssitzung (-f) ist die Standardeinstellung.) Wenn Sie "-rt" und "-f" in einem Befehl "-start" verwenden, werden die Ablaufverfolgungsmeldungen an den Consumer der Ablaufverfolgung und an eine Ereignisablaufverfolgungsprotokolldatei gesendet.
Bei Verwendung mit "-update" fügt "-rt " einer Ablaufverfolgungsprotokollsitzung echtzeitbasierte Nachrichtenübermittlung hinzu. Alle neuen Ablaufverfolgungsmeldungen werden zusätzlich zu einem Ablaufverfolgungsprotokoll direkt an den Ablaufverfolgungsanwender (wie in einer Echtzeitablaufverfolgungssitzung) gesendet.
-guid {#GUID GUID GUIDFile | }
Gibt einen oder mehrere Ablaufverfolgungsanbieter an. Verwenden Sie "-start", um Anbieter für eine Ablaufverfolgungssitzung zu aktivieren. Wird mit "-enable " verwendet, um die Anbieter zu aktivieren oder deren Werte auf -flag oder -level zu ändern. Verwenden Sie "-disable", um die zu deaktivierenden Anbieter anzugeben.
GUID kann entweder eine Steuerelement-GUID (vor einem Nummernzeichen (#)) oder den Pfad (optional) und den Dateinamen einer Textdatei angeben, z. B. eine Steuerelement-GUID-Datei (CTL), die die Steuerelement-GUIDs eines oder mehrerer Ablaufverfolgungsanbieter enthält.
Wenn Sie den Parameter "-guid " aus einem Befehl "-start " weglassen, startet TraceView eine NT Kernel Logger-Ablaufverfolgungssitzung.
TraceView übergibt die Werte der folgenden Unterparameter an die angegebenen Anbieter.
| Parameter | Beschreibung |
|---|---|
| SessionName | Bei Verwendung mit "-start" ist SessionName ein Name, den Sie zur Darstellung der Ablaufverfolgungssitzung auswählen. Mit allen anderen Befehlen identifiziert SessionName die Ablaufverfolgungssitzung. |
| -f \[LogFile\] | Bei Verwendung mit -start startet -f eine Ablaufverfolgungsprotokollsitzung. LogFile gibt den Pfad (optional) und den Dateinamen der Ereignisablaufverfolgungsprotokolldatei (ETL) an. Der Standardwert ist "C:\\LogFile.etl". Bei Verwendung mit "-update" sendet -f alle neuen Ablaufverfolgungsmeldungen nur an das angegebene [Ablaufverfolgungsprotokoll](trace-log.md). Verwenden Sie diesen Parameter, um eine Echtzeitablaufverfolgungssitzung in eine Ablaufverfolgungssitzung zu konvertieren oder ein neues Ablaufverfolgungsprotokoll für eine vorhandene Ablaufverfolgungsprotokollsitzung zu starten. Verwenden Sie zum Senden von Ablaufverfolgungsnachrichten an einen Consumer in Echtzeit und an ein Ablaufverfolgungsprotokoll sowohl die Parameter "-rt " als auch "-f " im Befehl "-update ". |
| -Rt | Bei Verwendung mit -start startet -rt eine Echtzeitablaufverfolgungssitzung (eine Ablaufverfolgungssitzung (-f) ist die Standardeinstellung.) Wenn Sie "-rt" und "-f" in einem Befehl "-start" verwenden, werden die Ablaufverfolgungsmeldungen an den Consumer der Ablaufverfolgung und an eine Ereignisablaufverfolgungsprotokolldatei gesendet. Bei Verwendung mit "-update" fügt "-rt " einer Ablaufverfolgungsprotokollsitzung echtzeitbasierte Nachrichtenübermittlung hinzu. Alle neuen Ablaufverfolgungsnachrichten werden direkt an den Ablaufverfolgungsanwender (wie in einer Echtzeitablaufverfolgungssitzung) gesendet, zusätzlich zu einem [Ablaufverfolgungsprotokoll](trace-log.md). |
| -guid {\#GUID GUID GUIDFile | } | Gibt einen oder mehrere Ablaufverfolgungsanbieter an. Verwenden Sie "-start", um Anbieter für eine Ablaufverfolgungssitzung zu aktivieren. Wird mit "-enable " verwendet, um die Anbieter zu aktivieren oder deren Werte auf -flag oder -level zu ändern. Verwenden Sie "-disable", um die zu deaktivierenden Anbieter anzugeben. GUID kann entweder eine [Steuerelement-GUID](control-guid.md) (vorangestellt durch ein Nummernzeichen (\#)) oder den Pfad (optional) und den Dateinamen einer Textdatei angeben, z. B. eine Steuerelement-GUID-Datei (CTL), die die Steuerelement-GUIDs eines oder mehrerer Ablaufverfolgungsanbieter enthält. Wenn Sie den Parameter "-guid " aus einem Befehl "-start " weglassen, startet TraceView eine [NT Kernel Logger-Ablaufverfolgungssitzung](nt-kernel-logger-trace-session.md). |
TraceView übergibt die Werte der folgenden Unterparameter an den angegebenen Anbieter:
-b Puffergröße
Gibt die Größe jedes Puffers in KB an, der der Ablaufverfolgungssitzung zugeordnet ist. Wird nur für "-start" verwendet.
Der Standardwert wird durch die Anzahl der Prozessoren, die Menge des physischen Arbeitsspeichers und das verwendete Betriebssystem bestimmt.
-Min NumberOfBuffers
Gibt die Anzahl der Puffer an, die anfänglich zum Speichern von Ablaufverfolgungsmeldungen zugewiesen wurden. Wird nur für "-start" verwendet.
Der Standardwert wird durch die Anzahl der Prozessoren, die Menge des physischen Arbeitsspeichers und das verwendete Betriebssystem bestimmt.
-Max NumberOfBuffers
Bei Verwendung mit -start gibt -max die maximale Anzahl von Puffern an, die für die Ablaufverfolgungssitzung zugewiesen wurden. Der Standardwert wird durch die Anzahl der Prozessoren, die Menge des physischen Arbeitsspeichers und das verwendete Betriebssystem bestimmt.
Bei Verwendung mit -update ändert -max die maximale Anzahl von Puffern, die der Ablaufverfolgungssitzung zugeordnet sind.
-Ft FlushTime
Bei Verwendung mit "-start" gibt "-ft" an, wie oft die Ablaufverfolgungsmeldungspuffer in Sekunden geleert werden. Bei Verwendung mit -update ändert -ft die Leerzeit in die angegebene Uhrzeit.
Die minimale Spülzeit beträgt 1 Sekunde. Der Standardwert ist 0 (kein erzwungenes Leeren).
Diese erzwungene Löschung ist zusätzlich zu den Leerungen, die automatisch auftreten, wenn ein Ablaufverfolgungsmeldungspuffer voll ist und wenn eine Ablaufverfolgungssitzung beendet wird.
Siehe auch: -flush.
-seitennummeriert
Verwendet ausgelagerten Speicher für die Ablaufverfolgungsmeldungspuffer. Die Ereignisablaufverfolgung verwendet standardmäßig nicht ausgelagerten Arbeitsspeicher für Puffer. Wird nur für "-start" verwendet.
Verwenden Sie diesen Parameter nicht, wenn der Anbieter ein Treiber ist, der Ablaufverfolgungsmeldungen bei einem IRQL-Wert generiert, der größer als DISPATCH_LEVEL ist.
Dieser Parameter wird in Windows 2000 nicht unterstützt.
-Seq MaxFileSize
Gibt die sequenzielle Protokollierung (am Ende der Datei, Beenden der Aufzeichnung von Ereignissen) an die Ereignisablaufverfolgungsprotokolldatei (ETL) an. Wird nur für "-start" verwendet.
MaxFileSize gibt die maximale Größe der Datei in MB an. Ohne einen MaxFileSize-Wert wird dieser Parameter ignoriert.
Die sequenzielle Protokollierung ist die Standardeinstellung, Sie können diesen Parameter jedoch verwenden, um die maximale Dateigröße festzulegen oder -prealloc zu verwenden. Ohne diesen Parameter gibt es keine Dateigrößenbeschränkung.
-Cir MaxFileSize
Gibt die Zirkelprotokollierung (am Ende der Datei, Aufzeichnen neuer Nachrichten über die ältesten Nachrichten) in der Ereignisablaufverfolgungsprotokolldatei (ETL) an. Wird nur für "-start" verwendet.
MaxFileSize gibt die maximale Größe der Datei in MB an. Ohne einen MaxFileSize-Wert wird dieser Parameter ignoriert.
Die Standardeinstellung ist die sequenzielle Protokollierung ohne Dateigrößenbeschränkung.
-prealloc
Reserviert Platz für die Ereignisablaufverfolgungsprotokolldatei (ETL), bevor sie zugeordnet wird. Wird nur für "-start" verwendet.
Dieser Parameter erfordert "-seq " oder "-cir " mit MaxFileSize. Sie ist mit "-newfile" ungültig.
Flag stellt einen Flagwert dar, der im Ablaufverfolgungsanbieter im Dezimal- oder Hexadezimalformat definiert ist. Der Standardwert ist 0. Werte aus 0x01000000 bis 0xFF000000 sind für die zukünftige Verwendung reserviert.
Die Bedeutung der Flags wird unabhängig von jedem Ablaufverfolgungsanbieter definiert. In der Regel stellen Flags immer detailliertere Berichtsebenen dar.
In einem Befehl "-start " gilt der Flagswert für alle Ablaufverfolgungsanbieter in der Ablaufverfolgungssitzung. Wenn Sie für jeden Ablaufverfolgungsanbieter unterschiedliche Flags festlegen möchten, verwenden Sie für jeden Ablaufverfolgungsanbieter einen separaten Befehl "-enable ".
| Unterparameter von -guid | Beschreibung |
|---|---|
-flag Flag |
|
|
-Level |
Gibt die Ablaufverfolgungsebene für die Anbieter in der Ablaufverfolgungssitzung an. Die Ebene bestimmt, welche Ereignisse der Ablaufverfolgungsanbieter generiert. Level stellt einen Ebenenwert im Dezimal- oder Hexadezimalformat dar. Der Standardwert ist 0. Die Bedeutung des Levelwerts wird unabhängig von jedem Ablaufverfolgungsanbieter definiert. In der Regel stellt die Ablaufverfolgungsebene den Schweregrad des Ereignisses dar (Informationen, Warnungen oder Fehler). In einem Befehl "-start " gilt der Levelwert für alle Ablaufverfolgungsanbieter in der Ablaufverfolgungssitzung. Wenn Sie für jeden Ablaufverfolgungsanbieter unterschiedliche Ebenen festlegen möchten, verwenden Sie für jeden Ablaufverfolgungsanbieter einen separaten Befehl "-enable ". |
| -b BufferSize | Gibt die Größe jedes Puffers in KB an, der der Ablaufverfolgungssitzung zugeordnet ist. Wird nur für "-start" verwendet.
Der Standardwert wird durch die Anzahl der Prozessoren, die Menge des physischen Arbeitsspeichers und das verwendete Betriebssystem bestimmt. |
| -min NumberOfBuffers | Gibt die Anzahl der Puffer an, die anfänglich zum Speichern von Ablaufverfolgungsmeldungen zugewiesen wurden. Wird nur für "-start" verwendet.
Der Standardwert wird durch die Anzahl der Prozessoren, die Menge des physischen Arbeitsspeichers und das verwendete Betriebssystem bestimmt. |
| -max NumberOfBuffers | Bei Verwendung mit -start gibt -max die maximale Anzahl von Puffern an, die für die Ablaufverfolgungssitzung zugewiesen wurden. Der Standardwert wird durch die Anzahl der Prozessoren, die Menge des physischen Arbeitsspeichers und das verwendete Betriebssystem bestimmt.
Bei Verwendung mit -update ändert -max die maximale Anzahl von Puffern, die der Ablaufverfolgungssitzung zugeordnet sind. |
| -ft FlushTime | Bei Verwendung mit "-start" gibt "-ft" an, wie oft die Ablaufverfolgungsmeldungspuffer in Sekunden geleert werden. Bei Verwendung mit -update ändert -ft die Leerzeit in die angegebene Uhrzeit.
Die minimale Spülzeit beträgt 1 Sekunde. Der Standardwert ist 0 (kein erzwungenes Leeren). Diese erzwungene Löschung ist zusätzlich zu den Leerungen, die automatisch auftreten, wenn ein Ablaufverfolgungsmeldungspuffer voll ist und wenn eine Ablaufverfolgungssitzung beendet wird. Siehe auch: -flush. |
| -age AgeLimit | Bei Verwendung mit "-start" gibt "-age" an, wie lange (in Minuten) nicht verwendete Ablaufverfolgungspuffer aufbewahrt werden, bevor sie freigegeben werden. Bei Verwendung mit -update ändert -age die Altersgrenze in den angegebenen Wert.
Der Altersgrenzwert gibt an, wie lange (in Minuten) nicht verwendete Ablaufverfolgungspuffer beibehalten werden, bevor sie freigegeben werden. Der Standardwert ist 15 Minuten. Dieser Parameter ist nur in Windows 2000 gültig. |
| -seitennummeriert | Verwendet ausgelagerten Speicher für die Ablaufverfolgungsmeldungspuffer. Die Ereignisablaufverfolgung verwendet standardmäßig nicht ausgelagerten Arbeitsspeicher für Puffer. Wird nur für "-start" verwendet.
Verwenden Sie diesen Parameter nicht, wenn der Anbieter ein Treiber ist, der Ablaufverfolgungsmeldungen bei einem IRQL-Wert generiert, der größer als DISPATCH\_LEVEL ist. Dieser Parameter wird in Windows 2000 nicht unterstützt. |
| -seq MaxFileSize | Gibt die sequenzielle Protokollierung (am Ende der Datei, Beenden der Aufzeichnung von Ereignissen) an die Ereignisablaufverfolgungsprotokolldatei (ETL) an. Wird nur für "-start" verwendet.
MaxFileSize gibt die maximale Größe der Datei in MB an. Ohne einen MaxFileSize-Wert wird dieser Parameter ignoriert. Die sequenzielle Protokollierung ist die Standardeinstellung, Sie können diesen Parameter jedoch verwenden, um die maximale Dateigröße festzulegen oder -prealloc zu verwenden. Ohne diesen Parameter gibt es keine Dateigrößenbeschränkung. |
| -cir MaxFileSize | Gibt die Zirkelprotokollierung (am Ende der Datei, Aufzeichnen neuer Nachrichten über die ältesten Nachrichten) in der Ereignisablaufverfolgungsprotokolldatei (ETL) an. Wird nur für "-start" verwendet.
MaxFileSize gibt die maximale Größe der Datei in MB an. Ohne einen MaxFileSize-Wert wird dieser Parameter ignoriert. Die Standardeinstellung ist die sequenzielle Protokollierung ohne Dateigrößenbeschränkung. |
| -prealloc | Reserviert Platz für die Ereignisablaufverfolgungsprotokolldatei (ETL), bevor sie zugeordnet wird. Wird nur für "-start" verwendet.
Dieser Parameter erfordert "-seq " oder "-cir " mit MaxFileSize. Sie ist mit "-newfile" ungültig. Das System erstellt die Ereignisablaufverfolgungsprotokolldatei (ETL) mit einer Größe, die dem maxFileSize-Wert entspricht, der mithilfe der Parameter "-seq" oder "-cir" angegeben wird. Wenn Sie die Sitzung beenden, wird die Protokolldatei auf die Größe des Inhalts reduziert. |
| -newfile MaxFileSize | Erstellt eine neue Ereignisablaufverfolgungsprotokolldatei (.etl), wenn die vorhandene Datei MaxFileSize erreicht. Wird nur für "-start" verwendet.
MaxFileSize gibt die maximale Größe jeder Protokolldatei in MB an. Ohne einen MaxFileSize-Wert wird dieser Parameter ignoriert. Bei Verwendung von -newfile müssen Sie auch den Parameter "-f LogFile " verwenden, und der Wert von LogFile muss ein Name sein, der die Zeichen "%d " enthält, um ein Dezimalmuster anzugeben, z. B. trace%d.etl. Andernfalls schlägt der Befehl mit ERROR\_INVALID\_NAME fehl. Windows erhöht den Dezimalwert im Dateinamen jedes Mal, wenn eine neue Datei erstellt wird. Dieser Parameter ist bei der Präallocation (-prealloc logging (-cir), mit der NT Kernel Logger-Sitzung oder für private Ablaufverfolgungssitzungen nicht gültig. Es wird in Windows 2000 nicht unterstützt. |
| -anfügen | Fügt die Ablaufverfolgungsmeldungen an eine vorhandene Ereignisablaufverfolgungsprotokolldatei (.etl) an. Standardmäßig wird eine neue Datei erstellt. Wird nur für "-start" verwendet.
Dieser Parameter ist nur für sequenzielle Dateien gültig und nur, wenn -f verwendet wird und -rt nicht verwendet wird. Es wird in Windows 2000 nicht unterstützt. |
| -kd | Leitet die Ablaufverfolgungsmeldungen an KD oder Windbg weiter, je nachdem, was angefügt ist. Dieser Parameter legt außerdem die Größe des Ablaufverfolgungspuffers auf 3 KB, die maximale Puffergröße für den Debugger fest und ignoriert alle -b-Parameter im Befehl. Wird nur für "-start" verwendet. |
Kommentare
Ein Traceview-Befehl ohne Parameter öffnet das TraceView-Fenster.
Sie können den Befehl TraceView -start verwenden, um eine globale Logger-Ablaufverfolgungssitzung zu starten. Verwenden Sie dazu das folgende Befehlsformat. Im Gegensatz zu anderen Befehlen wird bei dem Wort "GlobalLogger" in diesem Befehlsformat die Groß-/Kleinschreibung beachtet.
traceview -start GlobalLogger [parameters]