J-Jobs

FAQ

[Agent] TunA, Scouter 로 Agent 모니터링 하는 방법

  • 2019-04-02 12:53
  • 04-02 12h

[Question]

TunA 또는 Scouter로 Job 실행을 모니터링 하고 싶습니다. 설정 방법을 알려주세요.

[Answer]

  1. 사전에 TunA 또는 Scouter 서버가 실행중에 있어야 합니다.

  2. [Batch Home]/shl/runbatch.sh에 agent 설정을 추가 후 Agent를 기동 또는 재기동 합니다. Agent가 여러 개 있다면 모두 설정해야 합니다.

export ... (기존 설정)
export JAVA_OPTS="$JAVA_OPTS -javaagent:/home/scouter/agent.java/scouter.agent.jar -Dnet_collector_ip=XXX.XXX.XXX.XXX -Dobj_name_auto_pid_enabled=true"

$JAVA_HOME/bin/java ... (기존 설정)
  • javaagent: 이후에는 agent 파일의 절대 경로를 입력합니다.
  • net_collector_ip 이후에는 TunA 또는 Scouter의 서버 IP를 입력합니다. (localhost일 경우 생략)
  • obj_name_auto_pid_enabled=true는 접속되는 Agent의 이름을 PID로 활용한다는 의미입니다. (설정 없으면 hostname 활용)
  1. Agent는 Java 기반으로 동작하므로 TunA 또는 Scouter의 Window > Preferences의 "default JavaEE"는 "java"로 설정합니다.

description

  1. Objects 창에서 접속된 Agent를 우클릭하여 Configuration 창을 연 뒤, 다음을 입력합니다.

description

hook_service_patterns=jjob.ext.batchlet.AbstractClassBatchlet.process
#hook_service_patterns=jjob.core.launcher.impl.JobDaemonTypeLauncherPassiveMode.callJob
  • hook_service_patterns: 모니터링 시작점을 설정하는 것으로, 주석(#)을 이용하여 둘 중에 하나만 활성화 해 주세요. 모두 활성화 하려면 한줄에 컴마(,)를 이용하여 작성하면 됩니다.

    ① : jjob.ext.batchlet.AbstractClassBatchlet.process로 설정하면 Step 단위로 하나의 XLog가 찍힙니다.

    ② : jjob.ext.batchlet.AbstractClassBatchlet.process로 설정하면 Job 단위로 하나의 XLog가 찍힙니다.

  • 그 밖에 hook_method_patterns로 관찰하고자 하는 method 패턴을 입력하여 자세하게 모니터링 할 수도 있습니다. hook_method_patterns에 관한 설정은 TunA 또는 Scouter 가이드를 참고하세요.

  1. J-Jobs Manager에서 Agent를 재기동하여 javaagent 설정이 반영되도록 합니다.

  2. 이제 Job 실행을 하면 XLog에서 호출 결과를 확인할 수 있습니다. 아래 그림은 호출된 예시입니다.

description

  • hook_service_patterns=jjob.ext.batchlet.AbstractClassBatchlet.process (Step 단위) 설정

    ① : 5초 대기하는 Step 1개로 이루어진 Job을 실행한 결과

    ② : 3개의 파티션으로 나누어 각각 10초, 20초, 30초 대기하는 Job을 실행한 결과

    ③ : 5초 대기하는 Step 2개로 이루어진 Job을 실행한 결과

    ④ : 오류가 있는 Step 1개로 이루어진 Job을 실행한 결과