에이전트 기능 제어

자바(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

기본값 true

sigar 라이브러리를 통한 OS 정보 수집을 활성화합니다. sigar 라이브러리를 통해 5초 단위로 수집하는 CPU, Memory, Disk 등의 OS 자원 데이터가 해당합니다. enabled 옵션이 false인 경우 비활성화합니다.
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 등이 텍스트 유형 데이터에 해당합니다.