閱讀英文

共用方式為


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 旗標|組

針對核心記錄會話,要啟用的核心旗標和群組順序,並以加號 (+) 分隔。 針對用戶記錄會話,要啟用的提供者序列,並以加號 (+) 分隔。 接受的提供者格式為 (GUID|KnownProviderName)[:Flags[:Level]]。 如需有效旗標的清單,請參閱 提供者

-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

針對指定為 Flag+...的事件啟用堆棧行走,或剖析 旗標的檔案 檔案。 如需詳細資訊,請參閱 stackwalk

-pids pid [...]

將旗標套用至進程 pid [...]。 與私人記錄器搭配使用。

指定多個 pid 時,請以空格分隔它們,如 中所示 -Pids 1234 6789

-pidnewprocess <命令行>

將旗標套用至 Xperf 以命令行>開頭<的新進程。 與私人記錄器搭配使用。

-waitfornewprocess

等候使用 -pidNewProcess 建立的新進程在結束之前傳回。

-堆

在 PidsPidNewProcess指定的進程中啟用堆積追蹤。

-critsec

啟用 PidsPidNewProcess指定進程中的重要區段追蹤。

-setprofint [<n>] [cached]

將取樣的設定檔間隔設定為 <n> [1221..10000000]。 如果已指定快取,則會在 ETW 中快取間隔,並在每當啟動具有取樣配置檔的新 ETW 核心記錄器時重新套用。 單位為 100ns。 n預設值為 10000,也就是 1 毫秒:未快取。

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

將微調鎖定微調臨界值設定為 <n1> [ >=1]。 將微調鎖定取得取樣率設定為 <n2> [ >= 1000]。 將微調鎖定爭用取樣率設定為 <n3> [ >= 1]。 只有 64 位 Windows 7、Windows Server 2008 R2 和更新版本的作業系統支援微調鎖定檢測。

-pooltag< P1>+<P2>+<P3>+<P4>

設定集區標籤篩選條件 (Pn)以加號 (+) 或分號分隔 (;)。 針對單一字元通配符或星號, 使用問號 (?) 作為多字元通配符。 最多可以指定四個篩選條件。

備註

您可以使用多個開始選項來啟動多個記錄器,後面接著要套用至該記錄器的選項。 如果 省略 LoggerName-start LoggerName ,則會隱含核心記錄器。 隨時只能存在核心記錄器的單一實例。 如果其中一個記錄器無法啟動,則所有已啟動的記錄器都會停止。

Xperf 選項