설치 점검 사항
.NET 에이전트 설치 후 문제가 발생한 경우, 상황에 맞는 항목을 확인해 해결할 수 있습니다.
Windows
서비스 동작 확인
WhaTap.NET 서비스가 정상 등록되어 있고, 동작(실행 중) 상태인지 확인하세요.
관리자 권한으로 services.msc 명령을 실행하거나 제어판에서 서비스 아이콘을 두 번 클릭해 Services 관리자를 여세요.
WhaTap .NET 서비스는 수집한 모니터링 데이터를 와탭 서버로 전송합니다. 에이전트 관련 로그는 C:\Program Files\WhaTap .NET\logs와 C:\ProgramData\WhaTap\dotnet\logs 경로에서 확인하세요.
.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명령을 실행해 시스템 속성 창을 여세요. -
고급 > 환경 변수를 클릭해 시스템 환경 변수가 제대로 등록됐는지 확인하세요.
-
시스템 환경 변수는 에이전트 설치 시 자동 등록합니다. 다음과 같은 내용이 등록됐는지 확인하세요.
-
WHATAP_APP_TYPE = 7
와탭 서버와 통신하는 에이전트 종류로 고정값입니다.
-
WHATAP_DOTNET_HOME = C:\Program Files\WhaTap .NET
와탭 프로그램의 홈 경로입니다.
-
WHATAP_DOTNET_TRACE = 1
모니터링 데이터 수집 기능을 활성화합니다.
-
GAC 확인
에이전트 설치 시 DLL 파일이 GAC에 자동 등록됩니다. C:\Windows\Microsoft.NET\assembly\GAC_MSIL 경로에서 등록된 파일을 확인해 주세요.
| 📄 Sigil |
| 📄 Microsoft.Diagnostics.NETCore.Client |
| 📄 Microsoft.Diagnostics.Runtime |
| 📄 System.Diagnostics.DiagnosticSource |
| 📄 System.Memory |
| 📄 Whatap.Startup |
| 📄 Whatap.Loader |
| 📄 Whatap.Tracer |
GAC 수동 삭제
에이전트를 삭제해도 GAC에 등록된 데이터는 자동으로 제거되지 않습니다. 필요한 경우 C:\Windows\Microsoft.NET\assembly\GAC_MSIL 경로에서 직접 삭제해 주세요.
Linux
환경변수 확인
install.sh 설치를 통해 5개의 환경변수가 설정됩니다.
WHATAP_DOTNET_HOME = "/usr/whatap/agent/dotnet"CORECLR_ENABLE_PROFILING = "1"CORECLR_PROFILER = "{21CAE18A-4E44-4578-83FD-0576AAA47E68}"CORECLR_PROFILER_PATH = "/usr/whatap/agent/dotnet/Whatap.ClrProfiler.so"DOTNET_STARTUP_HOOKS = "/usr/whatap/agent/dotnet/Whatap.Startup.dll"
설치 파일 확인
설치 후 /usr/whatap/agent/dotnet 경로에 파일들이 생성됩니다.
| 📄 Whatap.ClrProfiler.so | 네이티브 CLR 프로파일러 |
| 📄 whatap_dotnet | GO 모듈 데몬 실행 파일 |
| 📄 Whatap.Tracer.dll | .NET 트레이서 |
| 📄 Whatap.Loader.dll | .NET 로더 |
| 📄 Whatap.Startup.dll | .NET Startup Hook |
| 📄 whatap.conf | 에이전트 설정 파일 |
| 📄 whatap.env | systemd용 환경변수 파일 |
| 📄 VERSION | 에이전트 버전 명시용 파일 |
| 🗂️ logs/ | 에이전트 로그 디렉토리 |