본문으로 건너뛰기

배치 애플리케이션

배치 애플리케이션에서 와탭 에이전트를 적용하는 방법입니다. 배치 애플리케이션은 WAS와는 다르게 애플리케이션이 실행과 중단을 반복하는 특성이 있습니다. 따라서 일반적인 웹 애플리케이션과 다르게 모니터링해야 합니다.

Batch Application

에이전트 다운로드

다음 명령어를 실행해 배치 애플리케이션 모니터링을 위한 에이전트를 다운로드할 수 있습니다.

wget https://api.whatap.io/agent/whatap.agent.batch.tar.gz
배치 에이전트 파일 구성

whatap.agent.batch.tar.gz

whatap.agent-x.y.z.jar: 자바 에이전트

whatap.agent.batch.host-x.y.z.jar: 배치 호스트(Batch Host) - 수집 서버로 데이터 전송

whatap.conf: 배치 호스트(Batch Host) 설정 파일(파일이 없는 경우 새로 생성하여 설정 > 에이전트 설치 메뉴의 license, whatap.server.host 항목을 추가하세요.)

agent/whatap.agent.batch-x.y.z.jar: 배치 에이전트 - 애플리케이션 데이터를 수집하여 배치 호스트로 전송

agent/whatap.conf: 배치 에이전트 설정 파일

에이전트 설정하기

배치 호스트(Batch Host) 설정

license, whatap.server.host 옵션값은 해당 프로젝트의 설정 > 에이전트 설치 메뉴에서 확인할 수 있습니다.

whatap.conf
# default setting
license=
whatap.server.host=

# 스텝을 나누어서 전송
split_trace_enabled=true

# 하나의 트레이스에 표시할 최대 스텝 개수
trace_step_max_count=1024

배치 에이전트 설정

agent/whatap.conf
# default setting
net_udp_listen_ip=0.0.0.0
net_udp_listen_port=6611

# 배치 호스트와 통신 설정
net_udp_listen_ip=0.0.0.0
net_udp_listen_port=6611

# 배치 잡에서 http call 최대 개수
trace_httpc_limit=1000000

# 배치 잡에서 sql 최대 개수
trace_sql_limit=1000000

# 엑티브 스택 표시 여부
active_stack_enabled=true
# 5회 이내
active_stack_time1=5000
# 5회 이후
active_stack_time2=10000
# 최초 스택 시작시간
active_stack_start_wait_time=1000

배치 잡(Batch Job) 실행하기

배치 잡(Batch Job)을 하나의 트랜잭션 관점에서 모니터링해야 합니다. 그래서 와탭의 Java 에이전트는 Job 프로세스를 위한 Job 에이전트와 이 정보를 서버로 중계하기 위한 Host 에이전트로 분리된 두 개의 에이전트를 실행해야 합니다.

배치 호스트(Batch Host) 실행 명령어

Batch Host Agent
java -cp {BATCH_HOST_HOME}/whatap.agent.batch.host-x.y.z.jar:{BATCH_HOST_HOME}/whatap.agent-x.y.z.jar -Dwhatap.name=batch whatap.agent.batch.App
Batch Host Agent, Java 17 or later
java --add-opens=java.base/java.lang=ALL-UNNAMED -cp {BATCH_HOST_HOME}/whatap.agent.batch.host-x.y.z.jar:{BATCH_HOST_HOME}/whatap.agent-x.y.z.jar -Dwhatap.name=batch whatap.agent.batch.App

배치 에이전트(Batch Agent) 실행 명령어

Batch Agent
java -javaagent:{BATCH_AGENT_HOME}/whatap.agent.batch-x.y.z.jar -jar {APP_PATH}/batch-application.jar
Batch Agent, Java 17 or later
java -javaagent:{BATCH_AGENT_HOME}/whatap.agent.batch-x.x.x.jar --add-opens=java.base/java.lang=ALL-UNNAMED -jar {APP_PATH}/batch-application.jar
노트

배치 잡(Batch Job) 에이전트와 배치 호스트(Batch Host) 에이전트는 배치 잡(Batch Job)을 수행하는 호스트와 같이 설치 및 실행하세요.

Time Limit 설정

배치 잡(Batch Job) 에이전트와 배치 호스트(Batch Host) 에이전트 사이는 UDP를 이용해 통신합니다.

Batch Job UDP

배치 잡(Batch Job)은 일반적으로 장시간 수행합니다. 수십초가 넘을 수도 있습니다. 따라서 배치 잡(Batch Job) 별로 time_limit의 값은 다를 수 있습니다. 배치 잡(Batch Job)이 실행되는 예상 처리 시간을 time_limit 옵션에 설정하세요.

time_limit=300000
warning_time=70% of time_limit
step_interval=5000

액티브 이퀄라이저 컬러 설정

배치 잡(Batch Job)의 실행 시간이 time_limit의 70%를 지나면 노란색으로 표시하고, time_limit을 초과하면 빨간색으로 표시하도록 다음과 같이 설정하세요.

whatap.conf
## 기대 종료시간의 70%
yellow_time = time_limit * 0.7;
## 기대 종료 시간을 초과
red_time = time_limit;

Batch Job UDP

노트

서버 운영자는 배치 잡(Batch Job)의 지연 여부를 실시간으로 확인하려면 time_limit 값을 적절하게 설정하세요.

액티브 스택 수집 간격 설정

배치 잡(Batch Job) 에이전트는 step_interval 옵션값의 간격으로 액티브 스택을 수집할 수 있습니다.

step_interval=5000

배치 에이전트의 메트릭 지표 수집

대시보드에는 배치 호스트(Batch Host)의 Heap Memory를 수집하고, 배치 애플리케이션의 성능 지표는 메트릭(TagCount: batch_job_counter)으로 수집합니다.

batch_job_counter

  • batch job: pid, hostname, job_name
  • gc: gc_count, gc_time_sum, gc_oldgen_count
  • heap: heap_tot, heap_use, heap_max, heap_pending_final, heap_perm
  • cpu: cputime
  • thread count: thread_total_started, thread_count, thread_daemon, thread_peak_count

다음 단계

  • 오픈 소스 추적

    애플리케이션에서 사용하는 프레임워크나 오픈소스 라이브러리에 따라 에이전트 옵션을 추가해야 할 수 있습니다. 예를 들어, 프레임워크나 오픈소스로 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) 파일에 옵션을 적용해 모니터링을 위한 다양한 기능을 제공합니다. 기본 설정부터 서버 연결 및 데이터 전송 설정, 여러 애플리케이션 서버의 설정 파일 관리 방법, 트랜잭션 추적 등을 포함합니다. 자세한 내용은 다음 문서를 참조하세요.

  • 모니터링 시작하기

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