Visual Studio Enterprise の IntelliTrace (C#、Visual Basic、C++)
IntelliTrace を使用して実行履歴を記録およびトレースすると、アプリのデバッグにかかる時間を短縮できます。 IntelliTrace には以下の機能があるので、バグを簡単に見つけることができます。
特定のイベントを記録する
関連するコード、デバッガー イベント中に [ローカル] ウィンドウに表示されるデータ、および関数呼び出し情報を確認する
再現が困難な場合、または配置で発生する場合のエラーをデバッグする
IntelliTrace は Visual Studio Enterprise Edition で使用できます (Professional Edition または Community Edition の場合は使用できません)。
目的に合ったトピックをクリックしてください
| シナリオ | Title |
|---|---|
| IntelliTrace を使用してアプリケーションをデバッグする: - 過去のイベントを表示する。 - 過去のイベントの呼び出し情報を表示する。 - IntelliTrace セッションを保存する。 - IntelliTrace により収集されたデータを制御する。 |
- IntelliTrace を使用して以前のアプリの状態を調べる - チュートリアル: IntelliTrace の使用 - IntelliTrace の機能 - デバッグ履歴 |
| 展開されたアプリケーションから IntelliTrace データを収集する | - IntelliTrace スタンドアロン コレクターを使用する |
| IntelliTrace ログ ファイル (.iTrace ファイル) からデバッグを開始する | - 保存された IntelliTrace データの使用 |
IntelliTrace を使用してデバッグできるアプリは何ですか?
| サポート レベル | アプリケーションのタイプ |
|---|---|
| 完全サポート | - .NET Framework 2.0 以降のバージョンを使用する Visual Basic および Visual c# のアプリケーション。 ASP.NET、Microsoft Azure、Windows フォーム、WCF、WPF、Windows Workflow、SharePoint 2010、SharePoint 2013、および 64 ビットのアプリを含むほとんどのアプリケーションをデバッグできます。 IntelliTrace を使用して SharePoint アプリケーションをデバッグするには、「チュートリアル: IntelliTrace を使用した SharePoint アプリケーションのデバッグ」を参照してください。 IntelliTrace を使用して Microsoft Azure アプリをデバッグするには、「IntelliTrace および Visual Studio を使用した発行済みのクラウド サービスのデバッグ」を参照してください。 |
| 限定されたサポート | - Windows を対象とする C++ アプリは、IntelliTrace のステップバックを使用したスナップショットの表示をサポートしています。 デバッガーと例外イベントのみがサポートされています。 - ローカル デバッグで特定のイベント (MVC コントローラー、ADO.NET、および HTTPClient イベント) に対してのみサポートされる .NET Core および ASP.NET Core アプリ。 .NET Core または ASP.NET Core アプリではスタンドアロン コレクターはサポートされていません。 - 試用前提の F# アプリ - イベントに対してのみサポートされている UWP アプリ |
| サポートされていません | - その他の言語とスクリプト - Windows サービス、Silverlight、Xbox、または Windows Mobile アプリ |
Note
既に実行されているプロセスをデバッグする場合は、IntelliTrace イベントのみを収集できます (呼び出し情報は収集できません)。 ローカル コンピューター上の 32 ビットまたは 64 ビット プロセスにのみアタッチできます。 プロセスにアタッチする前に発生したイベントは収集されません。
なぜ IntelliTrace を使用してデバッグするのですか?
従来のデバッグまたは "ライブ" デバッグでは、ご利用のアプリケーションの現在の状態と過去のイベントの制限されたデータのみが表示されます。 アプリケーションの現在の状態に基づいてこれらのイベントを推測するか、またはアプリケーションを再実行することによってこれらのイベントを再作成する必要があります。
IntelliTrace は、これらの時点で特定のイベントやデータを記録することによってこの従来のデバッグを拡大します。 これにより、特にバグの箇所を通り越してステップ実行した場合に、再起動せずにこれらのアプリケーションで起こったことを確認できます。 IntelliTrace は従来のデバッグ中に既定で有効になっているため、自動的に非表示の状態でデータを収集します。 これにより、従来のデバッグと IntelliTrace デバッグを簡単に切り替えて、記録された情報を見ることができます。 「IntelliTrace の機能」と「IntelliTrace が収集するデータ」を参照してください
また、IntelliTrace は再現が困難なエラーや配置で発生するエラーのデバッグに役立ちます。 IntelliTrace データを収集し、IntelliTrace ログ ファイル (.iTrace ファイル) に保存できます。 .iTrace ファイルには、例外、パフォーマンス イベント、Web 要求、テスト データ、スレッド、モジュール、およびその他のシステム情報に関する詳細情報が含まれています。 Visual Studio Enterprise でこのファイルを開き、項目を選択し、IntelliTrace でデバッグを開始できます。 これにより、ファイル内の任意のイベントに移動して、その時点のアプリケーションに関する特定の詳細を表示できます。
次のソースからの IntelliTrace データを保存できます。
Visual Studio 2015 Enterprise 以降のバージョン、または Visual Studio Ultimate の前のバージョンの IntelliTrace セッション。
Microsoft Monitoring Agent を単独、または System Center 2012 と連携して使用する場合の、IIS でホストされている ASP.NET Web アプリ、または配置されて実行中の SharePoint アプリケーション。 詳細については、「IntelliTrace スタンドアロン コレクターを使用する」と「Microsoft Monitoring Agent による監視」を参照してください。
重要
Microsoft Monitoring Agent (MMA) と IntelliTrace の使用は、2024 年 8 月 31 日に Microsoft Monitoring Agent の有効期間が終了すると、サポートされなくなります。 詳しくは、「Log Analytics エージェントから Azure Monitor エージェントへの移行」を参照してください。
IntelliTrace を使用したデバッグがどのように役立つかの例を次に示します。
アプリケーションのデータ ファイルが破損していますが、このイベントの発生場所を特定できません。
IntelliTrace がなければ、コード全体を確認して可能性のあるファイルのアクセスをすべて見つけ、それらのアクセスにブレークポイントを設定してから、アプリケーションを再実行して、問題の発生箇所を探さなければなりません。 IntelliTrace を使用すると、各イベントが発生したときに収集されたアプリケーションに関するファイル アクセス イベントや特定の詳細をすべて表示できます。
例外が発生します。
IntelliTrace がない場合、例外に関するメッセージが表示されますが、例外の原因となったイベントに関する詳細な情報はわかりません。 呼び出し履歴を調べて、例外の原因となった一連の呼び出しを確認することはできますが、それらの呼び出し中に発生したイベントのシーケンスを確認することはできません。 IntelliTrace を使用すると、例外の前に発生したイベントを確認できます。
展開されたアプリケーションでバグまたはクラッシュが発生しています。
Microsoft Azure ベースのアプリケーションの場合、アプリケーションを発行する前に IntelliTrace データの収集を構成できます。 アプリケーションの実行中、IntelliTrace はデータを .iTrace ファイルに保存します。 IntelliTrace および Visual Studio を使用した発行済みのクラウド サービスのデバッグに関するページを参照してください。
IIS 7.0、7.5、および 8.0 でホストされる ASP.NET Web アプリ、および SharePoint 2010 アプリケーションや SharePoint 2013 アプリケーションの場合、Microsoft Monitoring Agent を単独で、または System Center 2012 と連携して使用して、IntelliTrace データを .iTrace ファイルに保存できます。
これは、配置されたアプリの問題を診断する場合に便利です。 「IntelliTrace スタンドアロン コレクターを使用する」を参照してください。
IntelliTrace ではどのようなデータが収集されますか?
イベント情報を収集する
既定では、IntelliTrace は、IntelliTrace イベント (デバッガー イベント、例外、.NET Framework イベント、およびデバッグに役立つその他のシステム イベント) のみを記録します。 常に収集されるデバッガー イベントと例外を除き、収集する IntelliTrace イベントの種類を選択できます。 「IntelliTrace の機能」を参照してください。
デバッガー イベント
IntelliTrace は、Visual Studio デバッガーに発生するイベントを常に記録します。 たとえば、アプリケーションの起動はデバッガー イベントです。 その他のデバッガー イベントは、アプリケーションの実行を中断する停止イベントです。 たとえば、ご利用のプログラムはブレークポイントをヒットしたり、トレースポイントをヒットしたり、[ステップ] コマンドを実行したりします。
既定では、パフォーマンスを向上するため、IntelliTrace ではデバッガー イベントのすべての値が記録されません。 代わりに、次の値を記録します。
[ローカル] ウィンドウの値。 これらの値を確認するために [ローカル] ウィンドウを開いたままにします。
[自動変数] ウィンドウが開いているときにのみ [自動変数] ウィンドウの値
値を表示するためにソース ウィンドウの変数の上にマウス ポインターを移動すると表示されるデータヒントの値。 IntelliTrace は、固定されたデータヒントの値は収集しません。
IntelliTrace イベントとスナップショット モードが有効な場合、IntelliTrace では、デバッガーの [ブレークポイント] イベントと [ステップ] イベントごとにアプリケーションのプロセスのスナップショットが取得されます。 これにより、ウィンドウが開いているかどうかに関係なく、[ローカル]、[自動]、および [ウォッチ] ウィンドウの値が記録されます。 ピン留めされたデータ ヒントの値も収集されます。
例外
IntelliTrace は、次のような種類の例外の種類とメッセージを記録します。
例外がスローおよびキャッチされた場合の処理済みの例外
ハンドルされない例外
.NET Framework イベント
既定では、IntelliTrace は最も一般的な .NET Framework のイベントを記録します。 たとえば、CheckBox.CheckedChanged イベントの場合、IntelliTrace ではチェックボックスの状態とテキストが収集されます。
SharePoint 2010 アプリケーション イベントと SharePoint 2013 アプリケーション イベント
Visual Studio の外部で実行されている SharePoint 2010 アプリケーションと SharePoint 2013 アプリケーションのユーザー プロファイル イベントと Unified Logging System (ULS) イベントのサブセットを記録できます。 これらのイベントを .iTrace ファイルに保存できます。 Visual Studio Enterprise 2015 以降のバージョン、以前のバージョンの Visual Studio Ultimate、または [トレース] モードで実行されている Microsoft Monitoring Agent が必要です。
.iTrace ファイルを開いたら、SharePoint 相関 ID を入力して対応する Web 要求を見つけ、記録されたイベントを表示し、特定のイベントからのデバッグを開始します。 ファイルにハンドルされない例外が含まれている場合は、相関 ID を選択して例外のデバッグを開始できます。
次を参照してください:
スナップショットをキャプチャする
すべてのブレークポイントとデバッガーのステップ イベントでスナップショットをキャプチャするように IntelliTrace を構成できます。 IntelliTrace では、各スナップショットにアプリケーションの完全な状態が記録されるため、複雑な変数を表示し、式を評価することができます。
Note
IntelliTrace スタンドアロン コレクターは、スナップショットのキャプチャをサポートしていません。
「IntelliTrace を使用して以前のアプリの状態を調べる」を参照してください。
関数呼び出し情報を収集する
関数の呼び出し情報を収集するように IntelliTrace を構成することができます。 この情報は、呼び出し履歴を表示したり、コードの呼び出しで前後に移動できます。 各関数呼び出しについて、IntelliTrace は次のデータを記録します。
- 関数名
- 関数のエントリ ポイントでパラメーターとして渡され、関数の終了ポイントで返されるプリミティブ データ型の値
- 読み取りまたは変更されたときの自動プロパティの値
- null かどうかの場合以外の値を除く、1 番目のレベルの子オブジェクトへのポインター
Note
IntelliTrace は、配列の最初の 256 個のオブジェクトと文字列の最初の 256 文字のみを収集します。
デバッグ履歴を使用したアプリの検査に関するページを参照してください。
モジュール情報を収集する
IntelliTrace で収集される呼び出し情報の量を制御するには、目的のモジュールのみを指定します。 これにより、収集時のアプリケーションのパフォーマンスを向上させることができます。 「IntelliTrace の機能」の IntelliTrace によって収集される情報量の制御に関するセクションを参照してください。
IntelliTrace はアプリケーションの速度を低下しますか?
既定では、選択された IntelliTrace イベントについてのみ情報が収集されます。 これが原因でアプリケーションの速度が低下するかどうかは、コードの構造と構成によって決まります。 たとえば、IntelliTrace がイベントを頻繁に記録する場合、アプリケーションの速度が低下する可能性があります。 また、アプリケーションのリファクタリングを検討する必要に迫られる場合があります。
呼び出し情報を収集すると、アプリケーションの速度が大幅に低下する可能性があります。 さらに、ディスクに保存される IntelliTrace ログ ファイル (.iTrace ファイル) のサイズが増加する可能性があります。 これらの影響を最小限に抑えるには、必要なモジュールのみから呼び出し情報を収集するようにします。 ご利用の .iTrace ファイルの最大サイズを変更するには、[ツール]、[オプション]、[IntelliTrace]、[詳細設定] の順に選択します。