Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Zeigt Startoptionen für die Protokollierung an.
xperf [-start [LoggerName] [ProfileFileName!ProfileName|SessionName]|-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] -flush [LoggerName] -save ProfileFileName!ProfileName|SessionName merged.etl -setprofint [<n>] [cached] -seteresourcesample <n1> <n2> <n3> -setspinlocksample <n1> <n2> <n3> -pooltag <P1>+<P2>+<P3>+<P4> -on (GUID|KnownProviderName)[:Flags[:Level[<:0xnnnnnnnn|’stack|[,]sid[,]tsid’]]]
Parameter
| Befehl | Beschreibung |
|---|---|
-start [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
Startet eine Protokollierungssitzung für LoggerName, startet Logger im Profil ProfileName, das in der Datei ProfileFileName definiert ist, oder startet Logger SessionName, der in der Datei ProfileFileName definiert ist. |
-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
Aktualisiert eine Protokollierungssitzung für LoggerName, aktualisiert Logger im Profil ProfileName, das in der Datei ProfileFileName definiert ist, oder aktualisiert Logger SessionName, der in der Datei ProfileFileName definiert ist. |
-flush LoggerName |
Löscht eine Protokollierungssitzung für LoggerName. Dieser Parameter ist erforderlich, um eine Puffermodusablaufverfolgung zu speichern (siehe Parameter -buffering unten). Um eine Puffermodusablaufverfolgung zu speichern, müssen Sie den Parameter -flush ausstellen. |
-capturestate LoggerName Flags |
Erfasst den Status für die Nicht-Kernelprotokollierungssitzung von Anbietern, die in Flags angegeben sind. Das akzeptierte Anbieterformat ist das gleiche wie für -on. Wenn Flags und Level angegeben werden, werden sie beim Erfassen des Zustands aktiviert. Dies wird für die Ablaufverfolgung aufgerufen, die mit der Option -buffering gestartet wurde. Es muss von –stop gefolgt werden, um die Ablaufverfolgung zu beenden. |
-on Flags|Groups |
Bei Kernelprotokollierungssitzungen wird die Sequenz von Kernel-Flags und -Gruppen aktiviert, getrennt durch Pluszeichen (+). Bei Benutzerprotokollierungssitzungen wird die Reihenfolge der zu aktivierenden Anbieter durch Pluszeichen (+) getrennt. Das akzeptierte Anbieterformat ist |
-f filename |
Protokolliert Ereignisse in der angegebenen Datei. Der Standardwert ist \Kernel.etl für Kernelablaufverfolgungen und \User.etl für Benutzerablaufverfolgungen. |
-buffersize Size |
Legt die Größe des Ablaufverfolgungspuffers auf Size in KB fest. Mögliche Werte sind 4 bis 1024. Der Standardwert ist 64. |
-minbuffers n |
Legt die Mindestanzahl der Ablaufverfolgungspuffer auf n fest. Der Standardwert ist 64. |
-maxbuffers n |
Legt die maximale Anzahl von Ablaufverfolgungspuffern auf nfest. Der Standardwert ist 320. |
-maxfile Size |
Legt die maximale Dateigröße auf Size MB fest. |
-flushtimer n |
Legt den Leerzeitgeber auf n Sekunden fest. |
-boottrace Flags|Groups|off |
Konfiguriert die Ereignisablaufverfolgung für Windows-Logger zum Ablaufverfolgungsstart. Legt Flags auf „deaktiviert“ fest, um die Startablaufverfolgung zu deaktivieren. Alle Protokollierungssteuerelemente können in Verbindung mit diesem Verwendet werden. Verwenden Sie in Verbindung mit -f, um sich bei einer anderen Datei als \Perf.etl anzumelden. |
-realtime |
Aktiviert echtzeitbasierte Ablaufverfolgung. |
-buffering |
Aktiviert die Puffermodusablaufverfolgung. Verwenden Sie -flush zum Speichern. Die Option -stop speichert die Ablaufverfolgung nicht. |
-filemode Mode |
Legt den Dateimodus fest. Der Standardwert ist „Sequential“. Mögliche Modi: „Sequential“, „Circular“, „Append“, and „NewFile“. |
-clocktype ClockType |
Legt den Uhrtyp fest. Der Standardwert ist „PerfCounter“. Mögliche Typen: „Cycle“, „PerfCounter“ und „SystemTime“. |
-stackwalk flags|@file |
Aktiviert das Stapelgehen für die Ereignisse, die als |
-pids pid [...] |
Wendet Flags auf Trennen Sie sie bei der Angabe mehrerer Pids mit einem Leerzeichen, wie in |
-pidnewprocess <command-line> |
Wendet Flags auf einen neuen Prozess an, den Xperf mit <command-line> beginnt. Wird in Verbindung mit privaten Loggern verwendet. |
-waitfornewprocess |
Wartet auf einen neuen Prozess, der mithilfe von |
-heap |
Aktiviert die Heap-Ablaufverfolgung in Prozessen, die von Pids und PidNewProcess angegeben werden. |
-critsec |
Aktiviert die Ablaufverfolgung kritischer Abschnitte in Prozessen, die von Pids und PidNewProcess angegeben werden. |
-setprofint [<n>] [cached] |
Legt das Profilintervall für Stichproben auf |
-save ProfileFileName!ProfileName|SessionName merged.etl |
Löscht die Logger in Profilprofilname, die in der Datei ProfileFileName definiert sind, und führt die ETL-Dateien mit merge.etl zusammen; oder löscht Logger SessionName, der in der Datei ProfileFileName definiert ist, und führt die ETL-Datei mit Merge.etl zusammen. |
-seteresourcesample <n1><n2><n3> |
Legt die ERESOURCE-Abtastung fest, wobei n1 die Freigabe-Abtastrate größer oder gleich 1000 ist, n2 die Konfliktabtastrate größer oder gleich 1 ist und n3 die Anzahl der übermäßigen Timeouts größer oder gleich 1 ist. Die Konfliktabtastrate ist die Rate, mit der Spinlock-Ereignisse erfasst werden, wenn Kollisionen auftreten. Wenn dieser Wert beispielsweise 100 beträgt, wird ein Spinlock-Ereignis für jeweils einhundert Spinlock-Kollisionen erfasst. |
-setspinlocksample <n1><n2><n3> |
Setzt den Spinlock-Schwellenwert auf |
-pooltag <P1>+<P2>+<P3>+<P4> |
Legt die Pooltagfilter (Pn) durch Pluszeichen (+) oder Semikolons (;) getrennt fest. Verwenden Sie ein Fragezeichen (?) für einen Einzelzeichen-Platzhalter oder ein Sternchen (*) für einen Platzhalter mit mehreren Zeichen. Maximal vier Filter können angegeben werden. |
Bemerkungen
Mehrere Logger können mit mehreren Startoptionen gestartet werden, gefolgt von den Optionen, die auf diesen Logger angewendet werden sollen. Wenn LoggerName oder -start LoggerName weggelassen wird, wird der Kernel-Logger impliziert. Nur eine einzelne Instanz des Kernel-Loggers kann jederzeit vorhanden sein. Wenn einer der Logger nicht startet, werden alle bereits gestarteten Logger gestoppt.