IIS에서 ‘.NET Framework ’ 추적 문제 해결

증상: 애플리케이션에서 메트릭은 표시되지만 추적 정보는 표시되지 않거나, 일부 서비스는 보고되지만 다른 서비스는 보고되지 않거나, 배포 또는 업데이트 후 추적이 중단됩니다.

문제점 해결 단계:

1. 해당 애플리케이션의 .NET Framework 버전이 지원되는지 확인하십시오:

   • .NET Framework 4.5.2 또는 그 이후
2. 에이전트 configuration.yaml 파일에서 추적 기능이 활성화되어 있는지 확인하십시오.

3. 다음 방법 중 하나를 사용하여 추적 로그를 수집하십시오:

   • 로그 콜렉터
   • 수동 로그 수집.

4. Instana 의 추적 로그를 확인하고 결과를 분석하십시오:

   • 로그에 내용이 없거나 추적 정보가 보이지 않는다면, 해당 애플리케이션은 스팬을 생성하지 않는 것입니다.
   • 로그에 추적 정보가 있지만 일부 정보(예: 호스트)가 누락된 경우, 이는.NET 의 추적 계층에 문제가 있는 것입니다.
   • 로그에 관련 기록이 있고 UI에는 없는 정보가 포함되어 있다면, 문제는 Instana 백엔드나 에이전트 중 한 곳에서 발생한 것입니다.

증상: Instana 에이전트가 실행 중일 때 애플리케이션이 시작 시 중단됩니다.

문제점 해결 단계:

1. 해당 애플리케이션의 .NET Framework 버전이 지원되는지 확인하십시오:

   • .NET Framework 4.5.2 또는 그 이후

2. 다음 방법 중 하나를 사용하여 이벤트 뷰어 로그를 수집하십시오:

   • 로그 콜렉터
   • 수동 로그 수집.

3. Instana 와 관련된 이벤트 뷰어 항목을 확인합니다:

   • Instana 와 관련된 오류나 경고가 있는지 확인하십시오.
   • 이벤트 항목에는 문제 진단에 도움이 되는 타임스탬프와 오류 코드가 포함되어 있습니다.
   • InstanaPCP.exe오류 메시지에 가 표시되어 있다면, 이는 ‘ InstanaPCP ’ 프로세스가 중단되었음을 의미합니다. 지금까지의 상황을 되짚어 보고 해당 문제를 더 자세히 조사해 보십시오.
4. 해당 애플리케이션의 크래시 덤프를 수집하십시오.

증상: ‘.NET Framework ’ 애플리케이션이 ‘ Instana ’ 에이전트에 의해 모니터링되지 않으며, ‘ Instana ’ UI에 표시되지 않습니다.

문제점 해결 단계:

1. Instana 에이전트가 관리자 권한으로 실행 중인지 확인하십시오.
2. Instana 에이전트가 해당 애플리케이션에 대한 권한을 가지고 있는지 확인하십시오.

3. Instana PCP가 실행 중인지 확인하십시오:

   • InstanaPCPWindows 에서 작업 관리자를 열고.를 검색하세요.
   • Log Collector를 사용하거나 수동으로 로그를 수집 하여 Instana 에이전트 로그를 수집하십시오.

   • Instana 에이전트 로그에 다음 줄이 반드시 포함되어야 합니다:

     com.instana.agent-process-handling - <version> |  | InstanaPCP.exe passed early window; marked RUNNING

4. 에이전트 로그에서 센서가 정상적으로 활성화되었는지 확인하십시오:

   com.instana.sensor-clr - <version> |  | Activated Sensor

5. Instana 에이전트가 시작된 후에 .NET Framework 프로세스가 시작되도록 하십시오.

증상: 추적 기능이 활성화된 후 ‘ InstanaPCP ’ 또는 ‘.NET Framework ’ 애플리케이션에서 비정상적으로 높은 CPU 사용량이 나타납니다.

문제점 해결 단계:

1. 작업 관리자를 확인하여 문제가 해당 애플리케이션과 관련된 것인지, 아니면 InstanaPCP 과 관련된 것인지 확인하십시오.

2. InstanaPCP: 에 문제가 있는 경우

   • InstanaPCP 에 대한 디버그 로그를 활성화합니다. “로그 수집”을 참조하십시오.
   • 성능 카운터 누락이나 예외 발생에 관한 반복적인 메시지가 있는지 로그를 확인하십시오.

3. 문제가 애플리케이션 메모리 급증인 경우:

   • 로그 수집기 (Log Collector)를 사용하거나 수동 로그 수집을 통해 이벤트 로그와 시스템 관리자 로그(.NET )를 수집하십시오.
   • 이벤트 로그와 `.NET ` 로그에서 메모리 관련 예외를 확인하십시오.
   • 해당 문제가 ‘ Instana ’ 계측 기능으로 인해 발생한 것인지 확인하십시오.
   • 추가 분석을 위해.NET 의 덤프 파일을 수집하십시오.

Log Collector는 Instana 에서 로그를 수집하는 독립형 애플리케이션입니다. 다음 위치에서 로그 수집기를 실행할 수 있습니다:

• Instana UI
• 콘솔

로그 수집기는 다음 로그를 수집합니다:

• 애플리케이션 추적 로그
• Instana PCP 로그
• CLR 디버그 로그
• 이벤트 뷰어 로그
• Instana 에이전트 디버그 로그
• Instana 에이전트 추적 로그

또는 IIS에서 호스팅되는 .NET Framework 애플리케이션의 로그를 수동으로 수집할 수도 있습니다. 다음 단계를 완료하십시오.

1. 디버그 로그 사용:

   1. 다음 옵션 중 하나를 사용하여 환경 변수를 추가하십시오:

      참고: 경로가 유효하고, 해당 프로세스나 애플리케이션에서 접근할 수 있으며, 정확한지 확인하십시오.

      • 시스템 수준에서 또는 IIS 애플리케이션 내에서 다음 환경 변수를 수동으로 설정하십시오:

        INSTANA_NET_LOG_PATH: "C:\dc_net_log"
        INSTANA_NET_LOG_LEVEL: DEBUG
        INSTANA_NET_FF_LOG_LEVEL: DEBUG
        INSTANA_NET_PCP_LOG_LEVEL: DEBUG
        INSTANA_TRACER_ENTEREXIT_LOGGING: 1
        INSTANA_EXTENDED_DEBUG: 1

        참고: 에 INSTANA_NET_LOG_PATH 지정된 폴더가 이미 존재하는지 확인하십시오.

      • 관리자 권한으로 명령 프롬프트를 열고 다음 명령을 실행하여 환경 변수를 추가하십시오:

        setx INSTANA_NET_LOG_PATH "C:\dc_net_log" /M
        setx INSTANA_NET_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_FF_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_PCP_LOG_LEVEL "DEBUG" /M
        setx INSTANA_TRACER_ENTEREXIT_LOGGING "1" /M
        setx INSTANA_EXTENDED_DEBUG "1" /M

   2. 다음 ‘ Windows ’ 레지스트리 키를 구성하십시오:

      CLRDebugLog: "_C:\dc_clr_debug_log\clr__"

   3. 변경 사항을 적용하려면 다음 명령을 실행하세요 iisreset :

      iisreset

   4. 애플리케이션을 다시 시작하십시오.

2. Instana 에이전트 로그 수집:

   1. 에이전트를 <instana_install_dir>/bin/stop.sh 중지하거나, 에이전트가 서비스로 실행 중인 경우 해당 서비스를 중지하십시오.

   2. 로그 삭제: 다음 명령을 실행하여 로그 디렉터리의 모든 파일을 삭제하고 새로 시작하세요:

      rm -rf <instana_install_dir>/data/log/*

   3. 로그 수준을 ‘디버그’로 설정: 에이전트 configuration.yaml 파일에서 로그 수준의 심각도를 변경합니다. 자세한 내용은 에이전트 구성 파일 설정을 참조하십시오.
   4. 에이전트를 <instana_install_dir>/bin/start.sh 시작하거나 서비스를 시작합니다.
   5. 문제 재현 방법: 문제가 발생하도록 한 다음 에이전트를 약 15분 동안 실행합니다.

   6. 로그 수집: 다음 명령을 실행하여 제출할 로그 디렉터리를 압축하십시오:

      cd <instana_install_dir>/data/logs
      zip -r instana_agent_debug_logs.zip *

3. Instana 추적 로그 수집:

   1. com.instana.agent.main.sender.File.cfgGo...로 [agent-dir]\etc\instana 이동하여 파일을 엽니다.

   2. 파일에 다음 줄을 추가하세요:

      prefix=instanaTraces
      type=traces

      이 구성은 접두사가 instanaTraces 붙은 [agent-dir]/data/log 모든 추적 정보를 포함하는 로그 파일을 제공합니다.

   3. Instana 에이전트를 다시 시작하십시오.

   4. 변경 사항을 적용하려면 다음 명령을 실행하세요 iisreset :

      iisreset

   5. 응용 프로그램을 다시 시작한 후 약 15분 동안 실행하십시오.

   6. 다음 경로에서 로그를 수집하십시오:

      • 변수에 지정된 경로 INSTANA_NET_LOG_PATH
      • instana-agent-installation-folder/data/log

4. CLR 디버그 로그 수집:

   1. Windows 의 레지스트리 편집기를 엽니다.
   2. Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Instana\(으)로 이동
   3. 레지스트리 키를 CLRDebugLog 값이 지정된 문자열로 추가합니다. 예를 들어, C:\temp\clr_.

   4. 또는 관리자 권한으로 명령 프롬프트를 열고 다음 명령을 실행하십시오:

      reg add "HKLM\SOFTWARE\Instana" /v CLRDebugLog /t REG_SZ /d "C:\temp\clr_" /f

5. Windows 의 이벤트 뷰어 로그 수집:

   1. 이벤트 뷰어 열기:

      1. Win + R 키를 누르세요.
      2. eventvwr.msc을 입력하십시오.
      3. Enter키를 누릅니다.

   2. Go 내보내려는 로그에:

      • Windows 로그: Windows 로그 > 애플리케이션
      • 애플리케이션 및 서비스 로그
   3. ‘작업’ 패널에서 ‘모든 이벤트 다른 이름으로 저장’을 선택합니다.
   4. .evtx위치를 선택하고.로 저장하세요.