Java
빠른 설치에서는 Java, Linux, MySQL 에이전트 설치 방법만 다룹니다.
다른 에이전트는 설치하기에서 확인하세요.
지원 환경
Web Application Server (WAS) 뿐 아니라 데몬 및 배치 애플리케이션 등 JVM에서 동작하는 모든 애플리케이션에 적용할 수 있습니다.
Java 1.5 이하는 support@whatap.io로 문의해 주세요.
JVM
지원 범위 | 환경 | OS | JVM 버전 |
---|---|---|---|
Fully Support |
Java |
JVM이 구동되는 모든 OS |
Java6 이상 |
Limited Support |
Java |
JVM이 구동되는 모든 OS |
Java 1.5 이하 |
WAS
-
Tomcat, JBoss, JEUS, WebLogic, WebSphere 등 Java EE Spec을 준수하는 모든 Application Server
https://www.oracle.com/technetwork/java/javaee/overview/compatibility-jsp-136984.html
설정 적용
$WHATAP_HOME/whatap.conf 파일 내용에 라이선스 키와 데이터 수집 서버 주소가 정상적으로 들어가 있는지 확인합니다.
값이 없다면 설치 안내 페이지의 설정값을 복사해 붙여 넣습니다.
license={라이선스 키}
whatap.server.host={수집서버 IP}
UI를 통해 다운로드한 경우 whatap.conf에 설정값이 들어가 있습니다. 서버에서 직접 다운로드 한 경우 설치 안내 페이지의 라이선스 키와 수집 서버 주소를 별도 입력해야 합니다. |
에이전트 적용
적용 대상(WAS, Batch 및 Daemon 과 같은 Java 애플리케이션)에 javagent 옵션으로 whatap agent path를 추가합니다.
-javaagent:/whatap/whatap.agent-#.#.#.jar
다시 시작 후 프로세스 정보에서 설정한 옵션이 보인다면 설정 적용이 완료된 것입니다.

환경별 설정 위치는 설치하기 페이지에서 확인할 수 있습니다.
Tomcat – Linux
catalina.sh 상단에 JAVA_OPTS 을 추가합니다.
########## WHATAP ############
WHATAP_HOME=/whatap (1)
WHATAP_JAR=`ls ${WHATAP_HOME}/whatap.agent-*.jar | sort | tail -1`
JAVA_OPTS="${JAVA_OPTS} -javaagent:${WHATAP_JAR} "
########## WHATAP ############
1 | WHATAP_HOME을 지정합니다. |
Tomcat – Windows
Tomcat을 서비스로 설치
프로그램 메뉴에서 Configure Tomcat 또는 톰캣 설치폴더/bin 경로의 tomcat<톰캣버전>w.exe를 실행합니다.

Java 탭의 Java Options 란에 Whatap 에이전트를 등록합니다.
-javaagent:<와탭설치경로>/whatap.agent-<version>.jar

startup.bat 파일을 통해 실행
catalina.bat 상단에 JAVA_OPTS를 추가합니다.
rem ########## WHATAP ############
set WHATAP_HOME=C:\whatap (1)
for /f %%f in ('dir /b /on %WHATAP_HOME%\whatap.agent-*.jar') do set last=%%f
set WHATAP_JAR=%last%
if x%JAVA_OPTS:whatap=%==x%JAVA_OPTS% (
set JAVA_OPTS=%JAVA_OPTS% -javaagent:%WHATAP_HOME%\%WHATAP_JAR%
)
rem ########## WHATAP ############
1 | WHATAP_HOME을 지정합니다. |
설치 점검
애플리케이션 서버(WAS)를 다시 시작합니다.
구동 로그를 확인했을 때 다음과 같은 WhaTap 캐릭터 로그가 보인다면 JAVA_OPTS 설정이 완료된 것입니다.
Nov 16, 2016 3:06:40 AM org.apache.catalina.startup.HostConfig deployDirectory
INFO: Deployment of web application directory /var/lib/tomcat7/webapps/ROOT has finished in 577 ms
Nov 16, 2016 3:06:40 AM org.apache.coyote.AbstractProtocol start
INFO: Starting ProtocolHandler ["http-bio-8080"]
Nov 16, 2016 3:06:40 AM org.apache.catalina.startup.Catalina start
INFO: Server startup in 3984 ms
_ ____ ______
| | /| / / / ___ /_ __/__ ____
| |/ |/ / _ \/ _ `// / / _ `/ _ \
|__/|__/_//_/\_,_//_/ \_,_/ .__/
/_/
Just Tap, Always Monitoring
WhaTap Agent version 0.3.9 20161115
생성한 프로젝트 화면에 Agent가 나타나면 에이전트 연결이 완료된 것입니다.