チュートリアル: サンプリングを使ったコマンド ライン プロファイリングWalkthrough: Command-Line Profiling Using Sampling

このチュートリアルでは、コマンド ライン ツールを使用したアプリケーションのプロファイリング方法と、パフォーマンス上の問題をサンプリングによって特定する方法について説明します。This walkthrough demonstrates how to profile an application by using command-line tools and sampling to identify performance problems.

このチュートリアルでは、コマンド ライン ツールを使用してマネージ アプリケーションのプロファイリングを行う方法と、サンプリングを使用してアプリケーションのパフォーマンス上の問題を特定および識別する方法の各手順を説明します。In this walkthrough, you will step through the process of profiling a managed application by using command-line tools, and use sampling to isolate and identify performance problems in the application.

このチュートリアルでは、次の手順を行います。In this walkthrough, you will follow these steps:

  • コマンド ライン ツールとサンプリングを使用してアプリケーションのプロファイリングを行います。Profile an application by using command line tools and sampling.

  • サンプリングしたプロファイリング結果を分析して、パフォーマンス上の問題を特定および修正します。Analyze sampled profiling results to locate and fix performance issues.

必須コンポーネントPrerequisites

  • Visual Studio PremiumVisual Studio PremiumVisual Studio UltimateVisual Studio Ultimate、または Visual Studio ProfessionalVisual Studio Professional, Visual Studio UltimateVisual Studio Ultimate, or Visual Studio ProfessionalVisual Studio Professional

  • Visual C#Visual C# についての中級レベルの知識Intermediate understanding of Visual C#Visual C#

  • コマンド ライン ツールの操作についての中級レベルの知識Intermediate understanding of working with command line tools

  • PeopleTrax サンプルのコピーA copy of the PeopleTrax Sample

  • プロファイリングによって得られた情報を操作するには、デバッグ シンボル情報を使用できるようにしておくことをお勧めします。To work with the information provided by profiling, it is best to have debugging symbol information available.

サンプリング メソッドを使用したコマンド ライン プロファイリングCommand Line Profiling Using the Sampling Method

サンプリングとは 1 つのプロファイリング方式で、対象のプロセスを定期的にポーリングしてアクティブな関数を識別します。Sampling is a profiling method by which a specific process is periodically polled to determine the active function. 結果のデータからは、プロセスがサンプリングされたときに対象の関数が呼び出し履歴の一番上に配置されていた回数がわかります。The resulting data provides a count of how frequently the function was on top of the call stack when the process was sampled.

注意

プロファイリング ツールのコマンド ライン ツールは、Visual Studio インストール ディレクトリの \Team Tools\Performance Tools サブディレクトリにあります。Command-line tools of the Profiling Tools are located in the \Team Tools\Performance Tools subdirectory of the Visual Studio installation directory. 64 ビット コンピューター上では、64 ビット バージョンのツールと 32 ビット バージョンのツールの両方を使用できます。On 64 bit computers, both 64 bit and 32 bit versions of the tools are available. プロファイラー コマンド ライン ツールを使用するには、コマンド プロンプト ウィンドウの PATH 環境変数にそのパスを追加するか、コマンド自体にこのパスを追加します。To use the profiler command-line tools, you must add the 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. PeopleTrax は 32 ビット アプリケーションです。PeopleTrax is a 32-bit application.

サンプリング メソッドを使用して PeopleTrax アプリケーションのプロファイリングを行うにはTo profile the PeopleTrax application by using the sampling method

  1. PeopleTrax サンプル アプリケーションをインストールして、リリース バージョンをビルドします。Install the PeopleTrax sample application and build the release version of the application.

  2. コマンド プロンプト ウィンドウを開いて、ローカル パス環境変数にプロファイリング ツール ディレクトリを追加します。Open a command prompt window and add the Profiling Tools directory to the local Path environment variable.

  3. 作業ディレクトリを PeopleTrax バイナリを含むディレクトリに変更します。Change the working directory to the directory that contain the PeopleTrax binaries.

  4. 次のコマンドを入力し、適切な環境変数を設定します。Type the following command to set the appropriate environment variables:

    VSPerfCLREnv /sampleon  
    
  5. VSPerfCmd.exe (プロファイラーを制御するコマンド ライン ツール) を実行してプロファイリングを開始します。Start profiling by running VSPerfCmd.exe, which is the command-line tool that controls the profiler. 次のコマンドにより、アプリケーションとプロファイラーがサンプリング モードで起動します。The following command starts the application and profiler in the sampling mode:

    VsPerfCmd /start:sample /output:PeopleTraxReport.vsp /launch:PeopleTrax.exe  
    

    プロファイラーのプロセスが開始され、PeopleTrax.exe のプロセスにアタッチされます。The profiler process starts and attaches to the PeopleTrax.exe process. プロファイラーのプロセスにより、収集したプロファイリング データのレポート ファイルへの出力が開始されます。The profiler process starts to write the collected profiling data to the report file.

  6. [Get People] をクリックします。Click Get People.

  7. [ExportData] をクリックします。Click ExportData.

    メモ帳が開かれ、PeopleTrax からエクスポートされたデータを含む新しいファイルが表示されます。Notepad opens and displays a new file that contains the exported data from PeopleTrax.

  8. メモ帳を閉じてから、PeopleTrax アプリケーションを閉じます。Close Notepad, and then close the PeopleTrax application.

  9. プロファイラーをシャットダウンします。Shut down the profiler. 次のコマンドを入力します。Type the following command:

    VSPerfCmd /shutdown  
    
  10. 次のコマンドを使用し、環境変数をリセットします。Use the following command to reset the environmental variables:

    VSPerfCLREnv /sampleoff  
    
  11. プロファイリング データは .vsp ファイルに格納されます。次のいずれかの方法により結果を分析します。Profiling data is stored in the.vsp file Analyze the results by using one of the following methods:

    • Visual Studio IDE で .vsp ファイルを開きます。Open the.vsp file in the Visual Studio IDE.

      — または —— or —

    • コマンド ライン ツール VSPerfReport.exe を使用してコンマ区切り値 (csv) ファイルを生成します。Generate a comma-separated value (.csv) file by using the command-line tool VSPerfReport.exe. Visual StudioVisual Studio IDE 以外で使用するレポートを生成するには、次のコマンドを使用します。To generate reports for use outside the Visual StudioVisual Studio IDE use the following command:

      VSPerfReport <dir> PeopleTraxReport.vsp /output:<dir> /summary:all  
      

関連項目See Also

パフォーマンス セッションの概要 Performance Session Overview
コマンドラインからのプロファイル Profiling from the Command-Line
VSPerfCmd VSPerfCmd
サンプリング データ値について Understanding Sampling Data Values
パフォーマンス レポートのビューPerformance Report Views