排查 Azure 应用程序 Insights 代理问题（前状态监视器 v2）

项目
07/30/2024

本文提供了故障排除信息，可帮助你解决启用 Microsoft Azure 应用程序 Insights 监视时可能会遇到的数据收集问题。

已知问题

bin 文件夹中的冲突 DLL

如果应用 bin 文件夹中存在这些动态链接库（DLL），监视可能会失败：

Microsoft.ApplicationInsights.dll
Microsoft.AspNet.TelemetryCorrelation.dll
System.Diagnostics.DiagnosticSource.dll

其中一些 DLL 包含在 Visual Studio 默认应用模板中，即使应用不使用它们。可以使用故障排除工具（如以下工具）查看症状行为：

PerfView：

ThreadID="7,500" 
ProcessorNumber="0" 
msg="Found 'System.Diagnostics.DiagnosticSource, Version=4.0.2.1, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' assembly, skipping attaching redfield binaries" 
ExtVer="2.8.13.5972" 
SubscriptionId="" 
AppName="" 
FormattedMessage="Found 'System.Diagnostics.DiagnosticSource, Version=4.0.2.1, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51' assembly, skipping attaching redfield binaries"

IISReset 和应用负载（不含遥测数据）。使用 Sysinternals 进行调查（Handle.exe 和 ListDLLs.exe）：

.\handle64.exe -p w3wp | findstr /I "InstrumentationEngine AI. ApplicationInsights"
E54: File  (R-D)   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Runtime\Microsoft.ApplicationInsights.RedfieldIISModule.dll

.\Listdlls64.exe w3wp | findstr /I "InstrumentationEngine AI ApplicationInsights"
0x0000000009be0000  0x127000  C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\MicrosoftInstrumentationEngine_x64.dll
0x0000000009b90000  0x4f000   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.ExtensionsHost_x64.dll
0x0000000004d20000  0xb2000   C:\Program Files\WindowsPowerShell\Modules\Az.ApplicationMonitor\content\Instrumentation64\Microsoft.ApplicationInsights.Extensions.Base_x64.dll

PowerShell 版本

此产品是使用 PowerShell 版本 5.1 编写和测试的。此模块与 PowerShell 版本 6 或 7 不兼容。建议将 PowerShell 5.1 与较新版本一起使用。有关详细信息，请参阅将 PowerShell 7 与 PowerShell 5.1 并行使用。

IIS 共享配置中的冲突

如果拥有 Web 服务器群集，则可能会使用共享配置。无法将 HTTP 模块注入到此共享配置中。在每个 Web 服务器上运行 Enable 命令，将 DLL 安装到每台服务器的全局程序集缓存（GAC）中。

运行“启用”命令后，请执行以下步骤：

转到共享配置目录并找到 ApplicationHost.config 文件。

将以下 XML 代码添加到 <配置的 modules> 节：

<modules>
    <!-- Registered global managed http module handler. The 'Microsoft.AppInsights.IIS.
    ManagedHttpModuleHelper.dll' must be installed in the GAC before this config is applied. -->
    <add name="ManagedHttpModuleHelper" type="Microsoft.AppInsights.IIS.ManagedHttpModuleHelper.
    ManagedHttpModuleHelper, Microsoft.AppInsights.IIS.ManagedHttpModuleHelper, Version=1.0.0.0, 
    Culture=neutral, PublicKeyToken=31bf3856ad364e35" preCondition="managedHandler,runtimeVersionv4.0" />
</modules>

IIS 嵌套应用程序

在 Application Insights 代理版本 1.0 中，我们不检测 Internet Information Services （IIS）中的嵌套应用程序。

IIS 经典管道模式

如果应用程序池配置为使用经典管道模式，则不会检测托管在应用程序池上的应用程序。

高级 SDK 配置不可用

在 1.0 版中，SDK 配置不向最终用户公开。

PowerShell 疑难解答

确定哪些模块可用

若要确定安装了哪些模块，请运行 Get-Module -ListAvailable cmdlet。

将模块导入到当前会话中

如果模块未加载到 PowerShell 会话中，可以通过运行 Import-Module <path-to-psd1> cmdlet 手动加载它。

Application Insights 代理模块疑难解答

列出 Application Insights 代理模块中可用的 cmdlet

若要查看 Application Insights 代理模块中可用的 cmdlet，请运行 Get-Command -Module Az.ApplicationMonitor cmdlet：

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Cmdlet          Disable-ApplicationInsightsMonitoring              0.4.0      Az.ApplicationMonitor
Cmdlet          Disable-InstrumentationEngine                      0.4.0      Az.ApplicationMonitor
Cmdlet          Enable-ApplicationInsightsMonitoring               0.4.0      Az.ApplicationMonitor
Cmdlet          Enable-InstrumentationEngine                       0.4.0      Az.ApplicationMonitor
Cmdlet          Get-ApplicationInsightsMonitoringConfig            0.4.0      Az.ApplicationMonitor
Cmdlet          Get-ApplicationInsightsMonitoringStatus            0.4.0      Az.ApplicationMonitor
Cmdlet          Set-ApplicationInsightsMonitoringConfig            0.4.0      Az.ApplicationMonitor
Cmdlet          Start-ApplicationInsightsMonitoringTrace           0.4.0      Az.ApplicationMonitor

确定 Application Insights 代理模块的当前版本

Get-ApplicationInsightsMonitoringStatus -PowerShellModule运行 cmdlet 以显示有关该模块的以下信息：

PowerShell 模块版本
Application Insights SDK 版本
PowerShell 模块的文件路径

有关如何使用此 cmdlet 的详细说明，请查看 Get-ApplicationInsightsMonitoringStatus 参考。

对正在运行的进程进行故障排除

可以检查已检测计算机上的进程，以确定是否加载所有 DLL 并设置了环境变量。如果监视正常工作，则至少应加载 12 个 DLL。

Get-ApplicationInsightsMonitoringStatus -InspectProcess运行 cmdlet 以检查 DLL。
(Get-Process -id <process-identifier>).StartInfo.EnvironmentVariables运行 cmdlet 以检查环境变量。在工作进程或 .NET Core 进程中设置以下环境变量：

COR_ENABLE_PROFILING=1
COR_PROFILER={324F817A-7420-4E6D-B3C1-143FBED6D855}
COR_PROFILER_PATH_32=<path-to-MicrosoftInstrumentationEngine_x86.dll>
COR_PROFILER_PATH_64=<path-to-MicrosoftInstrumentationEngine_x64.dll>
MicrosoftInstrumentationEngine_Host={CA487940-57D2-10BF-11B2-A3AD5A13CBC0}
MicrosoftInstrumentationEngine_HostPath_32=<path-to-Microsoft.ApplicationInsights.ExtensionsHost_x86.dll>
MicrosoftInstrumentationEngine_HostPath_64=<path-to-Microsoft.ApplicationInsights.ExtensionsHost_x64.dll>
MicrosoftInstrumentationEngine_ConfigPath32_Private=<path-to-Microsoft.InstrumentationEngine.Extensions.config>
MicrosoftInstrumentationEngine_ConfigPath64_Private=<path-to-Microsoft.InstrumentationEngine.Extensions.config>
MicrosoftAppInsights_ManagedHttpModulePath=<path-to-Microsoft.ApplicationInsights.RedfieldIISModule.dll>
MicrosoftAppInsights_ManagedHttpModuleType=Microsoft.ApplicationInsights.RedfieldIISModule.RedfieldIISModule
ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=Microsoft.ApplicationInsights.StartupBootstrapper
DOTNET_STARTUP_HOOKS=<path-to-Microsoft.ApplicationInsights.StartupHook.dll>