コマンド ラインからの階層相互作用データの追加Adding tier interaction data from the command line

階層相互作用プロファイリングにより、1 つ以上のデータベースと通信する多階層アプリケーションの関数で同期 ADO.NETADO.NET の呼び出しの実行時間に関する追加情報が提供されます。Tier interaction profiling provides additional information about the execution times of synchronous ADO.NETADO.NET calls in functions of multi-tiered applications that communicate with one or more databases.

Windows 8 と Windows Server 2012Windows 8 and Windows Server 2012

Windows 8 デスクトップ アプリおよび Windows Server 2012 アプリで階層相互作用データを収集するには、インストルメンテーション メソッドを使用する必要があります。To collect tier interaction data on Windows 8 desktop apps and Windows Server 2012 apps you must use the instrumentation method. UWP アプリで階層相互作用データの収集はサポートされていません。Collecting tier interaction data on UWP apps is not supported.

Visual Studio のエディションVisual Studio editions

階層相互作用プロファイル データは、Visual Studio UltimateVisual Studio UltimateVisual Studio PremiumVisual Studio Premium、または Visual Studio ProfessionalVisual Studio Professional を使用して収集できます。Tier interaction profiling 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.

リモート コンピューターでの TIP データの収集Collecting TIP data on a remote machine

リモート コンピューターで階層相互作用データを収集するには、Visual Studio コンピューターの %VSInstallDir%\Team Tools\Performance Tools\Setups フォルダーから vs_profiler_<Platform>_<Language>.exe ファイルをリモート コンピューターにコピーしてインストールする必要があります。To collect tier interaction data on a remote machine, you must copy the vs_profiler_<Platform>_<Language>.exe file from the %VSInstallDir%\Team Tools\Performance Tools\Setups folder of a Visual Studio machine to the remote computer and install it. リモート デバッグのダウンロード パッケージにあるプロファイリング ツールを使用することはできません。You cannot use the profiling tools in the Remote Debugging download package.

TIP レポートTIP reports

階層相互作用データは、Visual Studio UltimateVisual Studio Ultimate IDE でのみ表示できます。Tier interaction data can only be viewed in the Visual Studio UltimateVisual Studio Ultimate IDE. VSPerfReport の使用による、ファイル ベースの階層相互作用レポートは利用できません。File based tier interaction reports through VSPerfReport are not available.

VSPerfCmd に階層相互作用データを追加するAdding tier interaction data with VSPerfCmd

VSPerfASPNETCmd コマンド ライン ツールを使用すると、プロファイリング ツールで使用できるすべての機能にアクセスできます。The VSPerfASPNETCmd command line tool lets you access the complete functionality available in the Profiling Tools. VSPerfCmd を使用して収集されたプロファイリング データに階層相互作用を追加するには、VSPerfCLREnv ユーティリティを使用して階層相互作用データを有効にする環境変数を設定して削除する必要があります。To add tier interaction to profiling data collected by using VSPerfCmd, you must use the VSPerfCLREnv utility to set and remove the environment variables that enables tier interaction data. 指定するオプションとデータを収集するために必要な手順は、プロファイリングするアプリケーションの種類によって異なります。The options that you specify and the procedures required to collect data depend on the type of application that you are profiling.

スタンドアロン アプリケーションのプロファイリングProfiling stand-alone applications

別のプロセス (SQLServer に対して同期 ADO.NETADO.NET 呼び出しを行う Windows デスクトップ アプリケーションなど) によって実行されないアプリケーションに階層相互作用データを追加するには、VSPerfClrEnv /InteractionOn オプションを使用して環境変数を設定し、VSPerfClrEnv /InteractionOff オプションを使用してそれらを削除します。To add tier interaction data to an application that is not run by another process, such as a Windows desktop application that makes synchronous ADO.NETADO.NET calls to a SQLServer database, use the VSPerfClrEnv /InteractionOn option to set the environment variables, and the VSPerfClrEnv /InteractionOff option to remove them.

次の例では、Windows デスクトップ アプリケーションはインストルメンテーション メソッドを使用してプロファイルされ、階層相互作用データが収集されます。In the following example, a Windows desktop application is profiled by using the instrumentation method and tier interaction data is collected.

Windows デスクトップ アプリケーションのプロファイルの例Profiling a Windows desktop application example
  1. 管理者特権を使用して、コマンド プロンプト ウィンドウを開きます。Open a command prompt window with Administrator privileges. [スタート] ボタンをクリックし、[すべてのプログラム][アクセサリ] の順にポイントします。Click Start, point to All Programs, and then point to Accessories. [コマンド プロンプト] を右クリックしてから、[管理者として実行] をクリックします。Right-click Command Prompt, and then click Run As Administrator.

  2. .NET プロファイル環境変数と TIP を環境変数初期化します。Initialize .NET profiling and the TIP environment variables. 次のコマンドを入力します。Type the following commands:

    vsperfclrenv /traceon  
    vsperfclrenv /interactionon  
    
  3. プロファイラーを起動します。Start the profiler. 次のコマンドを入力します。Type the following command:

    vsperfcmd /start:trace /output:Desktop_tip.vsp   
    
  4. VSPerfCmd でアプリケーションを起動します。Start the application with VSPerfCmd. 次のコマンドを入力します。Type the following command:

    vsperfcmd /launch:DesktopApp.exe  
    
  5. プロファイリング データを収集するアプリケーションを実行し、通常の方法でアプリケーションを終了します。Exercise the application to collect profiling data, and then close the application in the regular way.

  6. TIP 環境変数を削除します。Clear the TIP environment variables. 次のコマンドを入力します。Type the following command:

    vsperfclrenv /off  
    

    詳細については、「スタンドアロン アプリケーションのコマンド ラインによるプロファイリング」を参照してください。For more information, see Profiling Stand-Alone Applications.

サービスのプロファイリングProfiling services

ASP.NETASP.NET アプリケーションなどのサービスをプロファイルするには、VSPerfClrEnv /GlobalInteractionOn オプションを使用して環境変数を設定し、VSPerfClrEnv/GlobalInteractionOff オプションを使用してそれらを削除します。To profile services, including ASP.NETASP.NET applications, use the VSPerfClrEnv /GlobalInteractionOn option to set the environment variables, and the VSPerfClrEnv /GlobalInteractionOff option to remove them.

ASP.NETASP.NET Web アプリケーションなどのサービスをプロファイルする際には、多くの場合、プロファイリングを有効にするためにコンピューターの再起動が必要になります。When you are profiling services, including ASP.NETASP.NET Web applications, you will often need to restart the computer to enable profiling.

次の例では、Windows サービスはインストルメンテーション メソッドを使用してプロファイルされ、階層相互作用データが収集されます。In the following example, a Windows service is profiled by using the instrumenation method and tier interaction data is collected.

Windows サービスのプロファイリングの例Profiling a Windows service example
  1. インストールの必要なサービスがあればインストールします。If necessary, install the service.

  2. 管理者特権を使用して、コマンド プロンプト ウィンドウを開きます。Open a command prompt window with Administrator privileges. [スタート] ボタンをクリックし、[すべてのプログラム][アクセサリ] の順にポイントします。Click Start, point to All Programs, and then point to Accessories. [コマンド プロンプト] を右クリックしてから、[管理者として実行] をクリックします。Right-click Command Prompt, and then click Run As Administrator.

  3. .NET プロファイル環境変数を初期化します。Initialize the .NET profiling environment variables. 次のコマンドを入力します。Type the following command:

    vsperfclrenv /globaltraceon  
    
  4. TIP 環境変数を初期化します。Initialize the TIP environment variables. 次のコマンドを入力します。Type the following command

    vsperfclrenv /globalinteractionon  
    
  5. コンピューターを再起動して環境変数を登録します。Restart the computer to register the environment variables.

  6. 管理者特権を使用して、コマンド プロンプト ウィンドウを開きます。Open a command prompt window with Administrator privileges.

  7. プロファイラーを起動します。Start the profiler. 次のコマンドを入力します。Type the following command:

    vsperfcmd /start:trace /output:MiddleTier_tip.vsp /user:SYSTEM /crosssession   
    
  8. 起動の必要なサービスがあれば起動します。If necessary, start the service.

  9. プロファイラーをサービスにアタッチします。Attach the profiler to the service. 次のコマンドを入力します。Type the following command:

    vsperfcmd /attach:MiddleTier.exe /output:MyService_tip.vsp /user:SYSTEM /crosssession   
    
  10. サービスを実行し、プロファイル データを収集します。Exercise the service and collect profiling data.

  11. プロファイラーを停止します。Stop the profiler. 次のコマンドを入力します。Type the following command:

    vsperfcmd /detach

  12. .NET および TIP プロファイル環境変数を削除します。Clear the .NET and TIP profiling environment variables. 次のコマンドを入力します。Type the following command:

    vsperfclrenv /globaloff  
    
  13. コンピューターを再起動して、削除された環境変数を登録します。Restart the computer to register the cleared environment variables.

    詳細については、次のトピックを参照してください。For more information, see one of the following topics:

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

    プロファイリング (サービスの)Profiling Services

VSPerfASPNETCmd に階層相互作用データを追加するAdding tier interaction data with VSPerfASPNETCmd

VSPerfASPNETCmd コマンド ライン ツールを使用すると、ASP.NETASP.NET Web アプリケーションを簡単にプロファイルできます。The VSPerfASPNETCmd command-line tool enables you to easily profile ASP.NETASP.NET Web applications. VSPerfCmd コマンド ライン ツールと比較すると、オプションが減り、環境変数を設定する必要がなく、コンピューターを再起動する必要がありません。Compared with the VSPerfCmd command-line tool, options are reduced, no environment variables have to be set, and rebooting the computer is not required. VSPerfASPNETCmd のこれらの機能により、階層相互作用データの収集が非常に簡単になります。These features of VSPerfASPNETCmd make the collection of tier interaction data exceptionally easy.

VSPerfASPNETCmd を使用して収集されたデータのプロファイリングに階層相互作用を追加するには、/TIP オプションをコマンド ラインに追加します。To add tier interaction to profiling data collected by using VSPerfASPNETCmd, add the /TIP option to the command line. たとえば、インストルメンテーション メソッドを使用して ASP.NETASP.NET Web アプリケーション用に階層相互作用データを収集するには、次のコマンド ラインを使用します。For example, use the following command line to collect tier interaction data for an ASP.NETASP.NET Web application by using the instrumentation method:

vsperfaspnetcmd /tip /trace http://localhost/MyWebApp  

VSPerfASPNETCmd の詳細については、「VSPerfASPNETCmd を使用した迅速な Web サイト プロファイリング」を参照してください。For more information about VSPerfASPNETCmd, see Rapid Web Site Profiling with VSPerfASPNETCmd.