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ファイルで定義されているロガーのセッション名を開始します。 |
-update [LoggerName]|[ProfileFileName!ProfileName|SessionName]] |
LoggerNameのログセッションを開始するか、 profilefilenameファイルで定義されているプロファイルProfileNameでロガーを開始するか、またはprofilefilenameファイルで定義されているロガーのセッション名を開始します。 |
-flush LoggerName |
LoggerNameのログセッションをフラッシュします。 このパラメーターは、バッファーモードトレースを保存するために必要です (下記の「 バッファリング パラメーター」を参照してください)。 バッファーモードのトレースを保存するには、 -flush パラメーターを発行する必要があります。 |
-capturestate LoggerName Flags |
フラグで指定されたプロバイダーからの非カーネルログセッションに対して状態をキャプチャします。 受け入れられるプロバイダーの形式は、の場合と同じです。 フラグとレベルが指定されている場合は、状態のキャプチャ中に有効になります。 これは、–buffering オプションから開始するトレーシングと呼ばれています。 –stop to stop トレーシングによりフォローされるべきものです。 |
-on Flags|Groups |
カーネルログセッションの場合は、有効にするカーネルフラグとグループのシーケンスをプラス記号 (+) で区切って指定します。 ユーザーログセッションの場合は、有効にするプロバイダーのシーケンスをプラス記号 (+) で区切って指定します。 受け入れられるプロバイダーの形式は |
-f filename |
指定したファイルにイベントを記録します。 既定値は、カーネルトレースの場合は\Kernal.etl、ユーザートレースの場合は\User-etl です。 |
-buffersize Size |
トレースバッファーのサイズを KB 単位で 設定します。 使用可能な値は4から1024です。 既定値は、64 です。 |
-minbuffers n |
トレースバッファーの最小数を nに設定します。 既定値は、64 です。 |
-maxbuffers n |
トレースバッファーの最小数を nに設定します。 既定値は 320 です。 |
-maxfile Size |
最大ファイルサイズをサイズ MBに設定します。 |
-flushtimer n |
フラッシュタイマーを n 秒に設定します。 |
-boottrace Flags|Groups|off |
ブートをトレースするように Windows イベントトレーシング logger を構成します。 ブートトレースをオフにするには、フラグを "off" に設定します。 すべてのログコントロールは、この組み合わせて使用できます。 -fと共に使用して、\Perf.etlを除くファイルにログを記録します。 |
-realtime |
リアルタイムトレースを有効にします。 |
-buffering |
バッファリングモードのトレースを有効にします。 保存するには、 -flushを使用します。 -stopオプションでは、トレースは保存されません。 |
-filemode Mode |
ファイルモードを設定します。 既定値は "Sequential" です。 使用可能なモード: "Sequential"、"Circular"、"Append"、および "NewFile"。 |
-clocktype ClockType |
クロックの種類を設定します。 既定値は "PerfCounter" です。 使用可能な型: "Cycle"、"PerfCounter"、および "SystemTime"。 |
-stackwalk flags|@file |
|
-pids pid [...] |
プロセスにフラグを適用 複数の pid を指定する場合は、 |
-pidnewprocess <command-line> |
Xperf が <command-line> で始まる新しいプロセスにフラグを適用します。 プライベートロガーと共に使用されます。 |
-waitfornewprocess |
を使用して作成された新しいプロセスが |
-heap |
PidとPidNewProcessによって指定されたプロセスでヒープトレースを有効にします。 |
-critsec |
PidとPidNewProcessによって指定されたプロセスでヒープトレースを有効にします。 |
-setprofint [<n>] [cached] |
サンプリングされたプロファイルの間隔を |
-save ProfileFileName!ProfileName|SessionName merged.etl |
ファイルProfilefilenameで定義されているプロファイルProfileName内のロガーをフラッシュし、etl ファイルをマージされた etl にマージします。または、ファイルProfilefilenameで定義されているロガーのセッションをフラッシュし、etl ファイルをマージされた .etl にマージします。 |
-seteresourcesample <n1><n2><n3> |
ERESOURCEを設定します。 n1 リリースのサンプリングレートが1000以上、n2 競合のサンプリングレートが1以上、n3 の超過タイムアウトの数が1以上の値を指定します。 競合のサンプルレートは、競合が発生したときにスピンロックイベントが取得される速度です。 たとえば、この値が100の場合、100のスピンロックの衝突ごとに1つのスピンロックイベントが取得されます。 |
-setspinlocksample <n1><n2><n3> |
スピンロックのスピンしきい値を |
-pooltag <P1>+<P2>+<P3>+<P4> |
プールタグフィルター (Pn) を正符号 (+) またはセミコロン (;) で区切って設定します。 1文字のワイルドカードには疑問符 (?) を使用し、複数の文字のワイルドカードにはアスタリスク (*) を使用します。 最大4つのフィルターを指定できます。 |
複数の logger を開始するには、複数の start オプションを使用し、その後にその logger に適用するオプションを指定します。 LoggerNameまたは-start LoggerName
が省略されている場合、カーネルロガーは暗黙的に指定されます。 カーネル logger のインスタンスは、いつでも1つしか存在できません。 ロガーの 1 つが起動に失敗した場合、既に開始されているロガーはすべて停止されます。