保存された IntelliTrace データの使用 (C#、Visual Basic、C++)

IntelliTrace ログ (.iTrace) ファイルからデバッグを開始するときに、アプリケーションの実行内の特定のポイントに移動します。 このファイルには、アプリの実行中に IntelliTrace によって記録されるパフォーマンス イベント、例外、スレッド、テスト ステップ、モジュール、その他のシステム情報を含めることができます。

以下を保持していることを確認します。

• アプリケーション コードに対応するソース ファイルとシンボル (.pdb) ファイル。 それ以外の場合、Visual Studio はソースの場所を解決できません。"シンボルが見つかりません" というメッセージが表示されます。「シンボル (.pdb) とソース ファイルの指定」と「デプロイ後の問題の診断」を参照してください。

• .iTrace ファイルを開くには、開発用コンピューターまたは別のコンピューターにインストールされている Visual Studio Enterprise (Professional または Community エディションは除く) を使用します。

• 次のいずれかのソースからの .iTrace ファイル:

  ソース	見る
  Visual Studio Enterprise での IntelliTrace セッション (Professional エディションまたは Community エディションではありません)	IntelliTrace の機能
  Microsoft Monitoring Agent は単独で、または System Center 2012 R2 Operations Manager と併用して、展開中の ASP.NET Web アプリケーションや SharePoint アプリケーションに使用されます。	- デプロイ後の問題を診断する - System Center 2012 R2 Operations Manager の新機能

何をしたいですか？

• IntelliTrace ログを開く

• IntelliTrace ログについて

• IntelliTrace ログからデバッグを開始する

IntelliTrace ログを開く

Visual Studio Enterprise を使用しているコンピューターで、.iTrace ファイルを開きます。

• Visual Studio の外部にある .iTrace ファイルをダブルクリックするか、Visual Studio 内からファイルを開きます。

  または

• .iTrace ファイルが Team Foundation Server 作業項目に添付されている場合は、作業項目の次の手順に従います。

  • [ すべてのリンク] で、.iTrace ファイルを見つけます。 開けて下さい。

    または

  • [ 再現手順] で、[ IntelliTrace ] リンクを選択します。

IntelliTrace ログを理解する

.iTrace ファイルの次のセクションの一部は、SharePoint アプリケーションなど、特定のソースからデータを収集した場合にのみ表示されます。

各セクションの情報を見つけるのに役立つヒントを次に示します。

• データを並べ替える列ヘッダーを選択します。

• 検索ボックスを使用してデータをフィルター処理します。 プレーンテキスト検索は、時間列を除くすべての列で機能します。 また、列ごとに 1 つのフィルターを使用して、特定の列に対して検索をフィルター処理することもできます。 空白、コロン (:)、検索値を含まない列名を入力します。 セミコロン (;) を使用して、別の列と検索値を追加します。

  たとえば、[ 説明] 列に "slow" という単語が含まれるパフォーマンス イベントを検索するには、次のように入力します。

  Description:slow

IntelliTrace ログからデバッグを開始する

パフォーマンス違反

アプリ用に記録されたパフォーマンス イベントを確認します。 頻繁に発生しないイベントを非表示にできます。

パフォーマンス イベントからデバッグを開始するには

1. [ パフォーマンス違反] で、記録されたパフォーマンス イベント、その合計実行時間、およびその他のイベント情報を確認します。 次に、特定のパフォーマンス イベント中に呼び出されたメソッドについて詳しく調べられます。

   表示する

   イベントをダブルクリックするだけです。

2. イベント ページで、これらの呼び出しの実行時間を確認します。 実行ツリーで低速な呼び出しを見つけます。

   複数の呼び出しがある場合、それが入れ子になっているかどうかに関係なく、最も遅い呼び出しは独自のセクションに表示されます。

3. その呼び出しを展開して、その時点で記録されていた入れ子の呼び出しやパラメーター値を確認します。

   (キーボード: 入れ子になった通話を表示または非表示にするには、 右方向 キーまたは 左方向 キーをそれぞれ押します。入れ子になった呼び出しのパラメーター値を表示または非表示にするには、 Space キーを押します)。

   呼び出しからデバッグを開始します。

   

   通話をダブルクリックするか、 Enter キーを押すこともできます。

   メソッドがアプリケーション コード内にある場合、Visual Studio はそのメソッドにアクセスします。

   

   これで、他の記録された値、呼び出し履歴、コードのステップ 実行を確認したり、 IntelliTrace ウィンドウを使用して、このパフォーマンス イベント中に呼び出された 他のメソッド間を "イン タイム" に前後に移動 したりできます。

例外データ

アプリに関してスローされ記録された例外を確認します。 最新の例外のみを表示できるように、同じ型と呼び出し履歴を持つ例外をグループ化できます。

例外からデバッグを開始するには

1. [ 例外データ] で、記録された例外イベント、その種類、メッセージ、および例外が発生したタイミングを確認します。 コードをさらに詳しく調べるには、例外のグループ内の最新のイベントからデバッグを開始します。

   

   イベントをダブルクリックするだけです。 イベントがグループ化されていない場合は、[ このイベントのデバッグ] を選択します。

   アプリケーション コードで例外が発生した場合、Visual Studio は例外が発生した場所に進みます。

   

   これで、他の記録された値、呼び出し履歴を確認したり、 IntelliTrace ウィンドウを使用して、他の記録されたイベント、関連するコード、およびそれらの時点で記録された値 の間を "イン タイム" に前後に移動したりできます。

   コラム	を表示します。
   タイプ	例外の .NET 型
   グループ化された例外の最新のメッセージまたはグループ化されていない例外のメッセージ	例外によって提供されるメッセージ
   グループ化された例外の数	例外がスローされた回数
   グループ化されていない例外のスレッド ID	例外をスローしたスレッドの ID
   最新のイベント時間 または イベント時間	例外がスローされたときに記録されたタイム スタンプ
   コールスタック	例外の呼び出し履歴。 呼び出し履歴を表示するには、一覧で例外を選択します。 呼び出し履歴が例外リストの下に表示されます。

分析

SharePoint 関連付け ID を使用して SharePoint 2010 および SharePoint 2013 アプリケーションに関する問題を診断するか、Microsoft Monitoring Agent で検出された未処理の例外を確認します。

• SharePoint 関連付け ID を使用して、一致する Web 要求とイベントを検索します。 イベントを選択し、イベントが発生した場所とタイミングでデバッグを開始します。

• Microsoft Monitoring Agent でハンドルされない例外が見つかった場合は、例外を選択し、例外が発生した場所とタイミングでデバッグを開始します。

SharePoint 関連付け ID を使用してデバッグを開始する

1. ソースから SharePoint 関連付け ID をコピーします。

   例えば次が挙げられます。

   

2. .iTrace ファイルを開き、[ 分析 ] に移動し、SharePoint 関連付け ID を入力して、一致する Web 要求と記録されたイベントを確認します。

   

3. [ イベントの要求] で、イベントを確認します。 上部から、イベントは発生した順序で表示されます。

   1. イベントを選択すると、その詳細が表示されます。

   2. [ デバッグの開始 ] を選択して、イベントが発生した時点でデバッグを開始します。

      

   IntelliTrace イベントと共に、次の種類の SharePoint イベントを確認できます。

• ユーザー プロファイル イベント

  これらのイベントは、SharePoint がユーザー プロファイルを読み込み、ユーザー プロファイルのプロパティが読み取られたり変更されたりしたときに発生します。

• 統合ログ システム (ULS) イベント

  Microsoft Monitoring Agent は、SharePoint ULS イベントのサブセットと次のフィールドを記録します。

  IntelliTrace フィールド	SharePoint ULS フィールド
  身分証明書	EventID
  レベル	レベル
  カテゴリ ID	カテゴリ ID
  カテゴリ	カテゴリ
  面積	製品
  アウトプット	メッセージ
  相関 ID	相関 ID

ハンドルされない例外からデバッグを開始する

1. 例外の SharePoint 関連付け ID を選択します。 例外は、種類と呼び出し履歴によってグループ化されます。

2. (省略可能)[ 呼び出し履歴] を展開して、例外のグループの呼び出し履歴を表示します。

3. [ 例外のデバッグ ] を選択して、例外が発生した場所とタイミングでデバッグを開始します。

   

   チュートリアルについては、「 チュートリアル: IntelliTrace を使用した SharePoint アプリケーションのデバッグ」を参照してください。 エージェントが記録するデータの種類については、「 IntelliTrace の機能」を参照してください。

スレッドの一覧

ターゲット プロセスで実行された記録されたスレッドを調べます。 選択したスレッドの最初の有効な IntelliTrace イベントからデバッグを開始できます。

特定のスレッドからデバッグを開始するには

1. [ スレッドの一覧] で、スレッドを選択します。

2. スレッドの一覧の下部にある [デバッグの開始] を選択します。 スレッドをダブルクリックすることもできます。

   アプリの開始位置からデバッグを開始するには、[ メイン スレッド] をダブルクリックします。 IntelliTrace の機能を参照してください。

   ユーザーが作成するスレッド データは、IIS でホストされる Web アプリ用にサーバーが作成および管理するスレッドよりも便利な場合があります。

特定のテスト ステップからデバッグを開始するには

1. [ テスト ステップ グリッド] を展開します。 テスト ステップを選択します。

2. テスト ステップ グリッドの下部にある [デバッグの開始] を選択します。 テスト ステップをダブルクリックすることもできます。

   これにより、選択したテスト ステップの後の最初の有効な IntelliTrace イベントからデバッグが開始されます。

   テスト データが存在する場合、IntelliTrace は、テストの実行に使用された関連する Team Foundation Server ビルドの解決を試みます。 ビルドが見つかった場合、アプリに関連付けられているシンボルは自動的に解決されます。

システム情報

このセクションでは、ハードウェア、オペレーティング システム、環境およびプロセス固有の情報など、アプリをホストしたシステムの詳細を示します。

モジュール

このセクションでは、ターゲット プロセスが読み込んだモジュールを示します。 モジュールは、読み込まれた順序で表示されます。

詳細情報はどこで入手できますか?

IntelliTrace スタンドアロン コレクターの使用

IntelliTrace の機能

手動テストでより多くの診断データを収集する

IntelliTrace

フォーラム

Visual Studio デバッガー