Application Insights を使用してエラー、パフォーマンス、およびトランザクションを調査する

Application Insights は、 アプリケーションからテレメトリを収集して、エラーの診断と低速なトランザクションの調査に役立ちます。 これには、次の 4 つの重要なツールが含まれています。

• エラー ビュー - エラー、例外、およびエラーを追跡し、迅速な問題解決と安定性の向上のための明確な分析情報を提供します。

• パフォーマンス ビュー - 応答時間と操作数を表示することで、アプリケーションのボトルネックをすばやく特定し、解決するのに役立ちます。

• 検索ビュー - ユーザーは、ページ ビュー、例外、カスタム イベントなどの個々のテレメトリ項目を検索して調べることができます。

• トランザクション診断 - エンドツーエンドのトランザクションの詳細に関する包括的な分析情報を通じて、コンポーネントの問題をすばやく特定するのに役立ちます。

これらのツールを組み合わせることで、Web アプリケーションの継続的な正常性と効率性が確保されます。 これらを使用して、ユーザーに最も影響を与える問題や拡張機能を特定できます。

概要

テレメトリのフィルター処理

既定のフィルター

すべてのエクスペリエンスを使用すると、時間範囲でテレメトリをフィルター処理できます。 さらに、各エクスペリエンスには、独自の既定のフィルターが付属しています。

フィルターの追加

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

1. を選択してフィルターを追加します。

   

2. 左側のドロップダウン リストからプロパティを選択します。

3. 中央のドロップダウン リストから、 =、 !=、 contains、または not containsのいずれかの演算子を選択します。

4. 右側のドロップダウン リストから、フィルター処理するすべてのプロパティ値を選択します。

   注

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

5. 別のフィルターを追加するには、[ をもう一度選択します。

検索テレメトリ

分析データを使用する

Application Insights によって収集されたすべてのデータは、 Log Analytics に格納されます。 調査中の例外を生成した要求を分析するための豊富なクエリ言語が提供されます。

1. パフォーマンス、エラー、または検索ビューで、上部のナビゲーション バー の [ログで表示 ] を選択し、ドロップダウン メニューからクエリを選択します。

   

2. このアクションにより、[ ログ ] ビューが表示され、クエリをさらに変更したり、サイドバーから別のクエリを選択したりできます。

   

テレメトリを調査する

クライアント側のパフォーマンスとエラーを分析する

Application Insights を使用して Web ページをインストルメント化すると、ページ ビュー、ブラウザー操作、依存関係を可視化できます。 このブラウザー データを収集するには 、Web ページにスクリプトを追加する必要があります。

1. スクリプトを追加したら、Performance または Failures ビューで Browser トグルを選択して、ページ ビューとそれに関連するパフォーマンス メトリックをaccessできます。

   

   このビューには、ブラウザーの観点から、アプリケーションのさまざまなテレメトリの視覚的な概要が表示されます。

   ヒント

   シングルページ アプリケーション (SPA) の場合は、ルート変更の enableAutoRouteTracking を有効にして、各論理ページが独自のページ ビューと操作を作成できるようにします。 それ以外の場合、複数のルート変更を 1 つの操作に関連付けることができ、一部のページ ビューの期間は 0として表示できます。

2. ブラウザー操作の場合、 エンド ツー エンドのトランザクションの詳細 ビューには、ブラウザーの種類とその場所など、ページを要求しているクライアントのページ ビュー プロパティ が表示されます。 この情報は、特定の種類のクライアントに関連するパフォーマンスの問題があるかどうかを判断するのに役立ちます。

   

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

トランザクション診断エクスペリエンス (エンド ツー エンド トランザクションの詳細ビューとも呼ばれます) には、トランザクションのガント チャートが表示されます。このグラフには、期間と応答コードを含むすべてのイベントが一覧表示されます。

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

特定のイベントを選択すると、基になるコマンドや呼び出し履歴などの追加情報など、そのプロパティが表示されます。

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

リリース注釈

リリース注釈は、Application Insights グラフのデプロイやその他の重要なイベントをマークし、変更とパフォーマンス、障害、使用状況との相関関係を把握できるようにします。

Azure Pipelinesを使用した自動注釈

Azure Pipelines は、次のすべての条件に該当する場合に、デプロイ時にリリース注釈を作成します。

インライン スクリプトを使用してパイプライン内の注釈を構成する

前のセクションのタスクを使用しない場合は、デプロイ ステージにインライン スクリプトを追加します。

1. 既存のパイプラインを開くか、新しいパイプラインを作成し、[ステージ] でタスクを選択します。

2. 新しい Azure CLI タスクを追加します。

3. Azure サブスクリプションを選択します。 [スクリプトの種類] を [PowerShell] に設定し、[スクリプトの場所] を [インライン] に設定します。

4. Azure CLI でリリース注釈を作成する の手順 2 の PowerShell スクリプトを Inline Script に追加します。

5. スクリプト引数を追加します。 山かっこ内のプレースホルダーを置き換えます。

   -aiResourceId "<aiResourceId>" `
   -releaseName "<releaseName>" `
   -releaseProperties @{"ReleaseDescription"="<a description>";
       "TriggerBy"="<Your name>" }
   

   次の例は、build 変数と release 変数を使用して、オプションの releaseProperties 引数に設定できるメタデータを示しています。 保存 を選択します。

   -releaseProperties @{
   "BuildNumber"="$(Build.BuildNumber)";
   "BuildRepositoryName"="$(Build.Repository.Name)";
   "BuildRepositoryProvider"="$(Build.Repository.Provider)";
   "ReleaseDefinitionName"="$(Build.DefinitionName)";
   "ReleaseDescription"="Triggered by $(Build.DefinitionName) $(Build.BuildNumber)";
   "ReleaseEnvironmentName"="$(Release.EnvironmentName)";
   "ReleaseId"="$(Release.ReleaseId)";
   "ReleaseName"="$(Release.ReleaseName)";
   "ReleaseRequestedFor"="$(Release.RequestedFor)";
   "ReleaseWebUrl"="$(Release.ReleaseWebUrl)";
   "SourceBranch"="$(Build.SourceBranch)";
   "TeamFoundationCollectionUri"="$(System.TeamFoundationCollectionUri)" }
   

Azure CLIを使用してリリース注釈を作成する

DevOps をAzureせずに、任意のプロセスからリリース注釈を作成するには、次の PowerShell スクリプトを使用します。

1. Azure CLIにサインインします。

2. 次のスクリプトを CreateReleaseAnnotation.ps1 として保存します。

   param(
       [parameter(Mandatory = $true)][string]$aiResourceId,
       [parameter(Mandatory = $true)][string]$releaseName,
       [parameter(Mandatory = $false)]$releaseProperties = @()
   )
   
   # Function to ensure all Unicode characters in a JSON string are properly escaped
   function Convert-UnicodeToEscapeHex {
     param (
       [parameter(Mandatory = $true)][string]$JsonString
     )
     $JsonObject = ConvertFrom-Json -InputObject $JsonString
     foreach ($property in $JsonObject.PSObject.Properties) {
       $name = $property.Name
       $value = $property.Value
       if ($value -is [string]) {
         $value = [regex]::Unescape($value)
         $OutputString = ""
         foreach ($char in $value.ToCharArray()) {
           $dec = [int]$char
           if ($dec -gt 127) {
             $hex = [convert]::ToString($dec, 16)
             $hex = $hex.PadLeft(4, '0')
             $OutputString += "\u$hex"
           }
           else {
             $OutputString += $char
           }
         }
         $JsonObject.$name = $OutputString
       }
     }
     return ConvertTo-Json -InputObject $JsonObject -Compress
   }
   
   $annotation = @{
       Id = [GUID]::NewGuid();
       AnnotationName = $releaseName;
       EventTime = (Get-Date).ToUniversalTime().GetDateTimeFormats("s")[0];
       Category = "Deployment"; #Application Insights only displays annotations from the "Deployment" Category
       Properties = ConvertTo-Json $releaseProperties -Compress
   }
   
   $annotation = ConvertTo-Json $annotation -Compress
   $annotation = Convert-UnicodeToEscapeHex -JsonString $annotation
   
   $accessToken = (az account get-access-token | ConvertFrom-Json).accessToken
   $headers = @{
       "Authorization" = "Bearer $accessToken"
       "Accept"        = "application/json"
       "Content-Type"  = "application/json"
   }
   $params = @{
       Headers = $headers
       Method  = "Put"
       Uri     = "https://management.azure.com$($aiResourceId)/Annotations?api-version=2015-05-01"
       Body    = $annotation
   }
   Invoke-RestMethod @params
   

スクリプトを呼び出して、パラメーターの値を渡します。 -releaseProperties パラメーターは省略可能です。

.\CreateReleaseAnnotation.ps1 `
 -aiResourceId "<aiResourceId>" `
 -releaseName "<releaseName>" `
 -releaseProperties @{"ReleaseDescription"="<a description>";
     "TriggerBy"="<Your name>" }

注釈を表示する

Application Insights では、次のエクスペリエンスでリリース注釈が表示されます。

• パフォーマンスとエラー
• 使用状況
• ブック (時系列の視覚化用)

注釈は、グラフの上部にあるマーカーとして視覚化されます。

ブックで注釈を有効にするには [詳細設定] を開いて、[注釈の表示] を選択します。 任意の注釈マーカーを選択すると、リクエスタ、ソース管理ブランチ、リリース パイプライン、環境などのリリースの詳細が表示されます。

よく寄せられる質問

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

検索ビュー

トランザクション診断

次のステップ

• アプリケーション マップを使用して、アプリケーションのすべてのコンポーネントにわたるパフォーマンスのボトルネックとエラーのホットスポットを特定する方法の詳細について確認します。
• [可用性] ビューを使用して定期的なテストを設定し、アプリケーションの可用性と応答性を監視する方法の詳細について確認します。
• Log Analytics を使用して複雑なクエリを記述し、テレメトリ データからより深い分析情報を得る方法について説明します。
• より包括的な監視のために Application Insights にカスタム テレメトリを送信 する方法について説明します。
• アップタイムと応答性の監視の概要については、可用性の 概要を参照してください。