Azure 애플리케이션 Insights 에이전트 문제 해결(이전의 상태 모니터 v2)

아티클
04/13/2024

이 문서에서는 Application Insights 모니터링을 사용할 때 발생할 수 있는 데이터 수집 문제를 resolve 데 도움이 되는 문제 해결 정보를 제공합니다.

알려진 문제

앱의 bin 디렉터리에서 충돌하는 DLL

이러한 DLL(동적 연결 라이브러리)이 bin 디렉터리에 있는 경우 모니터링이 실패할 수 있습니다.

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 5.1과 함께 PowerShell 7 사용을 참조하세요.

IIS 공유 구성과 충돌

웹 서버 클러스터가 있는 경우 공유 구성을 사용할 수 있습니다. HttpModule은 이 공유 구성에 삽입할 수 없습니다. 각 웹 서버에서 Enable 명령을 실행하여 각 서버의 GAC(전역 어셈블리 캐시)에 DLL을 설치합니다.

사용 명령을 실행한 후 다음 단계를 완료합니다.

공유 구성 디렉터리로 이동하여 applicationHost.config 파일을 찾습니다.

구성의 모듈> 섹션에< 다음 XML 코드를 추가합니다.

<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 구성을 사용할 수 없음

SDK 구성은 버전 1.0의 최종 사용자에게 노출되지 않습니다.

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을 사용하는 방법에 대한 자세한 설명은 Get-ApplicationInsightsMonitoringStatus 참조 를 검토하세요.

실행 중인 프로세스 문제 해결

계측된 컴퓨터의 프로세스를 검사하여 모든 DLL이 로드되고 환경 변수가 설정되어 있는지 확인할 수 있습니다. 모니터링이 작동하는 경우 12개 이상의 DLL을 로드해야 합니다.

Get-ApplicationInsightsMonitoringStatus -InspectProcess 명령을 사용하여 DLL을 검사.
(Get-Process -id <process-identifier>).StartInfo.EnvironmentVariables 명령을 사용하여 환경 변수를 검사. 다음 환경 변수는 작업자 프로세스 또는 .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>