Java

빠른 설치에서는 Java, Linux, MySQL 에이전트 설치 방법만 다룹니다.
다른 에이전트는 설치하기에서 확인하세요.

지원 환경

Web Application Server (WAS) 뿐 아니라 데몬 및 배치 애플리케이션 등 JVM에서 동작하는 모든 애플리케이션에 적용할 수 있습니다.
Java 1.5 이하는 support@whatap.io로 문의해 주세요.

JVM

Table 1. JVM
지원 범위 환경 OS JVM 버전

Fully Support

Java

JVM이 구동되는 모든 OS

Java6 이상
Java13 이하

Limited Support

Java

JVM이 구동되는 모든 OS

Java 1.5 이하

WAS

Framework / Library

  • Spring Boot Project

  • Netty, Akka HTTP 및 Play Framework 등 비동기 Framework

  • 이외 Java EE Spec을 준수하는 Application Server에서 동작하는 모든 라이브러리

DataSource

  • Generic JDBC (any JDBC compliant driver)

  • DB2 JDBC

  • Derby JDBC

  • H2 JDBC

  • jTDS JDBC

  • MariaDB JDBC

  • Microsoft SQL Server JDBC

  • MySQL mysql-connector-java

  • Oracle ojdbc14, ojdbc5, ojdbc6, ojdbc7, ojdbc8

  • Postgres JDBC

  • Tibero

  • Jedis Redis driver

설정 적용

$WHATAP_HOME/whatap.conf 파일 내용에 라이선스 키와 데이터 수집 서버 주소가 정상적으로 들어가 있는지 확인합니다.
값이 없다면 설치 안내 페이지의 설정값을 복사해 붙여 넣습니다.

whatap.conf
license={라이선스 키}
whatap.server.host={수집서버 IP}
UI를 통해 다운로드한 경우 whatap.conf에 설정값이 들어가 있습니다.
서버에서 직접 다운로드 한 경우 설치 안내 페이지의 라이선스 키와 수집 서버 주소를 별도 입력해야 합니다.

에이전트 적용

적용 대상(WAS, Batch 및 Daemon 과 같은 Java 애플리케이션)에 javagent 옵션으로 whatap agent path를 추가합니다.

JVM_OPTS
-javaagent:/whatap/whatap.agent-#.#.#.jar

다시 시작 후 프로세스 정보에서 설정한 옵션이 보인다면 설정 적용이 완료된 것입니다.

psgrep
Figure 1. ps -ef |grep java

환경별 설정 위치는 설치하기 페이지에서 확인할 수 있습니다.

Tomcat – Linux

catalina.sh 상단에 JAVA_OPTS 을 추가합니다.

catalina.sh
########## 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를 실행합니다.

tomcat win2

Java 탭의 Java Options 란에 Whatap 에이전트를 등록합니다.

-javaagent:<와탭설치경로>/whatap.agent-<version>.jar
tomcat win

startup.bat 파일을 통해 실행

catalina.bat 상단에 JAVA_OPTS를 추가합니다.

catalina.bat
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가 나타나면 에이전트 연결이 완료된 것입니다.