에이전트 기능 제어

자바(Java) 애플리케이션 서버의 모니터링을 위한 에이전트 기능을 세밀하게 조정하는 방법을 안내합니다. 에이전트의 활성화/비활성화, 트랜잭션 및 성능 카운터 추적, OS 정보 수집 등의 기능을 포함하며, 각 기능을 제어하는 다양한 설정 옵션들에 대해 확인할 수 있습니다.

• shutdown Boolean

  기본값 false

  true인 경우 에이전트의 모든 동작을 중지하고 서버와의 연결을 종료합니다.

• enabled Boolean

  기본값 true

  전체 기능을 활성화합니다. false인 경우에도 서버와 최소한의 통신을 유지하기 위한 정보는 전송됩니다.

• transaction_enabled Boolean

  기본값 true

  트랜잭션 추적 기능을 활성화합니다. 히트맵에 기록되는 트랜잭션 정보가 해당합니다. enabled 옵션이 false인 경우 비활성화합니다.

• counter_enabled Boolean

  기본값 true

  성능 카운터 추적 기능을 활성화합니다. 액티브 트랜잭션 수 및 사용자 수, JVM 자원 사용량, Process CPU 사용량, DB Pool 사용량 정보 등이 해당합니다. enabled 옵션이 false인 경우 비활성화합니다.

• stat_enabled Boolean

  기본값 true

  통계 정보 추적 기능을 활성화합니다. 5분 단위로 수집하는 트랜잭션, SQL, HTTPCALL, UserAgent, Client IP 등의 통계 데이터 등이 해당합니다. enabled 옵션이 false인 경우 비활성화합니다.

• sigar_enabled Boolean

  기본값 false

  sigar 라이브러리를 통한 OS 정보 수집을 활성화합니다. sigar 라이브러리를 통해 5초 단위로 수집하는 CPU, Memory, Disk 등의 OS 자원 데이터가 해당합니다. enabled 옵션이 false인 경우 비활성화합니다.

  노트

  • whatap.agent.2.1.0 버전 미만에서 기본값은 true이며, whatap.agent.2.1.0 버전 이상에서는 기본값이 false입니다.

  • Java 1.6 이하 버전 환경에서는 sigar_enabled=true 옵션을 추가하여 sigar 라이브러리를 활성화하고 성능 지표를 수집할 수 있습니다.

• active_stack_enabled Boolean

  기본값 true

  액티브 스택 추적을 활성화합니다. 스택 메뉴의 탑 스택 및 유니크 스택, 액티브 스택이 해당합니다. enabled 또는 counter_enabled 옵션이 false인 경우 비활성화합니다.

• license String

  에이전트 설치 시 서버로부터 부여받은 액세스 키를 입력합니다. 액세스 키에는 에이전트가 속한 프로젝트와 보안 통신을 위한 암호 키를 포함합니다.

• cypher_level aes_bit [128, 256]

  기본값 128

  AES 보안 알고리즘에 대한 암호 레벨을 설정합니다. 256 비트까지 확장할 수 있습니다. AES 256 암호화 설정에 대한 자세한 내용은 다음 문서를 참조하세요.

• encrypt_level encrypt_level [1, 2, 3]

  기본값 2

  와탭 에이전트는 서버로 데이터를 전송할 때 데이터 속성에 따라 선택적으로 암호화합니다. 높은 보안을 유지하면서도 성능상 이점을 가지고 있습니다. 데이터 유형에 상관 없이 일괄적인 암호화 정책을 적용하려면 다음 옵션을 참조하세요.

  • 1: 암호화 전송 기능 사용 안함
  • 2: SQL 파라미터, Plain Text와 같은 민감한 속성에 대한 암호화 전송
  • 3: 모든 항목에 대한 암호화 전송

• stat_ip_enabled Boolean

  기본값 true

  프로젝트의 사이드 메뉴 중 통계 > 클라이언트 IP 메뉴에서 IP 통계 사용 여부를 활성화합니다.

• realtime_user_enabled Boolean

  기본값 true

  프로젝트의 사이드 메뉴 중 대시보드 > 애플리케이션 대시보드 메뉴에서 확인할 수 있는 지표 중 동시접속 사용자 지표 수집 여부를 설정합니다.

• hook_direct_patch_classes ClassFile_FullPath

  직접적으로 특정 클래스를 로딩 타임에 바꿔치기할 때 사용합니다. 클래스를 컴파일한 후에 별도 파일을 만들고 그 파일의 전체 경로를 설정합니다.

• active_stack_second Seconds

  기본값 10

  액티브 스택을 추적하는 간격을 설정합니다.

  주의

  주어진 기본값을 변경하지 않을 것을 권장합니다.

• boot_redefine_size Int

  기본값 100

  에이전트를 Attach 방식 또는 Watcher 방식으로 설치했을 경우 이미 로딩된 클래스의 추적을 위해 BCI를 새로 수행합니다. 이때 동시 redefine하는 클래스의 개수를 설정합니다.

• trace_component_enabled Boolean

  기본값 true

  프로젝트의 사이드 메뉴 중 인스턴스 성능 관리 > 라이브러리 버전 메뉴 기능을 활성화합니다.

• realtime_user_thinktime_max / wclient_thinktime_max MiliSeconds

  기본값 300000

  실시간 브라우저 사용자 수를 측정할 경우 동일 사용자로 인정되는 최대 호출 간격을 설정합니다.

  노트

  Java 에이전트 2.2.0 버전 이상의 경우 wclient_thinktime_max 옵션을 이용하세요.

• time_sync_interval_ms MiliSeconds

  기본값 300000

  에이전트와 서버 간 동기화하는 시간 간격을 설정합니다. 동기화하지 않을 경우 0으로 설정하세요.

• detect_deadlock_enabled Boolean

  기본값 false

  Java 스레드의 교착 상태(DeadLock) 여부를 체크해 감지할 경우 이벤트를 발생합니다. 발생 간격은 5초 단위입니다. 같은 DeadLock 건에 대한 이벤트는 한 시간에 한 번만 발생합니다.

• text_reset Int

  기본값 0

  와탭 에이전트는 한번 보낸 텍스트 유형 데이터를 hash 처리하므로 다음 날까지 다시 전송하지 않습니다. 이전 설정 값과 다른 값을 입력하는 경우 다시 전송합니다.

  노트

  트랜잭션 URL, SQL String 등이 텍스트 유형 데이터에 해당합니다.