Application Insights 代理（以前称为状态监视器 v2）故障排除

项目
06/02/2023

启用监视时，可能会遇到阻止数据收集的问题。本文列出了所有已知问题，并提供了故障排除示例。

已知问题

应用的 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 v5.1 编写和测试的。此模块与 PowerShell 版本 6 或 7 不兼容。我们建议将 PowerShell v5.1 与较新版本一起使用。有关详细信息，请参阅将 PowerShell 7 与 PowerShell 5.1 并排使用。

与 IIS 共享配置冲突

如果拥有 Web 服务器群集，则可能会使用共享配置。 HttpModule 无法注入此共享配置。在每个 Web 服务器上运行 Enable 命令，以将 DLL 安装到每个服务器的 GAC 中。

在运行 Enable 命令后，请完成以下步骤：

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

将以下行添加到配置的模块部分中：

<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 嵌套应用程序

在 1.0 版中，我们不在 IIS 中检测嵌套应用程序。

高级 SDK 配置不可用。

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

疑难解答

PowerShell 故障排除

确定哪些模块可用

可以使用 Get-Module -ListAvailable 命令来确定安装了哪些模块。

将模块导入到当前会话中

如果模块尚未加载到 PowerShell 会话中，你可以使用 Import-Module <path to psd1> 命令手动加载该模块。

Application Insights 代理模块故障排除

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

运行 Get-Command -Module Az.ApplicationMonitor 命令来获取可用命令：

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 命令来显示有关该模块的以下信息：

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

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

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

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

使用 Get-ApplicationInsightsMonitoringStatus -InspectProcess 命令来检查 DLL。
使用 (Get-Process -id {PID}).StartInfo.EnvironmentVariables 命令检查环境变量。以下是在工作进程或 dotnet 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