본문으로 건너뛰기

설치 문제 해결

.NET 에이전트 설치 후 예기치 않은 문제가 발생한다면 다음 사항을 확인하고 신속하게 문제를 해결하세요. 계속해서 같은 문제가 발생한다면 support@whatap.io로 문의하세요. 또는 서비스 화면의 오른쪽 위에 고객지원 아이콘 버튼을 선택하면 나타나는 채팅창을 통해서 추가 지원을 받을 수도 있습니다.

노트

메일 또는 채팅창을 통해 문의 시 에이전트의 로그 파일이 필요할 수 있습니다. 에이전트의 로그 파일은 다음 경로에 위치합니다.

  • C:\Program Files\WhaTap .NET\logs
  • C:\ProgramData\WhaTap (이 경로는 없을 수도 있습니다. 이런 경우 무시해도 좋습니다.)

모든 데이터가 수집되지 않는 경우​

모든 위젯에 데이터가 수집되지 않을 경우 다음 사항을 확인해 보세요.

  • 에이전트 설정을 위한 whatap.conf 파일에 프로젝트 액세스 키와 수집 서버 정보가 제대로 입력되었는지 확인하세요.

  • 해당 서버의 방화벽 설정을 확인하세요. 아웃바운드 연결을 위해 6600 포트가 열려있어야 합니다.

히트맵 정보가 수집되지 않는 경우​

사용자의 애플리케이션이 지원 환경을 확인하세요. .NET 애플리케이션 모니터링을 위한 지원 환경은 다음 문서를 참조하세요. 서버의 닷넷 버전이 지원 환경에 해당하더라도 애플리케이션의 버전이 .NET Framework 4.5 이상이 아니면, 모니터링을 위한 데이터 수집이 원활하지 않을 수 있습니다.

지원 범위를 확인하기 어렵거나 지원 대상으로 판별된 경우​

대상 애플리케이션의 web.config 파일을 support@whatap.io로 전달해 문의하세요. 가능하다면 대상 애플리케이션의 프로젝트 파일(.csproj)을 전달해줄 것을 권장합니다.

시스템 환경 변수 확인​

sysdm.cpl 명령을 실행해 시스템 속성 창을 여세요. 고급 > 환경 변수를 클릭해 시스템 환경 변수가 제대로 등록됐는지 확인하세요.

윈도우 시스템 환경 변수

시스템 환경 변수는 에이전트 설치 시 자동 등록합니다. 다음과 같은 내용이 등록됐는지 확인하세요.

  • COR_ENABLE_PROFILING = 1

    CLR 프로파일러를 활성화합니다.

  • COR_PROFILER = {D76F1D76-A9E0-4C87-874F-C0AD93D4229B}

    와탭 CLR 프로파일러를 API에 등록할 때 사용하는 GUID입니다. 고정값입니다.

  • COR_PROFILER_PATH = C:\Program Files\WhaTap .NET\WhaTap.ClrProfiler.dll

    와탭 CLR 프로파일러 DLL의 경로입니다.

  • WHATAP_APP_TYPE = 7

    와탭 서버와 통신하는 에이전트 종류로 고정값입니다.

  • WHATAP_DOTNET_HOME = C:\Program Files\WhaTap .NET

    와탭 프로그램의 홈 경로입니다.

  • WHATAP_DOTNET_TRACE = 1

    모니터링 데이터 수집 기능을 활성화합니다.