Windows 에서 .NET 추적 관련 문제 해결

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

문제점 해결 단계:

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

   • .NET Core 실행 환경 5.0 이상
2. 에이전트 configuration.yaml 파일에서 추적 기능이 활성화되어 있는지 확인하십시오.
3. 로그 수집기를 사용하거나 수동으로 로그를 수집하여 추적 로그를 수집하십시오.

4. Instana 의 추적 로그를 확인하세요:

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

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

문제점 해결 단계:

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

   • .NET Core 실행 환경 5.0 이상
2. 로그 수집기를 사용하거나 수동으로 로그를 수집하여 이벤트 뷰어 로그를 수집합니다.

3. Instana 의 이벤트 뷰어 로그를 확인하십시오:

   • 로그에 오류나 경고가 표시되는지 확인하십시오. 이벤트에는 문제 진단에 도움이 되는 타임스탬프 및 오류 코드를 비롯한 상세 정보가 포함되어 있습니다.
   • ' InstanaPCP ' 오류가 발생했다는 InstanaPCP.exe 메시지가 표시되면, 이는 이 실패했음을 의미합니다. 그에 앞서 발생한 상황을 확인하고 문제를 더 자세히 조사해 보십시오.
4. 문제가 있는 애플리케이션의 크래시 덤프를 수집하십시오.

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

문제점 해결 단계:

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

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

   • InstanaPCPWindows 에서 작업 관리자를 열고.를 검색하세요.

4. Log Collector를 사용하거나 수동으로 로그를 수집 하여 ‘ Instana ’ 에이전트 로그를 수집하십시오.

   • Instana 에이전트 로그에 다음 줄이 표시되어야 합니다:

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

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

   com.instana.sensor-clr - 1.1.141 |  | Activated Sensor

6. Instana 에이전트가 시작된 후 .NET 프로세스가 실행되었는지 확인하십시오.

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

문제점 해결 단계:

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

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

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

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

   • 로그 수집기(Log Collector)를 사용하거나 수동으로 로그를 수집 하여 이벤트 로그와 시스템 관리자 로그(.NET )를 수집하십시오.
   • 이벤트 로그와 `.NET ` 로그에서 메모리 관련 예외가 있는지 확인하십시오.
   • 해당 문제가 ‘ Instana ’ 계측 기능으로 인해 발생한 것인지 확인하십시오.
   • 추가 분석을 위해 ‘.NET ’ 덤프 파일을 수집하십시오. Go 작업 관리자로 이동하여 해당 프로세스를 마우스 오른쪽 버튼으로 클릭한 다음 덤프 파일을 생성합니다.

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

• Instana UI
• 콘솔

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

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

또는 로그를 수동으로 수집할 수도 있습니다. 다음 단계를 완료하십시오.

1. 디버그 로그 사용:

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

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

      • 시스템 수준에서 다음 환경 변수를 수동으로 설정하십시오:

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

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

        setx INSTANA_NET_LOG_PATH "C:\dc_net_log" /M
        setx INSTANA_NET_LOG_LEVEL "DEBUG" /M
        setx INSTANA_NET_CORE_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. 애플리케이션을 다시 시작하십시오.

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. 응용 프로그램을 약 15분 동안 실행하십시오.

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

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

4. CLR 디버그 로그 수집:

   1. 레지스트리 편집기를 엽니다.
   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