タイマーTimer

VSPerfCmd.exe の Timer オプションは、サンプリングするプロファイリング イベントをプロセッサのクロック サイクルに設定し、必要に応じて、サンプリング間隔のサイクル数を既定の 10,000,000 から変更します。The VSPerfCmd.exe Timer option sets the profiling event that is sampled to processor clock cycles and optionally changes the number of cycles in a sampling interval from the default of 10,000,000. 1 GHz のプロセッサでは、クロック サイクル数 10,000,000 の場合、1 秒あたりのサンプル数は約 100 になります。On a 1GH (one gigahertz) processor, 10,000,000 clock cycles is approximately 100 samples per second. 指定できる最小サイクル数は、50,000 です。The minimum number of cycles that can be specified is 50,000.

Timer を使用できるのは、サンプリング プロファイリング メソッドを使用する場合のみであり、Launch または Attach オプションも含むコマンド ラインでのみ使用できます。Timer can only be used when you use the sampling profiling method, and it can only be used in a command line that also contains the Launch or the Attach option.

既定では、プロファイラーのサンプリング イベントは、プロセッサのクロック サイクルに設定され、サンプリング間隔は 10,000,000 に設定されます。By default, the profiler sampling event is set to processor clock cycles and the sampling interval is set to 10,000,000. TimerPFSysCounter の各オプションを使用すると、サンプリング イベントおよびサンプリング間隔を設定できます。The Timer, PF, Sys, and Counter options enable you to set the sampling event and the sampling interval. GC オプションは、割り当ておよびガベージ コレクション イベントが発生するたびに、.NET メモリ データを収集します。The GC option collects .NET memory data at each allocation and garbage collection event. コマンド ラインには、上記のオプションのいずれか 1 つだけを指定できます。Only one of these options can be specified on a command line.

サンプリング イベントおよびサンプリング間隔は、Launch オプションまたは Attach オプションを含む最初のコマンド ラインでのみ設定できます。The sampling event and the sampling interval can be set only in the first command line that contains a Launch or an Attach option.

構文Syntax

VSPerfCmd.exe {/Launch:AppName|/Attach:PID} /Timer[:Cycles] [Options]  

パラメーターParameters

Cycles
サンプリング間隔でのプロセッサのクロック サイクル数を指定する整数の値。An integer value that specifies the number of processor clock cycles in a sampling interval. Cycles が指定されていない場合、間隔は 10,000,000 に設定されます。If Cycles is not specified, the interval is set to 10,000,000. コンマを含めずに値を指定してください。Specify the value without commas.

必須オプションRequired Options

Timer は、以下のいずれかのオプションを含むコマンド ラインでのみ指定できます。Timer can only be specified on a command line that contains one of the following options.

Launch: AppNameLaunch: AppName
プロファイラーと、AppName で指定されたアプリケーションを起動します。Starts the profiler and the application specified by AppName.

Attach: PIDAttach: PID
プロファイラーをプロセス ID (PID) で指定されたプロセスにアタッチします。Attaches the profiler to the process specified by the process ID (PID).

無効なオプションInvalid Options

以下のオプションは、Timer と同じコマンド ラインに指定することはできません。The following options cannot be specified on the same command line as Timer.

PF[:Events]PF[:Events]
サンプリング イベントをページ フォールトに設定します。オプションで、サンプリング間隔を Events に設定します。Sets the sampling event to page faults and optionally sets the sampling interval to Events. 既定の PF 間隔は 10 です。The default PF interval is 10.

Sys[:Events]Sys[:Events]
サンプリング イベントをオペレーティング システムの呼び出しに設定します。オプションで、サンプリング間隔を Events に設定します。Sets the sampling event to operating system calls and optionally sets the sampling interval to Events. 既定の Sys 間隔は 10 です。The default Sys interval is 10.

Counter[:Name,Reload,FriendlyName]Counter[:Name,Reload,FriendlyName]
サンプリング イベントを、Name で指定された CPU パフォーマンス カウンターに設定し、サプリング間隔を Reload に設定します。Sets the sampling event to the CPU performance counter specified by Name and sets the sampling interval to Reload.

GC[:{Allocation|Lifetime}]GC[:{Allocation|Lifetime}]
.NET メモリ データを収集します。Collects .NET memory data. 既定 (Allocation) では、データはメモリの割り当てイベントごとに収集されます。By default (Allocation), data is collected at every memory allocation event. Lifetime パラメーターが指定されている場合、ガベージ コレクション イベントごとのデータも収集されます。When the Lifetime parameter is specified, data is also collected at each garbage collection event.

Example

プロファイラーのサンプリング間隔をプロセッサ サイクル数 1,000,000 に設定する方法を次の例に示します。This example demonstrates how to set the profiler sampling interval to 1,000,000 processor cycles.

VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp  
VSPerfCmd.exe /Launch:TestApp.exe /Timer:1000000  

参照See Also

VSPerfCmd VSPerfCmd
スタンドアロン アプリケーションのプロファイリング Profiling Stand-Alone Applications
ASP.NET Web アプリケーションのプロファイリング Profiling ASP.NET Web Applications
プロファイリング (サービスの)Profiling Services