トランザクションの検索と診断

Azure Monitor Application Insights では、特定のテレメトリ項目を正確に特定するためのトランザクション検索と、包括的なエンド ツー エンドのトランザクション分析のためのトランザクション診断が提供されます。

トランザクション検索: このエクスペリエンスにより、ユーザーはページ ビュー、例外、Web 要求などの個々のテレメトリ項目を検索して調べることができます。 さらに、アプリケーションにコード化されたログのトレースやイベントを表示する機能も提供します。 アプリケーション内のパフォーマンスの問題とエラーを識別します。

トランザクション診断: 依存関係や例外を含むエンド ツー エンドのトランザクション詳細の包括的な分析情報により、コンポーネントの問題をすばやく特定します。 検索インターフェイスを使い、検索結果から項目を選んでこの機能にアクセスします。

トランザクションの検索

トランザクションの検索は、ページ ビュー、例外、Web 要求などの個々のテレメトリ項目を検索または探索するために使用する Application Insights の機能です。 また、ログ トレースやコーディングしたイベントも表示できます。

データに対するより複雑なクエリについては、Log Analytics を使用します。

検索が表示される場所

検索は、Azure portal または Visual Studio にあります。

Azure Portal で次の操作を行います。

トランザクション検索は、Application Insights で、お使いのアプリケーションの [概要] タブから開くことができます。 また、左側のメニューの [調査] の下から [検索] を選択することもできます。

テレメトリ項目 (サーバー要求、ページ ビュー、コーディングしたカスタム イベントなど) の一覧を表示するには、[イベントの種類] ドロップダウン メニューに移動します。 [結果] リストの上部には、一定期間に発生したイベントの数を示す概要グラフが表示されます。

ドロップダウン メニューに戻るか、[Refresh](最新の情報に更新) をクリックして、新しいイベントを取得します。

Visual Studio 内

Visual Studio には、[Application Insights の検索] ウィンドウもあります。 このウィンドウは、デバッグ対象アプリケーションによって生成されたテレメトリ イベントを表示する際に便利ですが、 Azure Portal の発行済みアプリから収集されたイベントを表示することもできます。

Visual Studio で [Application Insights の検索] ウィンドウを開きます。

[Application Insights の検索] ウィンドウには、Web ポータルと似た機能があります。

[操作の追跡] タブは、要求またはページ ビューを開くと使用できます。 "操作" とは、1 つの要求またはページ ビューに関連付けられているイベントのシーケンスです。 たとえば、依存関係の呼び出し、例外、トレース ログ、およびカスタム イベントが、1 つの操作に含まれる可能性があります。 [操作の追跡] タブには、要求またはページ ビューとの関連で、これらのイベントのタイミングと期間がグラフィカルに表示されます。

個々の項目の確認

任意のテレメトリ項目を選択すると、キー フィールドと関連項目が表示されます。

エンドツーエンド トランザクションの詳細ビューが開きます。

イベントの種類のフィルター選択

[イベントの種類] ドロップダウン メニューを開き、表示するイベントの種類を選択します。 後でフィルターを復元する場合は、[リセット] を選択します。

イベントの種類は、次のとおりです。

• トレース: 診断ログ (TrackTrace、log4Net、NLog、System.Diagnostic.Trace の呼び出しなど)。
• 要求: サーバー アプリケーションで受信した HTTP 要求 (ページ、スクリプト、画像、スタイル ファイル、データなど)。 これらのイベントは、要求と応答の概要グラフの作成に使用されます。
• ページ ビュー: Web クライアントによって送信されたテレメトリ。ページ ビュー レポートの作成に使用されます。
• カスタム イベント: 利用状況の監視のために TrackEvent() への呼び出しを挿入した場合は、ここで検索できます。
• 例外: キャッチされていないサーバー内の例外、および TrackException() を使用してログに記録した例外。
• 依存関係: REST API やデータベースなどの他のサービスに対するサーバー アプリケーションからの呼び出し、およびクライアント コードからの AJAX 呼び出し。
• 可用性: 可用性テストの結果

プロパティの値に基づくフィルター選択

プロパティの値に基づいてイベントをフィルター選択できます。 使用可能なプロパティは、選択したイベントの種類によって異なります。 開始するには、[フィルター] を選択します。

特定のプロパティの値を選択しない場合、すべての値を選択するのと同じ意味になり、 そのプロパティに基づくフィルターはオフになります。

フィルター値の右側の値は、現在のフィルター選択されたセットに含まれるイベントの発生回数を表します。

同じプロパティを持つイベントの検索

同じプロパティ値を持つすべての項目を検索するには、[検索] ボックスにそれを入力するか、[フィルター] タブでプロパティを調べているときにチェック ボックスをオンにします。

データの検索

Note

さらに複雑なクエリを作成するには、[検索] ペインの上部にある [ログ (Analytics)] を開きます。

すべてのプロパティ値について語句を検索できます。 この機能は、プロパティ値を持つカスタム イベントを作成した場合に便利です。

時間の範囲を設定することもできます。範囲が狭いほど検索時間は短くなります。

部分文字列ではなく、語句全体を検索します。 引用符で特殊文字を囲みます。

String	検索されない	Found
HomeController.About	home controller out	homecontroller about "homecontroller.about"
United States	Uni ted	united states united AND states "united states"

次の検索式を使用できます。

サンプル クエリ	結果
apple	時間範囲内でフィールドに apple という単語が含まれるすべてのイベントを検索します。
apple AND banana apple banana	両方の単語を含むイベントを検索します。 and ではなく、大文字の AND を使います。 短縮形。
apple OR banana	どちらかの単語を含むイベントを検索します。 or ではなく、OR を使用してください。
apple NOT banana	ある単語を含む一方で他方の単語を含まないイベントを検索します。

サンプリング

アプリが大量のテレメトリを生成し、ASP.NET SDK バージョン 2.0.0-beta3 以降を使っている場合、アダプティブ サンプリングを介してポータルに送信される量は自動的に削減されます。 このモジュールからは、代表的なイベントの一部のみが送信されます。 同じ要求に関連するイベントが 1 つのグループとして選択または選択解除されるので、関連するイベント間を切り替えることができます。

サンプリングについてはこちらを参照してください。

作業項目を作成する

任意のテレメトリ項目の詳細を使用して、GitHub または Azure DevOps でバグを作成できます。

任意のテレメトリ項目を選択して、エンドツーエンド トランザクション詳細ビューに移動します。 次に、[作業項目の作成] を選択します。

この手順を初めて行う場合は、Azure DevOps 組織とプロジェクトへのリンクを構成するように求められます。 [作業項目] タブでリンクを構成することもできます。

さらに多くのテレメトリを Application Insights に送信する

Application Insights SDK によって送信される標準のテレメトリに加えて、次の操作を実行できます。

• .NET または Java の好みのログ記録フレームワークからのログ トレースをキャプチャする。 これは、ログ トレースを検索し、ページ ビュー、例外、その他のイベントと関連付けることができることを意味します。

• カスタム イベント、ページ ビュー、および例外を送信するコードを作成する。

ログとカスタム テレメトリを Application Insights に送信する方法についてはこちらを参照してください。

よく寄せられる質問

よく寄せられる質問に対する回答を確認します。

保持されるデータの量はどのくらいですか

「制限の概要」を参照してください。

サーバーの要求の POST データを表示するにはどうしたらよいですか

POST データは自動的に記録されませんが、TrackTrace または log の呼び出しを使用できます。 メッセージ パラメーターに POST データを格納します。 プロパティと同じ方法でメッセージをフィルター処理することはできませんが、サイズの制限が緩和されます。

Azure 関数検索で結果が返されないのはなぜですか?

Azure Functions は URL クエリ文字列をログしません。

トランザクションの診断

統合診断エクスペリエンスは、Application Insights に監視されるすべてのコンポーネントからのサーバー側テレメトリを単一ビューに関連付けます。 複数のリソースがあるかどうかは関係ありません。 Application Insights によって基になる関係が検出されるため、トランザクションの速度低下または障害の原因となったアプリケーション コンポーネント、依存関係、または例外を簡単に診断することができます。

コンポーネントとは

コンポーネントは、分散型またはマイクロサービス アプリケーションの個別にデプロイできる部分です。 開発者と運用チームには、これらのアプリケーション コンポーネントによって生成されたテレメトリに対して、コード レベルの可視性またはアクセスがあります。

• コンポーネントは、チームや組織がアクセスできない可能性がある SQL、イベント ハブなどの "監視される" 外部依存関係 (コードまたはテレメトリ) とは異なります。
• コンポーネントは、任意の数のサーバー、ロール、またはコンテナー インスタンス上で実行されます。
• サブスクリプションが異なる場合でも、コンポーネントは別個の Application Insights インストルメンテーション キーの場合があります。 コンポーネントは、1 つの Application Insights インストルメンテーション キーに報告されるさまざまなロールの場合もあります。 新しいエクスペリエンスでは、その設定方法に関係なく、すべてのコンポーネントの詳細が表示されます。

Note

関連項目のリンクが見つからない場合、 関連するすべてのテレメトリは、左側の一番上と一番下のセクションにあります。

トランザクションの診断エクスペリエンス

このビューには 4 つの重要な部分があります。

• 結果リスト
• コンポーネント間のトランザクションのグラフ
• この操作に関連するすべてのテレメトリのタイムシーケンス リスト
• 選んだテレメトリ項目の詳細ウィンドウ

コンポーネント間のトランザクションのグラフ

このグラフでは、タイムラインに要求の継続時間を表す横棒と、コンポーネント間の依存関係が示されます。 また、収集されたすべての例外も、タイムライン上でマークされます。

• このグラフの一番上にある行は、エントリ ポイントを表しています。 これは、このトランザクションで呼び出される最初のコンポーネントに対する受信要求です。 継続時間は、トランザクションが完了するまでにかかる合計時間です。
• 外部依存関係の呼び出しは、すべてシンプルな折りたたみ不可の行で表され、アイコンは依存関係の種類を表します。
• その他のコンポーネントの呼び出しは、折りたたみ可能な行で表されます。 各行は、コンポーネントで呼び出される特定の操作に対応します。
• 既定では、選んだ要求、依存関係、例外が横に表示されます。 行を選択すると、その詳細が表示されます。

Note

他のコンポーネントへの呼び出しには 2 行があります。 1 行は、呼び出し元コンポーネントからの送信呼び出し (依存関係) を表します。 もう 1 行は、呼び出されるコンポーネントの受信要求に対応しています。 先頭のアイコンと継続時間バーの個別のスタイルは、これらを区別するのに役立ちます。

この操作 ID のすべてのテレメトリ

このセクションでは、このトランザクションに関連するすべてのテレメトリの時系列順の単純な一覧が表示されます。 トランザクションのグラフに表示されないカスタム イベントとトレースも表示されます。 この一覧をフィルター処理して、特定のコンポーネントまたは呼び出しで生成されたテレメトリのみを表示できます。 この一覧の任意のテレメトリ項目を選んで、対応する詳細を横に表示できます。

選択したテレメトリの詳細

この折りたたみ可能なペインには、トランザクション グラフまたは一覧から選択した項目の詳細が表示されます。 [すべて表示] では、収集されたすべての標準属性が一覧表示されます。 カスタム属性は標準セットの下に個別に一覧表示されます。 [呼び出し履歴] トレース ウィンドウの下にある省略記号ボタン (...) を選び、トレースをコピーするオプションを表示します。 [Open profiler traces] (Profiler トレースを開く) と [デバッグ スナップショットを開く] を選ぶと、対応する詳細ウィンドウにコード レベルの診断が表示されます。

[検索結果]

この折りたたみ可能なウィンドウには、フィルター条件を満たすその他の結果が表示されます。 いずれかの結果を選ぶと、先ほど示した 3 つのセクションの対応する項目が更新されます。 サンプリングがいずれかのコンポーネントで有効になっている場合でも、すべてのコンポーネントで使用可能な詳細を含む可能性が最も高いサンプルを探そうとしています。 これらのサンプルは提案として表示されます。

Profiler とスナップショット デバッガー

Application Insights Profiler またはスナップショット デバッガーは、パフォーマンスと障害の問題をコード レベルで診断するのに役立ちます。 このエクスペリエンスを使用して、任意のコンポーネントからの Profiler トレースやスナップショットを 1 回の選択で表示できます。

Profiler が動作しない場合は、serviceprofilerhelp@microsoft.com にお問い合わせください。

スナップショット デバッガーが動作しない場合は、snapshothelp@microsoft.com にお問い合わせください。

よく寄せられる質問

このセクションでは、一般的な質問への回答を示します。

グラフ上に 1 つのコンポーネントが表示され、他のコンポーネントは詳細がない外部依存関係としてのみ表示されるのはなぜですか?

次の理由が考えられます。

• その他のコンポーネントは Application Insights を使用してインストルメント化されましたか。
• それらには Application Insights SDK の最新の安定バージョンが使用されていますか。
• これらのコンポーネントが個別の Application Insights リソースである場合、アクセス権を持っていることを確認します。 アクセス権を持っていて、コンポーネントが最新の Application Insights SDK でインストルメント化されている場合は、右上隅にあるフィードバック チャネルからお知らせください。

依存関係の行が重複しています。 これは期待される動作ですか。

現時点では、送信依存関係呼び出しと受信要求は区別して表示されます。 通常、2 つの呼び出しは、ネットワーク ラウンド トリップのために継続時間の値が異なる以外は、まったく同一に見えます。 先頭のアイコンと継続時間バーの個別のスタイルは、これらを区別するのに役立ちます。 このデータの表示方法はわかりにくいですか。 フィードバックをお待ちしております。

異なるコンポーネント インスタンス間のクロック スキューはどのように処理されますか?

タイムラインはトランザクションのグラフでクロック スキューに対して調整されます。 詳細ウィンドウか、または Log Analytics を使用することで、正確なタイムスタンプを確認できます。

関連項目のクエリのほとんどが、新しいエクスペリエンスからなくなっているのはなぜですか?

この動作は仕様です。 すべての関連項目は、コンポーネント全体に渡って、上部と下部のセクションの左側で既に使用できます。 新しいエクスペリエンスの左側で扱われない関連項目が 2 つあります。このイベントの 5 分前後からのすべてのテレメトリと、ユーザー タイムラインです。

Application Insights JavaScript SDK を使うときに、トランザクションあたりのイベントが少ないものを表示する方法はありますか?

トランザクション診断エクスペリエンスでは、同じ操作 ID を共有する単一操作のすべてのテレメトリが表示されます。 既定では、Application Insights SDK for JavaScript は、一意のページ ビューごとに新しい操作を作成します。 シングルページ アプリケーション (SPA) では、1 つのページ ビュー イベントのみが生成され、生成されるすべてのテレメトリに対して 1 つの操作 ID が使われます。 その結果、多くのイベントが同じ操作に関連付けられる可能性があります。

このようなシナリオでは、自動ルート追跡を使用すると、SPA でのナビゲーションのために新しい操作が自動的に作成されます。 enableAutoRouteTracking を有効にして、URL ルートが更新されるたびにページ ビューが生成される (論理ページ ビューが発生する) ようにする必要があります。 操作 ID を手動で更新する場合は appInsights.properties.context.telemetryTrace.traceID = Microsoft.ApplicationInsights.Telemetry.Util.generateW3CId() を呼び出します。 手動で PageView イベントをトリガーすると、操作 ID もリセットされます。

トランザクションの詳細時間が上位要求期間に加算されないのはなぜですか。

ガント チャートで説明されていない時間は、追跡される依存関係の対象ではない時間です。 この問題は、外部呼び出しが自動または手動でインストルメント化されていない場合に発生する可能性があります。 また、外部呼び出しのためではなく、処理中にかかった時間が原因で発生することもあります。

すべての呼び出しがインストゥルメント化される場合、時間が費やされる根本原因はおそらくプロセスにあります。 プロセスの診断に便利なツールは Application Insights プロファイラです。

Azure portal で Application Insights を操作しているときに、"データの取得中にエラーが発生しました" というメッセージが表示された場合はどうすればよいですか?

このエラーは、ブラウザーから必要な API を呼び出すことができなかったか、API から失敗応答が返されたことを示します。 この動作をトラブルシューティングするには、ブラウザーの InPrivate ウィンドウを開き、実行されているブラウザーの拡張機能があれば無効にしても、このポータル動作を再現できるかどうかを確認します。 それでもポータル エラーが発生する場合は、他のブラウザーまたは他のマシンでテストを行い、API 呼び出しに失敗しているクライアント コンピューターから DNS や他のネットワーク関連の問題を調査します。 ポータル エラーが続き、さらなる調査が必要な場合は、予期しないポータルの動作を再現しながらブラウザー ネットワーク トレースを収集し、Azure portal からサポート ケースを開きます。

関連項目

• Analytics で複雑なクエリを作成する
• Application Insights にログとカスタム テレメトリを送信する
• 可用性の概要