start
顯示記錄器啟動選項。
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’]]]
Command | 描述 |
---|---|
-start [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
啟動 LoggerName 的記錄工作階段、啟動 ProfileFileName 檔案中定義的設定檔 ProfileName 記錄器,或啟動 ProfileFileName 檔案中定義的記錄器 SessionName。 |
-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
更新 LoggerName 的記錄會話、更新 ProfileFileName 檔案中定義的配置檔 ProfileName 中的記錄器,或更新 ProfileFileName 檔案中定義的記錄器 SessionName。 |
-flush LoggerName |
排清 LoggerName 的記錄會話。 需要此參數才能儲存緩衝區模式追蹤(請參閱 下方的 -buffering 參數)。 若要儲存緩衝區模式追蹤,您必須發出 -flush 參數。 |
-capturestate LoggerName 旗標 |
從 Flags 中指定的提供者擷取狀態至非核心記錄會話。 接受的提供者格式與 - on 相同。 如果指定旗標和層級,則會在擷取狀態時啟用它們。 這是針對以 –buffering 選項開頭的追蹤所呼叫。 它後面必須接著 –stop 以停止追蹤。 |
-on 旗標|組 |
針對核心記錄會話,要啟用的核心旗標和群組順序,並以加號 (+) 分隔。 針對用戶記錄會話,要啟用的提供者序列,並以加號 (+) 分隔。 接受的提供者格式為 |
-f filename |
將事件記錄至指定的檔案。 默認為 \Kernel.etl for kernel traces 和 \User.etl for user traces。 |
-buffersize Size |
將追蹤緩衝區大小設定為 大小,以 KB 為單位。 可能的值為 4 到 1024。 預設值為 64。 |
-minbuffers n |
將追蹤緩衝區數目下限設定為 n。 預設值為 64。 |
-maxbuffers n |
將追蹤緩衝區數目上限設定為 n。 預設值為 320。 |
-maxfile 大小 |
將檔案大小上限設定為 [大小 MB]。 |
-flushtimer n |
將排清定時器設定為 n 秒。 |
-boottrace 旗標|群組|off |
設定 Windows 記錄器的事件追蹤以追蹤開機。 將旗標設定為 [關閉] 以關閉開機追蹤。 所有記錄控制項都可以搭配使用。 搭配 -f 使用 來登入 \Perf.etl 以外的檔案。 |
-realtime |
啟用即時追蹤。 |
-緩衝 |
啟用緩衝模式追蹤。 若要儲存,請使用 -flush。 -stop 選項不會儲存追蹤。 |
-filemode 模式 |
設定檔案模式。 預設值為 “Sequential”。 可能的模式:「循序」、「迴圈」、」附加」和 「NewFile」。。 |
-clocktype ClockType |
設定時鐘類型。 預設值為 “PerfCounter”。 可能的類型:「Cycle」、“ PerfCounter” 和 「SystemTime」。 |
-stackwalk 旗標|@file |
針對指定為 |
-pids pid [...] |
將旗標套用至進程 指定多個 pid 時,請以空格分隔它們,如 中所示 |
-pidnewprocess <命令行> |
將旗標套用至 Xperf 以命令行>開頭<的新進程。 與私人記錄器搭配使用。 |
-waitfornewprocess |
等候使用 |
-堆 |
在 Pids 和 PidNewProcess 所指定的進程中啟用堆積追蹤。 |
-critsec |
啟用 Pids 和 PidNewProcess 所指定進程中的重要區段追蹤。 |
-setprofint [<n>] [cached] |
將取樣的設定檔間隔設定為 |
-save ProfileFileName!ProfileName|SessionName merged.etl |
清除配置檔 ProfileFileName 中定義的記錄器,並將 ETL 檔案合併為 merged.etl;或清除檔案 ProfileFileName 中定義的記錄器 SessionName,並將 ETL 檔案合併至 Merged.etl。 |
-seteresourcesample <n1><n2><n3> |
設定ERESOURCE取樣,其中 n1 發行取樣率大於或等於1000、n2競爭取樣率大於或等於1,而 n3個過度逾時數目大於或等於1。 爭用取樣率是發生衝突時取得微調鎖定事件的速率。 例如,如果此值為 100,則會針對每一百個微調鎖定衝突取得一個微調鎖定事件。 |
-setspinlocksample <n1><n2><n3> |
將微調鎖定微調臨界值設定為 |
-pooltag< P1>+<P2>+<P3>+<P4> |
設定集區標籤篩選條件 (Pn)以加號 (+) 或分號分隔 (;)。 針對單一字元通配符或星號, 使用問號 (?) 作為多字元通配符。 最多可以指定四個篩選條件。 |
您可以使用多個開始選項來啟動多個記錄器,後面接著要套用至該記錄器的選項。 如果 省略 LoggerName 或 -start LoggerName
,則會隱含核心記錄器。 隨時只能存在核心記錄器的單一實例。 如果其中一個記錄器無法啟動,則所有已啟動的記錄器都會停止。