方法: 困難な問題をデバッグするのに役立つ IntelliTrace データを収集する

[アーティクル]
08/09/2011

Microsoft テストマネージャーまたは Microsoft Visual Studio 2010 を使用すると、特定の診断トレース情報を収集するように IntelliTrace 用の診断データアダプターを構成できます。このアダプターをテストで使用すると、アプリケーションに関する重要な診断イベントを収集できます。この情報は、開発者がコードをトレースしてバグの原因を見つける際に役立ちます。 IntelliTrace の診断データアダプターは、手動テストでも自動テストでも使用できます。

注意

IntelliTrace はマネージコードで作成されたアプリケーションでのみ機能します。ブラウザーをクライアントとして使用する Web アプリケーションをテストしている場合は、トレースするマネージコードがないので、テストの設定でクライアントに対して IntelliTrace を有効にしないでください。この場合は、環境を設定し、Web サーバーで IntelliTrace データをリモートで収集できます。環境の詳細については、「テストコンピューターでのテストの実行またはデータの収集の設定」を参照してください。

IntelliTrace データは、拡張子が .iTrace のファイルに保存されます。テストを実行し、テストステップが失敗した場合は、バグを作成できます。診断情報が格納された IntelliTrace ファイルは、このバグに自動的にアタッチされます。

注意

テストが成功した場合、IntelliTrace の診断データアダプターで IntelliTrace ファイルは作成されません。テストケースが失敗した場合、またはバグを送信した場合にのみファイルが保存されます。

IntelliTrace ファイルに収集されたデータによって、コードのエラーを再現して診断するために必要な時間が短縮され、この結果、デバッグの生産性が向上します。また、ローカルセッションを自分のコンピューターで複製できる他のユーザーと IntelliTrace ファイルを共有できるので、バグが再現不可能となる可能性が低くなります。

ヒント

テストの設定で IntelliTrace を有効にすると、コードカバレッジデータの収集は実行されません。詳細については「方法: 自動テストのテスト設定を使用してコードカバレッジを構成する」を参照してください。

ヒント

IntelliTrace の診断データアダプターは、マネージプロセスをインストルメント化することで機能しますが、これは、実行するテストが読み込まれた後に行われる必要があります。監視するプロセスが既に開始されている場合、プロセスは既に実行中であるため、IntelliTrace ファイルは収集されません。これを回避するため、テストを読み込む前に必ずプロセスを停止してください。テストが読み込まれた後、または最初のテストが開始された後でプロセスを開始します。

次の手順では、収集する IntelliTrace データを構成する方法を説明します。これらの手順は Microsoft テストマネージャーの構成エディターと Microsoft Visual Studio 2010 の [テストの設定] ダイアログボックスの両方に当てはまります。

注意

IntelliTrace データの収集に使用されるテストエージェントのユーザーアカウントは、Administrators グループのメンバーである必要があります。詳細については、「Visual Studio Agents、テストコントローラー、およびビルドコントローラーのインストールと構成」を参照してください。

IntelliTrace 診断データアダプターで収集するデータの構成

この手順を実行する前に、Microsoft テストマネージャーまたは Microsoft Visual Studio 2010 のいずれかからテストの設定を開き、[データと診断] ページを選択する必要があります。

IntelliTrace 診断データアダプターで収集するデータを構成するには

IntelliTrace データの収集に使用するロールを選択します。
[IntelliTrace] を選択します。
Web クライアントロールに IntelliTrace を追加している場合は、[IntelliTrace およびテストの影響用の ASP.NET クライアントプロキシ] を選択する必要もあります。

このプロキシを使用すると、IntelliTrace 診断データアダプターとテスト影響診断データアダプターでクライアントから Web サーバーへの http 呼び出しに関する情報を収集できます。

ヒント

Intellitrace データを収集する Internet Information Server (IIS) のアプリケーションプールで使用されている ID のカスタムアカウントを使用する場合、IIS コンピューター上で使用するカスタムアカウントのローカルユーザープロファイルを作成する必要があります。カスタムアカウントのローカルプロファイルを作成するには、IIS コンピューターに一度ローカルでログインするか、カスタムアカウントの資格情報を使用して以下のコマンドラインを実行します。

runas /user:domain\name /profile cmd.exe
[IntelliTrace] の [構成] をクリックし、既定の IntelliTrace 設定を変更します。

収集されるデータを構成するダイアログボックスが表示されます。

ヒント

IntelliTrace データの収集を有効にすると、コードカバレッジデータの収集は実行されません。
[全般] タブをクリックします。重要な診断イベントを記録する場合に [IntelliTrace イベントのみ] を選択すると、テスト時のパフォーマンスへの影響を最小限に抑えられます。

または

診断イベントと、呼び出し情報を示すメソッドレベルのトレースを記録する場合は、[IntelliTrace イベントと呼び出し情報] を選択します。このレベルのトレースは、テストの実行時のパフォーマンスに影響を与えます。
インターネットインフォメーションサービスで実行されている ASP.NET アプリケーションからデータを収集する場合は、[インターネットインフォメーションサービスで実行されている ASP.NET アプリケーションからデータを収集する] を選択します。
[モジュール] タブをクリックします。 [次を除くすべてのモジュールからデータを収集] を選択し、[追加] をクリックしてモジュールのリストに追加するか、[削除] をクリックしてモジュールを削除します。このオプションを選択すると、指定したモジュールを除く、システムで実行されているすべてのモジュールがデータ収集の対象となります。

または

[次のモジュールからのみデータを収集] を選択し、[追加] をクリックしてモジュールのリストに追加するか、[削除] をクリックしてモジュールを削除します。このオプションを選択すると、必要なモジュールを正確に指定できます。

注意

可能な場合、監視対象として特定のプロセスを選択します。パフォーマンスを最適化するためには、この方法をお勧めします。
[プロセス] タブをクリックします。 [次を除くすべてのプロセスからデータを収集] を選択し、[追加] をクリックしてプロセスのリストに追加するか、[削除] をクリックしてプロセスを削除します。このオプションを選択すると、指定したプロセスを除く、システムで実行されているすべてのプロセスがデータ収集の対象となります。

または

[指定されたプロセスからのみデータを収集] を選択し、[追加] をクリックしてプロセスのリストに追加するか、[削除] をクリックしてプロセスを削除します。このオプションを選択すると、必要なプロセスを正確に指定できます。
(省略可能) [IntelliTrace イベント] タブをクリックします。診断イベントを収集するときに含める各 IntelliTrace イベントカテゴリを選択するか、除外する各 IntelliTrace イベントカテゴリをクリアします。
(省略可能) 各 IntelliTrace イベントカテゴリを展開し、IntelliTrace イベントに含めるか、IntelliTrace イベントから除外する特定のイベントをそれぞれ選択またはクリアします。

注意

詳細については、「IntelliTrace 情報の収集」を参照してください。
(省略可能) [詳細設定] タブをクリックします。次に、[各記録用の最大ディスク領域] の横にある矢印をクリックし、使用する IntelliTrace ファイルで許可する最大サイズを選択します。

注意

記録のサイズを大きくすると、記録をテスト結果と共に保存するときタイムアウトが発生する可能性があります。診断データアダプターのタイムアウト値を大きくする方法の詳細については、「方法: 診断データアダプターがタイムアウトしないようにする」を参照してください。
Microsoft テストマネージャーを使用している場合は、[保存] をクリックします。Visual Studio を使用している場合は、[OK] をクリックします。これで、テストの設定を対象として IntelliTrace の設定が構成および保存されました。

注意

この診断データアダプターの構成をリセットするには、Visual Studio では [既定の構成にリセット] を、Microsoft テストマネージャーでは [既定値にリセット] をクリックします。