Freigeben über


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 (GUID|KnownProviderName)[:Flags[:Level]]. Siehe providers für eine Liste gültiger Flags.

-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 Flag+... festgelegt sind, oder analysiert die Datei file für Flags. Weitere Informationen finden Sie unter stackwalk.

-pids pid [...]

Wendet Flags auf pid [...]-Prozesse an. Wird in Verbindung mit privaten Loggern verwendet.

Trennen Sie sie bei der Angabe mehrerer Pids mit einem Leerzeichen, wie in -Pids 1234 6789

-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 -pidNewProcess erstellt wurde, um vor dem Beenden zurückzukehren.

-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 <n> [1221..10000000] fest. Wenn zwischengespeichert wird, werden Intervalle in ETW zwischengespeichert und erneut angewendet, wenn neue ETW-Kernelprotokollierer mit abgetastetem Profil gestartet werden. Die Einheiten sind 100n. Der Standardwert für n ist 10000; das heißt, 1ms: nicht zwischengespeichert.

-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 <n1> [ >=1]. Setzt die Abtastrate der Spinlock-Erfassung auf <n2> [ >= 1000]. Setzt die Abtastrate der Spinlock-Konflikte auf <n3> [ >= 1]. Nur 64-Bit-Windows 7, Windows Server 2008 R2 und neuere Versionen des Betriebssystems unterstützen die Spinlock-Instrumentierung.

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

XPerf-Optionen