英語で読む

次の方法で共有


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

カーネルログセッションの場合は、有効にするカーネルフラグとグループのシーケンスをプラス記号 (+) で区切って指定します。 ユーザーログセッションの場合は、有効にするプロバイダーのシーケンスをプラス記号 (+) で区切って指定します。 受け入れられるプロバイダーの形式は(GUID|KnownProviderName)[:Flags[:Level]]です 。 有効なフラグの一覧については、「 プロバイダー 」を参照してください。

-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

Flag+...として指定されたイベントに対してスタックウォークを有効にするか、 ファイルをフラグに解析します。 詳細については、stackwalk を参照してください。

-pids pid [...]

プロセスにフラグを適用pid [...] します。 プライベートロガーと共に使用されます。

複数の pid を指定する場合は、-Pids 1234 6789のようにスペースで区切ります。

-pidnewprocess <command-line>

Xperf が <command-line> で始まる新しいプロセスにフラグを適用します。 プライベートロガーと共に使用されます。

-waitfornewprocess

を使用して作成された新しいプロセスが -pidNewProcess 終了前に戻るまで待機します。

-heap

PidPidNewProcessによって指定されたプロセスでヒープトレースを有効にします。

-critsec

PidPidNewProcessによって指定されたプロセスでヒープトレースを有効にします。

-setprofint [<n>] [cached]

サンプリングされたプロファイルの間隔を<n> [1221..10000000]に設定 します。 キャッシュが指定されている場合、サンプリングされたプロファイルを持つ新しい ETW カーネルロガーが開始されるたびに、間隔が ETW にキャッシュされ、再適用されます。 単位は100nsです。 nの既定値は10000です。つまり、1ミリ秒: キャッシュされていません。

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

スピンロックのスピンしきい値を<n1> [ >=1]に設定します。 スピンロックの取得のサンプルレートを<n2> [ >= 1000]に設定します。 スピンロックの競合サンプル速度を<n3> [ >= 1]に設定します。 64ビット Windows 7、Windows Server 2008 R2、およびそれ以降のバージョンのオペレーティングシステムのみがスピンロックのインストルメンテーションをサポートします。

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

プールタグフィルター (Pn) を正符号 (+) またはセミコロン (;) で区切って設定します。 1文字のワイルドカードには疑問符 (?) を使用し、複数の文字のワイルドカードにはアスタリスク (*) を使用します。 最大4つのフィルターを指定できます。

解説

複数の logger を開始するには、複数の start オプションを使用し、その後にその logger に適用するオプションを指定します。 LoggerNameまたは-start LoggerName が省略されている場合、カーネルロガーは暗黙的に指定されます。 カーネル logger のインスタンスは、いつでも1つしか存在できません。 ロガーの 1 つが起動に失敗した場合、既に開始されているロガーはすべて停止されます。

Xperf のオプション