start
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.