排查 Azure Monitor Application Insights 中缺少的应用程序遥测问题

项目
06/24/2024

本文介绍如何使用 PowerShell 或 curl 测试连接和遥测引入，从而确定处理管道中导致遥测丢失的步骤。

可能导致遥测丢失的步骤

下图显示了在引入和使用过程中可能会丢失遥测数据的步骤：

遥测在处理管道中传递的步骤。

如果Azure 门户中未显示应用程序遥测，则处理管道中跨步骤失败可能是原因：

Application Insights SDK 或代理配置错误，不会将应用程序遥测数据发送到引入终结点。
SDK 或代理配置正确，但网络会阻止对引入终结点的调用。
引入终结点会删除或限制入站遥测数据。
由于服务运行状况，引入管道在处理遥测过程中会下降或严重减慢。
(不常见的) Log Analytics 在保存遥测记录时面临服务运行状况问题。
(不常见) 查询 API 在 api.applicationinsights.io 从 Log Analytics 查询记录时失败。
Azure 门户无法拉取或呈现您尝试查看的记录。

通过发送示例遥测记录来识别步骤

配置问题或暂时性问题可能发生在 Application Insights 服务的任意位置。若要确定处理管道中导致无数据或缺少数据症状的步骤，请使用 PowerShell 或 curl 发送示例遥测记录。对于 PowerShell 脚本或 curl 命令，请转到以下部分：

用于发送可用性测试结果的 PowerShell 脚本
用于发送可用性测试结果的 Curl 命令
用于发送请求遥测记录的 PowerShell 脚本

如果 Web 应用在本地服务器或 Azure VM 上运行，请连接到服务器或 VM，并使用 PowerShell 将单个遥测记录发送到 Application Insights 服务实例。如果发送遥测数据时出现问题的 Web 应用在 Kudu 上运行，请从 Azure Web 应用中的 Kudu 的 PowerShell 调试控制台运行以下脚本。

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

注意

在运行 Invoke-WebRequest cmdlet 之前，请发出 $ProgressPreference = "SilentlyContinue" cmdlet。
不能使用 -Verbose 或 -Debug。请改用 -UseBasicParsing。

使用 PowerShell 发送示例遥测记录后，导航到Azure 门户中的“Application Insights 日志”选项卡，如果到达，检查。如果显示示例遥测记录，则会消除大部分处理管道。

正确保存并显示的示例遥测记录意味着：

本地服务器或 VM 具有解析为正确 IP 地址的 DNS。
网络在没有阻止或删除的情况下将示例传送到引入终结点。
引入终结点接受示例有效负载并通过引入管道进行处理。
Log Analytics 正确保存了示例记录。
“Azure 门户日志”选项卡能够查询 API (api.applicationinsights.io) 并在Azure 门户中呈现示例记录。

如果生成的示例记录到达 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

此脚本生成原始 REST 请求，以将单个可用性测试结果传递给 Application Insights 组件。使用此脚本时，请提供 $ConnectionString 或 $InstrumentationKey 参数。

如果仅提供连接字符串参数，则遥测数据将发送到连接字符串中的区域终结点。
如果仅提供检测密钥 (ikey) 参数，则遥测数据将发送到全局引入终结点。
如果同时提供了连接字符串和 ikey 参数，脚本会将遥测数据发送到连接字符串中的区域终结点。

注意

测试应用程序建立的连接。如果在 Azure 门户中启用 Application Insights，则可能依赖于具有区域终结点的https://<region>.in.applicationinsights.azure.com连接字符串。如果 SDK 配置仅提供 ikey，则依赖于全局终结点 https://dc.applicationinsights.azure.com。请确保填充与 Web 应用程序 SDK 配置匹配的脚本参数，提供连接字符串或 ikey。
2025 年 3 月 31 日，将结束对检测密钥引入的支持。检测密钥引入将继续有效，但我们将不再提供该功能的更新或支持。转换为连接字符串以利用新功能。

最简单的方法是在 IaaS 或 Azure 虚拟机规模集实例上从 PowerShell ISE 环境运行此脚本。还可以将脚本复制并粘贴到 App 服务 Kudu 接口 PowerShell 调试控制台中，然后运行它。

执行脚本时，查找 HTTP 200 响应并查看响应详细信息。作为响应 JSON 有效负载的一部分，需要以下详细信息：

计数 itemsReceived 与匹配 itemsAccepted。
引入终结点通知客户端：你发送了一条遥测记录，我们接受了一条遥测记录。

请参阅以下屏幕截图作为示例：

显示收到的项数和已接受项数的代码。

用于发送可用性测试结果的 Curl 命令

如果运行的是 Linux VM，请使用 curl 而不是 PowerShell 发送类似的 REST 请求。需要调整 引入终结点主机名、 iKey 值和 time 值。 Application Insights 引入终结点不接受任何超过 48 小时的记录。

下面是发送单个可用性测试结果的示例 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 脚本测试发送单个请求遥测记录。此遥测类型容易受到服务器端引入采样配置的影响。验证引入采样是否已关闭，以确认测试记录是否已正确保存。

# 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 脚本中的 cmdlet 之前 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 证书问题，方法是在 cmdlet 前面 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 协议，请使用 .NET Framework 遵循传输层安全性 (TLS) 最佳做法中的指导。

排查 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 专用链接影响专用网络，这可能会覆盖 DNS 条目，以将引入终结点解析为错误的专用 IP 地址。

联系我们寻求帮助

如果你有任何疑问或需要帮助，请创建支持请求或联系 Azure 社区支持。还可以向 Azure 反馈社区提交产品反馈。

通过