dotTrace 2024.3 ヘルプ

プロファイル単体テスト

ユニットテストのプロファイリングには 3 つの方法があります。

Visual Studio で統合された dotTrace を使用して単体テストをプロファイルする

  1. Visual Studio でソリューションを開きます。

  2. ユニットテストでファイルを開きます。

  3. テストクラスまたはテストメソッドを選択します。

  4. ガターの対応するサイドバーマークをクリックします。

  5. コンテキストメニューで、プロファイルを選択します。

    Profile tests in Visual Studio
  6. 単体テストセッションウィンドウが開きます。

  7. プロファイリングオプションを指定します。

  8. テストの実行が完了すると、スナップショットが dotTrace Viewer で開かれます。

ReSharper のユニットテストセッションウィンドウからユニットテストをプロファイリングするには

  1. 単体テストセッションウィンドウのツリービューでノードを選択します。

  2. ツールバーのリストからプロファイル単体テストを選択します。

    Profile Unit Tests toolbar
  3. プロファイリングオプションを指定します。

  4. テストの実行が完了すると、スナップショットが表示されます。

スタンドアロン dotTrace を使用して単体テストのプロファイルを作成するには

  1. スタンドアロンアプリケーションとして dotTrace を実行する。dotTrace ホームウィンドウが開きます。

  2. 実行構成を追加します – プロファイルされたアプリケーションの実行方法を dotTrace に指示する構成です。

    1. プロファイルするものを選択してください新しいプロセスの実行で、Add run configuration 実行構成を追加するをクリックします。

    2. 新規実行構成ウィザードで、.NET Core アプリケーションを選択し、次へをクリックします。

    3. 使用するユニットテストフレームワークに応じて、パスフィールドにその実行可能ファイルへのパスを指定します。次のフレームワーク / 実行可能ファイルを操作できます。

      • NUnit 用の nunit.exe

      • NUnit 用の nunit-console.exe

      • MSTest 用の MSTest.exe

      • xUnit 用の xUnit-console.exe

      その他の構成例を見る

    4. 単体テストで .dll ファイルへのパスを指定し、必要に応じて引数を引数フィールドに追加します。

    5. 必要に応じて、アプリケーション作業ディレクトリへのフルパスを指定します(デフォルトでは、実行可能ファイルが配置されているのと同じディレクトリです)。

    6. 必要に応じて、環境変数を設定するを使用して環境変数を指定します。各変数は新しい行で指定する必要があります。

    7. 保存をクリックします。

  3. 作成した実行構成が新しいプロセスの実行リストで選択されていることを確認してください。

  4. プロファイルする方法を選択しますで、プロファイリングオプションを指定します。

    • プロファイリングタイプ : 通常、サンプリング (パフォーマンスを評価し、アプリで最も遅いメソッドを決定する) とタイムライン (サンプリングと同じですが、タイムラインデータが追加されます) のいずれかを選択する必要があります。プロファイリングタイプの詳細

    • オプションで、アプリケーションが多数のプロセスを作成し、特定のプロセスのみをプロファイリングする場合は、プロセスフィルターを作成します

      例: nunit-console.exe で実行されている NUnit テストのプロファイルを作成する必要がある場合、NUnit テストランナーはテストを実行するための別個のプロセスを作成することに注意してください。nunit-console.exe プロセスをプロファイリングから除外する必要があります。これを行うには、nunit-console* フィルターを追加します。

    • 必要に応じて、他のプロファイリングオプションを指定します。

  5. プロファイリングを実行するで、最初からプロファイリングデータを収集するを選択します。

  6. 開始をクリックします。これにより、プロファイリングセッションが開始されます。

  7. プロファイリングコントローラーウィンドウのスナップショットを取得するボタンを使用してスナップショットを収集します。プロファイリングセッションを制御する方法の詳細

  8. コントローラーウィンドウの切り離すボタンを使用して、プロファイラーをデタッチします。

  9. dotTrace Viewer を使用して、収集したスナップショットを分析します。

構成例

テストランナー

アプリケーション

引数

nUnit 用の nunit.exe

テストランナー実行可能ファイルへのパス。

サンプル: "C:\Program Files (x86)\NUnit 2.5.3\bin\net-2.0\nunit.exe"

単体テストを含む dll ファイルへのパス。

サンプル: "C:\Projects\ConsoleApplication1\ConsoleApplication1Test\bin\Debug\ConsoleApplication1Test.dll"

nUnit 用の nunit-console.exe

テストランナー実行可能ファイルへのパス。

サンプル: "C:\Program Files (x86)\NUnit 2.5.3\bin\net-2.0\nunit-console.exe"

単体テストを含む dll ファイルへのパスと、テスト結果が保存されている xml ファイルの名前。

サンプル: "C:\Test progs\ConsoleApplication1nUnit\ConsoleApplication1nUnitTest.dll" /xml:C:\Temp\1.xml

MSTest の MSTest.exe

テストランナー実行可能ファイルへのパス。

サンプル: "C:\Program Files (x86)\Microsoft Visual Studio 9.0\Common7\IDE\MSTest.exe"

引数:

  • /noisolation - MSTest.exe プロセス内で実行するテスト。

  • /testcontainer- 実行するテストを含むファイルをロードします。

例:

/noisolation /testcontainer:"C:\Projects\ConsoleApplication1\ConsoleApplication1Test\bin\Debug\ConsoleApplication1Test.dll"

xUnit 用の xUnit-console.exe

テストランナー実行可能ファイルへのパス。

サンプル: "C:\Program Files (x86)\xunit-1.5\xunit.console.exe"

単体テストを含む dll ファイルへのパスと、テスト結果が保存されている xml ファイルの名前。

サンプル: "C:\Projects\ConsoleApplication1\ConsoleApplication1xUnit\bin\Debug\ConsoleApplication1xUnit.dll" /xml 1.xml

結果のスナップショットには、プロファイリングしている単体テストだけでなく、テストフレームワーク自体に関連する多くの情報が含まれているため、単体テストに関する情報を抽出するのは困難な作業になります。スナップショットに単体テストコードがまったく見つからない場合は、テストが実際に実行されていることを確認してください。場合によっては、権限不足のため、テストを実行する前に MSTest が停止することがあります。その場合は、管理者として dotTrace を実行してみてください。