본문으로 건너뛰기

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

  • 모니터링 시작하기

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

최종 수정: 에