본문으로 건너뛰기

Java 1.6 버전 미만

Java 1.6 버전 미만에서 와탭 에이전트를 적용할 수 있습니다. 하지만 일부 기능에 제약이 있습니다.

Java 1.5 버전​

Java 1.5 버전은 -javaagent 옵션을 제공합니다. 다만 외부 스레드의 정보를 조회하는데 제약이 있어 일부 기능에 제약이 있습니다.

다음의 기능들은 동작하지 않습니다.

  • 액티브 트랜잭션에서 실시간 트레이스

  • 스택 분석 (탑 스택, 유니크 스택, 액티브 스택)

  • 스레드 목록의 상세 스택

Java 1.4 버전​

Java 1.4 버전은 -javaagent 옵션이 없습니다. 다른 방식으로 와탭 에이전트를 설치해야 합니다. 물론 whatap.agent.jar 파일은 Java 1.4 버전을 사용해야 합니다.

whatap.java14.tracer-X.Y.Z.jar

boot.jar 생성​

setup.sh 파일을 이용해 boot.jar 파일을 생성하세요. 만약 [JAVA_HOME]을 입력하지 않으면 현재 경로를 JDK의 위치를 자동으로 인식합니다.

$ setup.sh [JAVA_HOME]

setup.sh 실행 결과: whatap.java14.boot-X.Y.Z.jar

bootclasspath에 설치​

bootclasspath 옵션을 사용해 빌드된 jar와 tracer jar를 prepend로 추가하세요.

-Xbootclasspath/p:${WHATAP_HOME}/whatap.java14.boot-1.0.2.jar:${WHATAP_HOME}/whatap.java14.tracer-1.0.2.jar

제약 사항​

jdk 1.4 버전에서는 다음의 기능들이 동작하지 않습니다.

  • 액티브 트랜잭션에서 실시간 트래이스

  • 스택 분석 (탑 스택, 유니크 스택, 액티브 스택)

  • 컴포넌트 버전

  • 스레드 목록, 힙히스토그램

  • 로드된 클래스

  • 오픈 소켓

  • 에이전트 덤프

다음 단계​

  • 오픈 소스 추적

    애플리케이션에서 사용하는 프레임워크나 오픈소스 라이브러리에 따라 에이전트 옵션을 추가해야 할 수 있습니다. 예를 들어, 프레임워크나 오픈소스로 spring-boot-3.x, feign-client-11, okhttp3-4.4 사용 시 다음과 같이 옵션을 설정하세요.

    whatap.conf
    weaving=spring-boot-3.0,feign-11,okhttp3-4.4

    사용자의 애플리케이션 환경에 맞는 프레임워크나 오픈소스 라이브러리를 설정하는 방법은 다음 문서를 참조하세요.

  • 설치 점검하기

    프로젝트 생성 및 에이전트 설치, JVM 옵션까지 모두 적용했다면 다음 문서에서 점검 사항을 확인하세요.

  • 설치 문제 해결

    에이전트 설치 시 발생할 수 있는 다양한 문제들과 이를 해결하기 위한 구체적인 지침을 제공합니다. 방화벽 설정, SpringBoot 및 Tomcat JMX 설정, OSGI 프레임워크 사용 서버 설정 등 다양한 상황에 대한 해결책을 안내합니다. 자세한 내용은 다음 문서를 참조하세요.

  • 에이전트 설정

    에이전트 설정(whatap.conf) 파일에 옵션을 적용해 모니터링을 위한 다양한 기능을 제공합니다. 기본 설정부터 서버 연결 및 데이터 전송 설정, 여러 애플리케이션 서버의 설정 파일 관리 방법, 트랜잭션 추적 등을 포함합니다. 자세한 내용은 다음 문서를 참조하세요.

  • 모니터링 시작하기

    모든 설정을 완료한 다음 애플리케이션 서버를 다시 시작하세요. 에이전트가 정보를 수집하기 시작합니다. 먼저 애플리케이션 대시보드 메뉴에서 모니터링 데이터가 수집되는지 확인하세요. 애플리케이션 대시보드에 대한 자세한 내용은 다음 문서를 참조하세요.