Azure Monitor Application Insights でアプリケーションテレメトリが見つからない場合のトラブルシューティング

[アーティクル]
04/13/2024

この記事では、PowerShell または curl を使用して接続とテレメトリインジェストをテストすることでテレメトリが欠落する処理パイプラインの手順を特定するのに役立ちます。

テレメトリが欠落する原因となる可能性のある手順

次の図は、インジェストと消費中にテレメトリが欠落する可能性がある手順を示しています。

テレメトリが処理パイプラインで渡す手順。

アプリケーションテレメトリがAzure portalに表示されない場合は、処理パイプラインのステップ間でエラーが発生する可能性があります。

Application Insights SDK またはエージェントが正しく構成されておらず、アプリケーションテレメトリがインジェストエンドポイントに送信されません。
SDK またはエージェントは正しく構成されていますが、ネットワークはインジェストエンドポイントへの呼び出しをブロックします。
インジェストエンドポイントは、受信テレメトリをドロップまたはスロットルします。
インジェストパイプラインは、サービスの正常性のために、処理の一環としてテレメトリを削除または大幅に遅くします。
(一般的でない)Log Analytics は、テレメトリレコードを保存するときにサービス正常性の問題に直面します。
(一般的でない)でのクエリ API api.applicationinsights.io は、Log Analytics からレコードのクエリを実行すると失敗します。
Azure portalは、表示しようとしているレコードをプルまたはレンダリングできません。

サンプルテレメトリレコードを送信して手順を特定する

構成の問題または一時的な問題は、Applications Insights サービス全体の任意の場所で発生する可能性があります。データがない、またはデータが欠落している現象を引き起こす処理パイプライン内の手順を特定するには、PowerShell または curl を使用してサンプルテレメトリレコードを送信します。 PowerShell スクリプトまたは curl コマンドについては、次のセクションを参照してください。

可用性テスト結果を送信する PowerShell スクリプト
Curl コマンドを使用して可用性テスト結果を送信する
要求テレメトリレコードを送信する PowerShell スクリプト

Web アプリがオンプレミスサーバーまたは Azure VM で実行されている場合は、サーバーまたは VM に接続し、PowerShell を使用して Applications Insights サービスインスタンスに 1 つのテレメトリレコードを送信します。テレメトリの送信に問題がある Web アプリが Kudu で実行されている場合は、Azure Web Appsの Kudu の PowerShell デバッグコンソールから次のスクリプトを実行します。

$ProgressPreference = "SilentlyContinue"
Invoke-WebRequest -Uri $url -Method POST -Body $availabilityData -UseBasicParsing

注:

コマンドレットを実行する前に Invoke-WebRequest 、コマンドレットを発行します $ProgressPreference = "SilentlyContinue" 。
または -Debugを使用-Verboseすることはできません。代わりに、を使用します -UseBasicParsing。

PowerShell を使用してサンプルテレメトリレコードを送信した後、Azure portalの [Application Insights ログ] タブに移動し、到着した場合はチェックします。サンプルテレメトリレコードが表示されている場合、処理パイプラインの大部分は削除されます。

正しく保存され、表示されるサンプルテレメトリレコードは、次のことを意味します。

ローカルサーバーまたは VM には、正しい IP アドレスに解決される DNS があります。
ネットワークは、サンプルをブロックまたは削除せずにインジェストエンドポイントに配信しました。
インジェストエンドポイントはサンプルペイロードを受け入れ、インジェストパイプラインを介して処理しました。
Log Analytics によってサンプルレコードが正しく保存されました。
[Azure portal ログ] タブでは、API (api.applicationinsights.io) に対してクエリを実行し、Azure portalでサンプルレコードをレンダリングできます。

生成されたサンプルレコードが Application Insights インスタンスに到着し、[ ログ] リソース メニューを使用してサンプルレコードのクエリを実行できる場合は、Application Insights SDK またはエージェントのトラブルシューティングを行います。その後、SDK ログ、自己診断ログ、またはプロファイラートレースの収集を続行できます。SDK またはエージェントのバージョンに適した方です。

次のセクションでは、PowerShell または curl を使用してサンプルテレメトリレコードを送信する方法について説明します。

可用性テスト結果を送信する PowerShell スクリプト

可用性テストの結果は、テストに最適なテレメトリの種類です。その理由は、インジェストパイプラインが可用性テストの結果をサンプリングしないということです。要求テレメトリレコードを送信すると、インジェストサンプリングを有効にしたときにサンプリングされる可能性があります。サンプルの可用性テスト結果から始めて、必要に応じて他のテレメトリの種類を試してください。

可用性テスト結果を送信するサンプル PowerShell スクリプトを次に示します。

# Info: Provide either the connection string or ikey for your Application Insights resource
$ConnectionString = ""
$InstrumentationKey = ""
function ParseConnectionString {
param ([string]$ConnectionString)
  $Map = @{}
  foreach ($Part in $ConnectionString.Split(";")) {
     $KeyValue = $Part.Split("=")
     $Map.Add($KeyValue[0], $KeyValue[1])
  }
  return $Map
}
# If ikey is the only parameter supplied, we'll send telemetry to the global ingestion endpoint instead of regional endpoint found in connection strings
If (($InstrumentationKey) -and ("" -eq $ConnectionString)) {
$ConnectionString = "InstrumentationKey=$InstrumentationKey;IngestionEndpoint=https://dc.services.visualstudio.com/"
}
$map = ParseConnectionString($ConnectionString)
$url = $map["IngestionEndpoint"] + "v2/track"
$ikey = $map["InstrumentationKey"]
$lmUrl = $map["LiveEndpoint"]
$time = (Get-Date).ToUniversalTime().ToString("o")
$availabilityData = @"
{
  "data": {
        "baseData": {
            "ver": 2,
            "id": "SampleRunId",
            "name": "Microsoft Support Sample Webtest Result",
            "duration": "00.00:00:10",
            "success": true,
            "runLocation": "Region Name",
            "message": "Sample Webtest Result",
            "properties": {
                "Sample Property": "Sample Value"
                }
        },
        "baseType": "AvailabilityData"
  },
  "ver": 1,
  "name": "Microsoft.ApplicationInsights.Metric",
  "time": "$time",
  "sampleRate": 100,
  "iKey": "$ikey",
  "flags": 0
}
"@
# Uncomment one or more of the following lines to test client TLS/SSL protocols other than the machine default option
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::SSL3
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS11
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS12
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS13
$ProgressPreference = "SilentlyContinue"
Invoke-WebRequest -Uri $url -Method POST -Body $availabilityData -UseBasicParsing

このスクリプトは、単一の可用性テスト結果を Application Insights コンポーネントに配信する生の REST 要求を構築します。このスクリプトを使用する場合は、または $InstrumentationKey パラメーターを$ConnectionString指定します。

接続文字列パラメーターのみが指定されている場合、テレメトリは接続文字列のリージョンエンドポイントに送信されます。
インストルメンテーションキー (ikey) パラメーターのみが指定されている場合、テレメトリはグローバルインジェストエンドポイントに送信されます。
接続文字列パラメーターと ikey パラメーターの両方が指定されている場合、スクリプトは接続文字列のリージョンエンドポイントにテレメトリを送信します。

注:

アプリケーションによって行われた接続をテストします。 Azure portalで Application Insights を有効にした場合、リージョンエンドポイントを持つ接続文字列に依存している可能性がありますhttps://<region>.in.applicationinsights.azure.com。 SDK 構成で ikey のみが提供されている場合は、グローバルエンドポイント https://dc.applicationinsights.azure.comであるに依存します。接続文字列または ikey を指定して、Web アプリケーション SDK の構成に一致するスクリプトパラメーターを設定してください。
2025 年 3 月 31 日、インストルメンテーションキーインジェストのサポートは終了します。インストルメンテーションキーインジェストは引き続き機能しますが、この機能の更新プログラムやサポートは提供されなくなります。新しい機能を利用するために接続文字列に移行します。

このスクリプトは、IaaS または Azure 仮想マシンスケールセットインスタンス上の PowerShell ISE 環境から実行するのが最も簡単です。スクリプトをコピーして、App Service Kudu インターフェイスの PowerShell デバッグコンソールに貼り付けて実行することもできます。

スクリプトが実行されたら、HTTP 200 応答を探し、応答の詳細を確認します。応答 JSON ペイロードの一部として、次の詳細が必要です。

カウントは itemsReceived と itemsAccepted一致します。
インジェストエンドポイントは、1 つのテレメトリレコードを送信し、1 つのテレメトリレコードを受け入れたことをクライアントに通知します。

例として、次のスクリーンショットを参照してください。

受信したアイテムと受け入れられたアイテムの量を示すコード。

Curl コマンドを使用して可用性テスト結果を送信する

Linux VM を実行している場合は、PowerShell の代わりに curl を使用して、同様の REST 要求を送信します。 インジェストエンドポイントのホスト名、値、および値をiKey調整するtime必要があります。 Application Insights インジェストエンドポイントでは、48 時間を超えるレコードは受け入れられません。

1 つの可用性テスト結果を送信する curl コマンドの例を次に示します。

Linux/MacOS の Curl コマンド:

curl -H "Content-Type: application/json" -X POST -d '{"data":{"baseData":{"ver":2,"id":"SampleRunId","name":"MicrosoftSupportSampleWebtestResultUsingCurl","duration":"00.00:00:10","success":true,"runLocation":"RegionName","message":"SampleWebtestResult","properties":{"SampleProperty":"SampleValue"}},"baseType":"AvailabilityData"},"ver":1,"name":"Microsoft.ApplicationInsights.Metric","time":"2022-09-01T12:00:00.0000000Z","sampleRate":100,"iKey":"########-####-####-####-############","flags":0}' https://dc.applicationinsights.azure.com/v2.1/track

Windows の Curl コマンド:

curl -H "Content-Type: application/json" -X POST -d {\"data\":{\"baseData\":{\"ver\":2,\"id\":\"SampleRunId\",\"name\":\"MicrosoftSupportSampleWebtestResultUsingCurl\",\"duration\":\"00.00:00:10\",\"success\":true,\"runLocation\":\"RegionName\",\"message\":\"SampleWebtestResult\",\"properties\":{\"SampleProperty\":\"SampleValue\"}},\"baseType\":\"AvailabilityData\"},\"ver\":1,\"name\":\"Microsoft.ApplicationInsights.Metric\",\"time\":\"2021-10-05T22:00:00.0000000Z\",\"sampleRate\":100,\"iKey\":\"########-####-####-####-############\",\"flags\":0} https://dc.applicationinsights.azure.com/v2/track

要求テレメトリレコードを送信する PowerShell スクリプト

不足している要求テレメトリのトラブルシューティングを行うには、次の PowerShell スクリプトを使用して、1 つの要求テレメトリレコードの送信をテストします。このテレメトリの種類は、サーバー側のインジェストサンプリング構成の影響を受けやすいです。インジェストサンプリングがオフになっていることを確認して、テストレコードが正しく保存されているかどうかを確認します。

# Info: Provide either the connection string or ikey for your Application Insights resource
$ConnectionString = ""
$InstrumentationKey = ""
function ParseConnectionString {
param ([string]$ConnectionString)
  $Map = @{}
  foreach ($Part in $ConnectionString.Split(";")) {
     $KeyValue = $Part.Split("=")
     $Map.Add($KeyValue[0], $KeyValue[1])
  }
  return $Map
}
# If ikey is the only parameter supplied, we'll send telemetry to the global ingestion endpoint instead of regional endpoint found in connection strings
If (($InstrumentationKey) -and ("" -eq $ConnectionString)) {
$ConnectionString = "InstrumentationKey=$InstrumentationKey;IngestionEndpoint=https://dc.services.visualstudio.com/"
}
$map = ParseConnectionString($ConnectionString)
$url = $map["IngestionEndpoint"] + "v2/track"
$ikey = $map["InstrumentationKey"]
$lmUrl = $map["LiveEndpoint"]
$time = (Get-Date).ToUniversalTime().ToString("o")
$requestData = @"
{
   "data": {
      "baseType": "RequestData",
      "baseData": {
        "ver": 2,
        "id": "22093920382029384",
        "name": "GET /msftsupport/requestdata/",
        "starttime": "$time",
        "duration": "00:00:01.0000000",
        "success": true,
        "responseCode": "200",
        "url": "https://localhost:8080/requestData/sampleurl",
        "httpMethod": "GET"
       }
   },
   "ver": 1,
   "iKey": "$ikey",
   "name": "Microsoft.ApplicationInsights.Request",
   "time": "$time",
   "sampleRate": 100,
   "flags": 0
}
"@
# Uncomment one or more of the following lines to test client TLS/SSL protocols other than the machine default option
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::SSL3
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS11
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS12
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS13
$ProgressPreference = "SilentlyContinue"
Invoke-WebRequest -Uri $url -Method POST -Body $requestData -UseBasicParsing

SSL または TLS 構成のトラブルシューティング

上記のスクリプトが失敗した場合は、SSL または TLS 構成のトラブルシューティングを行います。ほとんどのインジェストエンドポイントでは、クライアントが TLS 1.2 と特定の暗号スイートを使用する必要があります。この場合、PowerShell が SSL または TLS プロトコルでクライアントとして参加する方法を調整します。クライアント VM とインジェストエンドポイント間の接続の一部としてセキュリティで保護されたチャネルを診断する必要がある場合は、次のスニペットを含めます。

オプション 1: PowerShell がインジェストエンドポイントに接続するために使用する SSL または TLS プロトコルを制御します。

文字を削除して次のいずれかの行のコメントを # 解除し、PowerShell スクリプトのコマンドレットの Invoke-WebRequest 前に追加して、テスト REST 要求で使用されるプロトコルを制御します。

# Uncomment one or more of these lines to test TLS/SSL protocols other than the machine default option
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::SSL3
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS11
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS12
# [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::TLS13

オプション 2: SSL 証明書の検証に関する問題は無視します。

SSL 証明書オフロードに参加するファイアウォールまたはプロキシサーバーがある場合は、コマンドレットの直前に次のスニペットを追加して、SSL 証明書の問題を Invoke-WebRequest 無視します。

# Ignore mismatched SSL certificate
add-type @"
    using System.Net;
    using System.Security.Cryptography.X509Certificates;
    public class TrustAllCertsPolicy : ICertificatePolicy {
        public bool CheckValidationResult(
            ServicePoint srvPoint, X509Certificate certificate,
            WebRequest request, int certificateProblem) {
            return true;
        }
    }
"@
[System.Net.ServicePointManager]::CertificatePolicy = New-Object TrustAllCertsPolicy

アプリケーションが既定でシステムまたはサーバーの既定の TLS 設定に設定されている場合は、Windows マシンのレジストリ内でこれらの既定の設定を変更します。詳細については、「トランスポート層セキュリティ (TLS) レジストリ設定」を参照してください。

.NET アプリケーションで使用される既定の TLS/SSL プロトコルを変更する必要がある場合は、「トランスポート層セキュリティ (TLS) のベストプラクティス」のガイダンスに従って、.NET Framework。

Application Insights SDK またはエージェントのセットアップまたは構成のトラブルシューティング

PowerShell または curl を使用してアプリケーションのホストコンピューターからテレメトリを送信すると、Application Insights SDK またはエージェントのセットアップまたは構成の問題が原因でテレメトリが見つからない可能性があります。アプリケーションホストとプログラミング言語の Application Insights 監視を有効にして、すべての構成またはコードが適切なガイダンスと例に従っていることを確認します。

PowerShell または curl を使用して実行されたテストがインジェストエンドポイントにテレメトリを送信できない場合は、問題の原因となる可能性のあるいくつかの一般的なクライアント側関連の問題を確認します。

ネットワーク上の DNS は、インジェストエンドポイントを正しい IP アドレスに解決できません。
アプリケーションサーバーからインジェストエンドポイントへの TCP 接続は、ファイアウォールまたはゲートウェイデバイスによってブロックされる可能性があります。
SDK が接続するインジェストエンドポイントには TLS 1.2 が必要な場合がありますが、アプリケーションでは既定で TLS 1.0 または TLS 1.1 を使用する場合があります。
プライベートネットワークに影響を与える Azure Monitor Private Linkが複数ある場合があります。これにより、DNS エントリが上書きされ、インジェストエンドポイントが間違ったプライベート IP アドレスに解決される可能性があります。

お問い合わせはこちらから

質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティサポートにお問い合わせください。 Azure フィードバックコミュニティに製品フィードバックを送信することもできます。

Azure Monitor Application Insights でアプリケーション テレメトリが見つからない場合のトラブルシューティング