デバッグ情報収集のための IntelliTrace の構成

[アーティクル]
06/10/2015

IntelliTrace のコレクションの設定の変更時に Visual Studio Ultimate で IntelliTrace を使用してデバッグしている間に表示される情報量を制御できます。これらの設定は、すべてのプロジェクトとソリューションに適用され、デバッグセッションや Visual Studio セッションが変わっても維持されます。

イベントコレクションの構成
関数呼び出しコレクションの構成
モジュールコレクションの構成

イベントコレクションの構成

IntelliTrace が常に収集するデバッガーイベントと例外を除き、特定の IntelliTrace イベントの収集をオンまたはオフにできます。 IntelliTrace イベントは、デバッガーイベント、例外、.NET Framework イベント、およびデバッグに役立つその他のシステムイベントです。「IntelliTrace を使用したコード実行の記録によるアプリのデバッグ」を参照してください。

Visual Studio Ultimate で、IntelliTrace がオンになっていることを確認します。

注意

[IntelliTrace を有効にする] をオフにすると、すべてのカスタム設定がオフになります。
収集するイベントとイベントカテゴリを選択します。
必要に応じて、デバッグセッションを再開します。 IntelliTrace でのデバッグ開始の詳細については、「IntelliTrace によるデバック中のコード実行の記録」を参照してください。

IntelliTrace が IntelliTrace イベントについて収集するデータとは

デバッガーのイベント

パフォーマンスを向上するため、IntelliTrace はデバッガーイベントのすべての値を記録しません。代わりに、次の値を記録します。
- [ローカル] ウィンドウの値。これらの値を確認するために [ローカル] ウィンドウを開いたままにします。
- [自動変数] ウィンドウが開いているときにのみ [自動変数] ウィンドウの値
- 値を表示するためにソースウィンドウの変数の上にマウスポインターを移動すると表示されるデータヒントの値。 IntelliTrace は、固定されたデータヒントの値は収集しません。
例外

IntelliTrace は、次のような種類の例外の種類とメッセージを記録します。
- 例外がスローおよびキャッチされた場合の処理済みの例外
- ハンドルされない例外
.NET Framework イベント

既定では、IntelliTrace は最も一般的な .NET Framework のイベントを記録します。次のように記述します。
- ファイルアクセスイベントの場合、IntelliTrace はファイル名を収集します。
- チェックボックスの確認イベントの場合、IntelliTrace はチェックボックスの状態とテキストを収集します。

関数呼び出しコレクションの構成

呼び出しのコレクションがオンになっている場合、従来のデバッグから IntelliTrace によるデバッグに切り替えて、コードをステップ実行したり、呼び出し履歴を確認したりできます。これを有効にするには、デバッグセッションを開始する前に呼び出しのコレクションをオンにします。「IntelliTrace を使用したコード実行の記録によるアプリのデバッグ」を参照してください。

Visual Studio Ultimate で、[IntelliTrace イベントと呼び出し情報] をオンまたはオフにします。
必要に応じて、デバッグセッションを再開します。 IntelliTrace でのデバッグ開始の詳細については、「IntelliTrace によるデバック中のコード実行の記録」を参照してください。

注意

呼び出しコレクションをオンにすると、アプリの速度が大幅に低下する可能性があります。さらに、ディスクに保存される IntelliTrace ログファイル (.iTrace ファイル) のサイズが増加する可能性があります。これらの影響を最小限に抑えるには、必要なモジュールのみから呼び出し情報を収集するようにします。.iTrace ファイルの最大サイズを変更するには、[ツール]、[オプション]、[IntelliTrace]、[詳細設定] の順に選択します。

IntelliTrace が関数呼び出しについて収集するデータとは

各関数呼び出しについて、IntelliTrace は次のデータを記録します。

関数名
関数のエントリポイントでパラメーターとして渡され、関数の終了ポイントで返されるプリミティブデータ型の値
読み取りまたは変更されたときの自動プロパティの値
null かどうかの場合以外の値を除く、1 番目のレベルの子オブジェクトへのポインター

注意

IntelliTrace は、配列の最初の 256 個のオブジェクトと文字列の最初の 256 文字のみを収集します。

モジュールコレクションの構成

IntelliTrace で収集される呼び出し情報の量を制御するには、目的のモジュールのみを指定します。これにより、収集時のアプリのパフォーマンスを向上させることができます。 IntelliTrace が呼び出し情報を収集していることを確認するには、[ツール]、[オプション]、[IntelliTrace]、[全般] の順に選択します。

ヒント

モジュールを除外することもできますが、モジュールを除外しても、サードパーティのモジュールやオープンソースのモジュールなど、必要のない可能性があるモジュールからのデータが収集されることがあります。

Visual Studio Ultimate で、コレクションに含めるモジュール、またはコレクションから除外するモジュールを指定します。

複数のモジュールを追加するには、ワイルドカード文字 * を文字列の先頭または末尾に使用します。モジュール名には、アセンブリ名ではなくファイル名を使用してください。ファイルパスは使用できません。
IntelliTrace でのデバッグ開始の詳細については、「IntelliTrace によるデバック中のコード実行の記録」を参照してください。