VSPerfASPNETCmd を使用した迅速な Web サイト プロファイリングRapid Web Site Profiling with VSPerfASPNETCmd

VSPerfASPNETCmd コマンド ライン ツールを使用すると、ASP.NETASP.NET Web アプリケーションを簡単にプロファイルできます。The VSPerfASPNETCmd command line tool enables you to easily profile ASP.NETASP.NET Web applications. VSPerfCmd コマンド ライン ツールと比較すると、オプションが減り、環境変数を設定する必要がなく、コンピューターを再起動する必要がありません。In comparison to the VSPerfCmd command line tool, options are reduced, no environment variables have to be set, and rebooting the computer is not required. スタンドアロン プロファイラーでプロファイリングを行う場合は、VSPerfASPNETCmd の使用をお勧めします。Using VSPerfASPNETCmd is the preferred method for profiling with the standalone profiler. 詳細については、「方法: スタンドアロンのプロファイラーをインストールする」をご覧ください。For more information, see How to: Install the Stand-Alone Profiler.

注意

Windows 8 および Windows Server 2012 の強化されたセキュリティ機能によって、Visual Studio プロファイラーがこれらのプラットフォームでデータを収集する方法に大幅な変更が必要になりました。Enhanced security features in Windows 8 and Windows Server 2012 required significant changes in the way the Visual Studio profiler collects data on these platforms. UWP アプリにも新しい収集手法が必要です。UWP apps also require new collection techniques. Performance Tools on Windows 8 and Windows Server 2012 applications (Windows 8 および Windows Server 2012 アプリケーションのパフォーマンス ツール)」をご覧ください。See Performance Tools on Windows 8 and Windows Server 2012 applications.

同時実行データの収集やプロファイリングの一時停止と再開などの一部のシナリオでは、プロファイリングに VSPerfCmd の使用をお勧めします。In some scenarios, such as collecting concurrency data or pausing and resuming profiling, using VSPerfCmd is the preferred profiling method.

注意

プロファイリング ツールのコマンド ライン ツールは、Visual StudioVisual Studio インストール ディレクトリの \Team Tools\Performance Tools サブディレクトリにあります。Command-line tools of the Profiling Tools are located in the \Team Tools\Performance Tools subdirectory of the Visual StudioVisual Studio installation directory. 64 ビットのコンピューターでは、32 ビットの \Team Tools\Performance Tools ディレクトリにある VSPerfASPNETCmd ツールを使用します。On 64 bit computers, use the VSPerfASPNETCmd tool located in the 32 bit \Team Tools\Performance Tools directory. プロファイラー コマンド ライン ツールを使用するには、コマンド プロンプト ウィンドウの PATH 環境変数にツールのパスを追加するか、コマンド自体にそれを追加します。To use the profiler command-line tools, you must add the tools path to the PATH environment variable of the command prompt window or add it to the command itself. 詳細については、「コマンド ライン ツールへのパスの指定」をご覧ください。For more information, see Specifying the Path to Command Line Tools.

ASP.NET アプリケーションのプロファイリングProfiling an ASP.NET Application

ASP.NETASP.NET Web アプリケーションをプロファイルするには、次の各セクションで説明するコマンドの 1 つを入力します。To profile an ASP.NETASP.NET Web application, type one of the commands described in the following sections. Web サイトが起動し、プロファイラーがデータ収集を開始します。The Web site is started and the profiler starts to collect data. アプリケーションを実行した後、ブラウザーを閉じます。Exercise your application and then close the browser. プロファイリングを停止するには、コマンド プロンプト ウィンドウで Enter キーを押します。To stop profiling, press the Enter key in the command prompt window.

注意

既定では、vsperfaspnetcmd コマンドの後にコマンド プロンプトは戻りません。By default, the command prompt does not return after a vsperfaspnetcmd command. /nowait オプションを使用すると、コマンド プロンプトを強制的に戻すことができます。You can use the /nowait option to force the command prompt to return. /NoWait オプションの使用」をご覧ください。See Using the /NoWait option.

サンプリング メソッドを使用してアプリケーションの統計情報を収集するにはTo collect application statistics by using the sampling method

サンプリングは VSPerfASPNETCmd ツールの既定のプロファイル方法であるため、コマンド ラインで指定する必要はありません。Sampling is the default profiling method of VSPerfASPNETCmd tool and does not have to be specified on the command line. 次のコマンド ラインは、指定した Web アプリケーションからアプリケーションの統計情報を収集します。The following command line collects application statistics from the specified Web application:

vsperfaspnetcmd websiteUrlvsperfaspnetcmd websiteUrl

インストルメンテーション メソッドを使用して詳細なタイミング データを収集するにはTo collect detailed timing data by using the instrumentation method

次のコマンド ラインを使用して、動的にコンパイルされた ASP.NETASP.NET Web アプリケーションから詳細なタイミング データを収集します。Use the following command line to collect detailed timing data from a dynamically compiled ASP.NETASP.NET Web application:

vsperfaspnetcmd /trace websiteUrlvsperfaspnetcmd /trace websiteUrl

Web アプリケーション内の静的にコンパイルされた .dll ファイルをプロファイリングする場合は、VSInstr コマンド ライン ツールを使用してファイルをインストルメント化する必要があります。If you want to profile statically compiled .dll files in your Web application, you must instrument the files by using the VSInstr command-line tool. vsperfaspnetcmd /trace コマンドを実行すると、インストルメント化されたファイルのデータが収集されます。The vsperfaspnetcmd /trace command will include data from the instrumented files.

.NET メモリ データを収集するにはTo collect .NET memory data

/Memory オプションを使用すると、.NET メモリ内のオブジェクトの割り当てに関するデータが収集されるため、これらのオブジェクトの有効期間に関するデータを収集できます。The /Memory option collects data about the allocation of objects in .NET memory and can collect data about the lifetime of those objects. 割り当てデータの収集は /Memory データ オプションの既定のモードであるため、コマンド ラインで指定する必要はありません。Allocation data collection is the default mode of the /Memory data option and does not have to be specified on the command line.

vsperfaspnetcmd /memory websiteUrlvsperfaspnetcmd /memory websiteUrl

Lifetime パラメーターを使用して、割り当てデータに加え、オブジェクトの有効期間データを収集します。Use the Lifetime parameter to collect object lifetime data in addition to the allocation data:

vsperfaspnetcmd /memory:lifetime websiteUrlvsperfaspnetcmd /memory:lifetime websiteUrl

また、/Trace オプションを使用して .NET メモリ データと共に詳細なタイミング情報を収集することもできます。You can also use the /Trace option to include detailed timing information with the .NET memory data:

vsperfaspnetcmd /memory[:lifetime] /tracewebsiteUrlvsperfaspnetcmd /memory[:lifetime] /tracewebsiteUrl

階層相互作用データを収集するにはTo collect tier interaction data

警告

階層相互作用プロファイリング (TIP) のデータは、Visual Studio UltimateVisual Studio UltimateVisual Studio PremiumVisual Studio Premium、または Visual Studio ProfessionalVisual Studio Professional を使用して収集できます。Tier interaction profiling (TIP) data can be collected using Visual Studio UltimateVisual Studio Ultimate, Visual Studio PremiumVisual Studio Premium, or Visual Studio ProfessionalVisual Studio Professional. ただし、階層相互作用プロファイル データを表示できるのは、 Visual Studio UltimateVisual Studio Ultimate および Visual Studio PremiumVisual Studio Premiumのみです。However, tier interaction profiling data can be viewed only in Visual Studio UltimateVisual Studio Ultimate and Visual Studio PremiumVisual Studio Premium.

Windows 8 や Windows Server 2012 の TIP データを収集するには、インストルメンテーション (/trace) オプションを使用する必要があります。To collect TIP data on Windows 8 or Windows Server 2012, you must use the instrumentation (/trace) option.

サンプリング データと共に階層相互作用データを収集するには、コマンド ラインに次のように入力します。To collect tier interaction data with sampling data:

vsperfaspnetcmd /tip websiteUrlvsperfaspnetcmd /tip websiteUrl

インストルメンテーション データと共に階層相互作用データを収集するには、コマンド ラインに次のように入力します。To collect tier interaction data with instrumentation data:

vsperfaspnetcmd /trace /tip websiteUrlvsperfaspnetcmd /trace /tip websiteUrl

.NET メモリ データと共に階層相互作用データを収集するには、コマンド ラインに次のように入力します。To collect tier interaction data with .NET memory data:

vsperfaspnetcmd /memory[:lifetime] /tipwebsiteUrlvsperfaspnetcmd /memory[:lifetime] /tipwebsiteUrl

/NoWait オプションの使用Using the /NoWait option

既定では、vsperfaspnetcmd コマンドの後にコマンド プロンプトは戻りません。By default, the command prompt does not return after a vsperfaspnetcmd command. 次の構文オプションを使用すると、コマンド プロンプトを強制的に戻すことができます。You can use the following syntax option to force the command prompt to return. その後、コマンド プロンプト ウィンドウで他の操作を実行できます。You can then perform other operations in the command prompt window. プロファイリングを終了するには、別の vsperfaspnetcmd コマンドで /shutdown オプションを使用します。To end profiling, use the /shutdown option in a separate vsperfaspnetcmd command.

プロファイリングを開始するには、次のように入力します。To begin profiling:

vsperfaspnetcmd [/Options] /nowaitwebsiteUrlvsperfaspnetcmd [/Options] /nowaitwebsiteUrl

プロファイリングを終了するには、次のように入力します。To end profiling:

vsperfaspnetcmd /shutdown websiteUrlvsperfaspnetcmd /shutdown websiteUrl

その他のオプションAdditional Options

vsperfaspnetcmd /shutdown コマンドを除き、このセクションの前半で説明した各コマンドに次の任意のオプションを追加できます。You can add any of the following options to the commands listed earlier in this section, except the vsperfaspnetcmd /shutdown command.

オプションOption 説明Description
/Output: VspFile/Output: VspFile 既定では、プロファイル データ (.vsp) ファイルは PerformanceReport.vsp というファイル名で現在のディレクトリに作成されます。By default, the profiling data (.vsp) file is created in the current directory with the file name PerformanceReport.vsp. 別の場所、ファイル名、またはその両方を指定するには、/output オプションを使用します。Use the /output option to specify a different location, file name, or both.
/PackSymbols:Off/PackSymbols:Off 既定では、VsPerfASPNETCmd に .vsp ファイルのシンボル (関数名、パラメーター名など) が埋め込まれています。By default, VsPerfASPNETCmd embeds symbols (function and parameter names, etc) in the .vsp file. シンボルを埋め込むと、プロファイル データ ファイルが非常に大きくなる可能性があります。Embedding the symbols can make the profiling data file very large. データを分析するときにシンボルを含む .pdb ファイルにアクセスできる場合は、/packsymbols:off オプションを使用してシンボルの埋め込みを無効にしてください。If you will have access to the .pdb files that contain the symbols when you analyze the data, use the /packsymbols:off option to disable the embedding of the symbols.