본문으로 건너뛰기

JAVA 옵션 상세 설명

옵션 상세 설명

옵션명설명기본값
RECEIVER_ADDR수집 서버 주소(empty string)
RECEIVER_RECONNECT_DELAY_TIME수집 서버 재연결 시도 주기(ms)1000
TXN_BUFFER_COUNT트랜잭션 최대 동시 수집 개수200
MTD_STACK_SIZE콜트리(메소드 호출 트리 구조)의 최대 깊이(Depth)256
USE_RUNTIME_REDEFINESocket, File 등 rt.jar 클래스 위빙 여부false
USE_RUNTIME_REDEFINE_HTTP_REMOTEsun/net/www 패키지의 HTTP 클래스 위빙 여부(rt.jar)true
USE_RUNTIME_REDEFINE_FUTURE_ETOE스레드간 Task 연계를 위한 rt.jar 클래스 위빙 여부false
USE_RUNTIME_REDEFINE_VTHREAD_ETOE가상 스레드 연계를 위한 java 내부 패키지 위빙 여부false
REMOVE_JDBC_ADVICEJDBC 클래스 위빙 여부false
REMOVE_JDBC_BIND_ADVICEJDBC bind 수집 메소드 위빙 여부false
DISABLE_SQL_SIDConnection 객체의 SID(Connection 고유 ID) 수집 여부false
USE_ORACLE_RACOracle RAC 구조 사용 시 실제 호스트 수집 여부false
USE_TIBERO_TACTibero TAC 구조 사용 시 실제 호스트 수집 여부false
DISABLE_CLASS_META_CACHINGClass 객체 캐싱 여부. 캐싱하지 않을 시 데이터 수집을 위해 Reflection을 사용한다.false
EXCLUDE_THREAD설정한 스레드에서 발생한 트랜잭션은 수집하지 않는다.(empty string)
DISABLE_EXCLUDE_THREADEXCLUDE_THREAD 옵션 설정을 비활성화 한다.false
EXCLUDE_SERVICE설정한 서비스(트랜잭션명 기준) 트랜잭션은 수집하지 않는다.(empty string)
EXCLUDE_SERVICE_AT_END_TIME설정한 서비스(트랜잭션명 기준) 트랜잭션은 수집하지 않는다. 트랜잭션 종료 시점에 필터링 한다.(empty string)
EXCLUDE_TXCODE설정한 TX_CODE 의 트랜잭션은 수집하지 않는다.(empty string)
EXCLUDE_EXCEPTION예외로 감지하지 않을 예외 클래스를 설정한다.(empty string)
INCLUDE_EXCEPTION예외로 감지할 예외 클래스를 설정한다. 감지된 클래스에 대해 스택트레이스를 수집한다.(empty string)
TXN_ELAPSE_TIME지정한 소요 시간을 초과하는 트랜잭션만 수집한다. (ms)0
CURR_TRACE_TXNstartsWith 연산으로 트랜잭션명을 검사하고 지정한 소요 시간(ms)을 초과하는 트랜잭션의 콜트리만 전송한다.(empty string)
TRX_NAME_TYPE트랜잭션 이름 생성 방식을 설정한다. (0: 요청 url, 1~3: 키 기반)0
TRX_NAME_KEY트랜잭션명에 나타낼 parameter 또는 attribute의 key(name)를 설정한다.(empty string)
TRX_NAME_USE_ENCODING트랜잭션 이름 생성에 인코딩 옵션을 사용할지 여부를 설정한다.false
TRX_NAME_ENCODING_FROM기존의 요청 parameter, session의 인코딩 방식을 입력한다.ISO-8859-1
TRX_NAME_ENCODING_TOTRX_NAME_USE_ENCODING 옵션으로 변환할 인코딩 방식을 입력한다.UTF-8
REQ_SET_ENCODING_TOPOST 요청의 파라미터 중 한글이 깨지는 현상 대응을 위한 옵션으로, Request 객체에 setCharacterEncoding을 호출한다.UTF-8
USE_TRX_NAME_WHEN_LEAVE트랜잭션 종료 시에 트랜잭션 이름을 생성한다.false
ENABLE_TRACE_JSP_CLASSTmax JEUS의 jsp class loader를 통해 jsp 원본 파일 클래스뷰 기능을 지원한다.false
REPLACE_URL_PATTERNS트랜잭션명 치환을 위한 옵션으로, 패턴을 콤마(,)로 구분하여 설정한다.(empty string)
TXN_NAME_SET_INDEXXmSetTxnName 위빙 적용 시, 파라미터 중 설정한 index의 파라미터를 트랜잭션 이름으로 사용한다.0
TXN_NAME_SET_INDEX2XmSetTxnName2 위빙 적용 시, 파라미터 중 설정한 index의 파라미터를 트랜잭션 이름으로 사용한다.0
TXN_NAME_APPEND_INDEXXmSetTxnName 위빙 적용 시, 파라미터 중 설정한 index의 파라미터를 트랜잭션 이름 문자열에 추가한다.0
TRX_LOGIN_TYPE로그인 이름 생성 방식을 설정한다. (0: 미사용, 1: 세션, 2: 쿠키)0
TRX_LOGIN_KEY로그인 이름에 사용할 attribute 또는 cookie의 key(name)를 설정한다.(empty string)
ENABLE_ENCRYPT_LOGIN_NAME로그인 이름을 AES128 알고리즘으로 암호화하여 전송한다.false
TRX_IP_KEYHTTP header에서 목적지 호스트의 IP주소를 가져올 key를 설정한다.(empty string)
TRX_ERR_TYPE에러 트랜잭션 감지 조건을 변경한다.0
TRX_ERR_STATUSHTTP 응답 코드에 따라 에러 트랜잭션으로 감지한다.(empty string)
TRX_ERR_STATUS_TYPETRX_ERR_STATUS 옵션과 함께 사용하며, 에러 감지 시 스레드 덤프 수집 여부를 결정한다.0
DISABLE_WEBIDwebid 생성 여부true
USE_SESSIONID_FOR_WEBIDwebid 생성 시 Session ID를 이용하여 생성한다.false
ENABLE_WEB_ID_WHEN_NO_USERAGENT브라우저 요청이 아닌 경우에도 webid를 생성한다.false
ENABLE_UPDATE_WEBID_COOKIE_TIMECookie에서 webid 사용 시 생존 시간(max age)을 갱신한다.false
TRACE_THREAD_NAME콜트리 최상단에 Thread name 수집 여부false
DISABLE_ROOT_METHOD콜트리 최상단에 트랜잭션 시작점 메소드 미표시 여부false
TRACE_DBPOOL_NAMEDB Pool 이용 시, 콜트리에 Pool 이름 수집 여부true
USE_METHOD_SEQ콜트리를 summary 하지 않고 시계열(time series) 형태로 보여주는 옵션이다.false
METHOD_DEBUG소요 시간이 0초인 메소드도 콜트리에 표시한다.false
MTD_ELAPSE_TIME소요 시간이 설정값 이하인 메소드는 수집하지 않는다.0
MTD_BUFFER_SIZE최대 메소드 개수(최대 콜트리 라인 수)2500
MTD_EXCEPTION_BUFFER_SIZE기본 콜트리 수집 개수 초과 시 exception이 발생한 메소드에 대한 추가 수집 개수100
MTD_STACK_BUFFER_SIZE기본 콜트리 수집 개수 초과 시 exception이 발생하지 않은 메소드에 대한 추가 수집 개수100
MTD_ERROR_LIMIT1초간 누적된 모든 완료 트랜잭션의 exception 정보 최대 전송 개수256
MTD_LIMIT최대 메소드 실행 건수(최대 콜트리 적중 횟수)100000
MTD_PARAM_TRACE메소드의 파라미터 수집 여부false
RMI_GET_PARAMRT_RMI 옵션 활성화 시, Request 객체의 getParameter() 메소드 사용 여부false
ACTIVE_ELAPSE_TIME소요 시간이 설정값 이상인 액티브 트랜잭션 정보만 전송한다.0
ACTIVE_MAX_COUNT최대 액티브 트랜잭션 정보 전송 개수200
RT_RMIRemote Call 데이터 수집 여부true
RT_RMI_VENDORext 기능 사용 시 ext.jar 파일 내의 사용할 패키지를 지정한다.ext
RT_RMI_ELAPSE_TIMERemote Call 의 소요 시간이 설정값 이상인 경우에만 해당 Remote Call 데이터를 전송한다.0
RT_FILE콜트리상 File 입출력 발생 여부 및 파일 경로 표시 여부0x00
RT_SOCKET콜트리상 Socket 입출력 발생 여부 및 파일 경로 표시 여부0x10
USE_MTD_EXTrt.jar로 open 되는 File의 이름 수집 여부false
USE_XRT_HANDLEext의 XM_RT 클래스 가용 여부false
USE_INACTIVE_SOCKET_RT트랜잭션 inactive 상태에서 Socket의 주소를 수집한다.false
USE_TRACE_COLLECTION_LEAKJava Collection의 Memory Leak 추적 기능 활성화 여부false
TRACE_COLLECTION_SIZEJava Collection Leak 수집 최소 크기를 설정한다.1000
TRACE_COLLECTION_STACKTRACE_SIZEJava Collection Leak 경계 수준 설정한다.1000
TRACE_COLLECTION_REPORT_PERIODJava Collection Leak 사용 정보 전송 주기를 설정한다.600000
TRACE_JDBCJDBC 관련 메소드의 콜트리 수집 여부를 지정한다.true
DISABLE_SQLSQL 수행 정보 수집 비활성화false
DISABLE_SQL_BINDSQL 바인드 데이터 수집 비활성화false
DISABLE_SQL_FETCHSQL 패치 데이터 수집 비활성화(ResultSet)false
LIMIT_SQLSQL 최소 수집 길이20
USE_SQL_SEQSQL 수행 순서별로 수집하여 SQL 수행 정보를 summary 하지 않는다.false
SQL_DETAIL_ELAPSE_LIMITSQL 수행 시간이 설정값 미만인 SQL 수행 정보는 수집하지 않는다.0
SQL_CACHE_MAX_COUNTSQL Text Hash 최대 캐싱 개수20000
COMPRESS_SQLSQL Text 압축 여부false
CONVERT_SQL_ASCII_TO_KSC5601SQL Text 및 바인드 데이터를 ISO-8859-1 → KSC5601(EUC-KR)로 변환하여 전송한다.false
CONVERT_SQL_ASCII_TOSQL Text 및 바인드 데이터 인코딩 변환 여부(empty string)
CONVERT_SQL_TEXT_ENCODING_FROMSQL Text 및 바인드 데이터의 인코딩 변환 전 캐릭터셋(empty string)
CONVERT_SQL_TEXT_ENCODING_TOSQL Text 및 바인드 데이터 인코딩 변환 후 캐릭터셋(empty string)
BIND_SIZE바인드 수집 데이터의 버퍼 크기(byte)를 지정한다.2048
MONGO_BIND_SIZEMongoDB에서 문자열 타입 바인드 데이터의 길이 제한을 조정하기 위한 설정이다.1024
BIND_ELAPSE_TIMESQL 수행 시간이 설정값 이상인 경우에만 바인드 데이터를 수집한다.50
ENABLE_ENCRYPT_SQL_BINDSQL 바인드 데이터를 AES128 알고리즘으로 암호화하여 전송한다.false
TRACE_FETCH_METHODSQL Fetch 메소드의 콜트리 수집 여부false
TRACE_MONGO_FETCHMongoDB의 SQL Fetch 메소드의 콜트리 단 수집 여부false
THROW_TXN_FETCH_COUNT트랜잭션 내 SQL Fetch 횟수가 설정값 초과 시 XmFetchWarning 에러를 발생시킨다.0
THROW_SQL_FETCH_COUNTSQL 수행 내 Fetch 횟수가 설정값 초과 시 XmFetchWarning 에러를 발생시킨다.0
THROW_EXCLUDE_SERVICETHROW_TXN_FETCH_COUNT, THROW_SQL_FETCH_COUNT 설정값과 관계없이 정상 처리할 트랜잭션명(empty string)
CONNECTION_LIMIT각 JDBC Connection 클래스에 대한 활성 연결 수(Active Connection)를 제한한다.2000
GET_SID_WHEN_STMTStatement 체의 쿼리 수행(execute) 시점에 SID를 조회(수집)한다.false
GET_SID_WHEN_STMT_LIMITGET_SID_WHEN_STMT 옵션의 적용 제한 시간을 설정한다.600000
CHANGE_DB2_SID_QUERYDB2 Database의 SID를 수집 시 MON_GET_APPLICATION_HANDLE() 함수를 사용하는 쿼리로 변경한다.false
USE_TRACE_ORACLEOracle 연계를 위한 옵션으로, v$session CLIENT_IDENTIFIER 컬럼에 연계 key를 세팅한다.false
USE_TRACE_ORACLE_CLEAR_PINGUSE_TRACE_ORACLE 옵션과 함께 사용하며, SQL 수행 종료 시 연계 key가 세션에 남아있는 것을 방지하도록 ping을 수행한다.false
USE_TRACE_TIBEROTibero 연계를 위한 옵션으로, v$session CLIENT_IDENTIFIER 컬럼에 연계 key를 세팅한다.false
USE_JMXJVM GC 지표 수집 시 JMX API 사용 여부true
TRACE_METHOD_MEMORY메소드별 할당(사용)된 메모리 사용량 수집 여부(KiB)false
TRACE_METHOD_CPUTIME메소드별 CPU 사용 시간 수집 여부(ms)false
TXN_MEMORY트랜잭션에 할당(사용)된 메모리 사용량 수집 여부(KiB)false
TXN_CPU_TIME트랜잭션 CPU 사용 시간 수집 여부(ms)false
TXN_CPU_CORE트랜잭션 CPU 사용률(%) 계산 시 CPU core 수를 반영 여부false
REDIRECT_URLPLC 기능 사용 시, 차단된 트랜잭션들이 redirect 될 url 주소를 설정한다.(empty string)
PLC_MESSAGEPLC 기능 사용 시, REDIRECT_URL이 비어있으면 화면에 출력되는 메시지(empty string)
HOSTNAME_COLLECT_TYPE_PRIORITYhost name 수집 방식을 결정한다.1,2,3
ACTIVE_STACK_MAX_LINEActive 트랜잭션의 스택 트레이스 수집 시 최대 스택 라인 수50
ACTIVE_STACK_INTERVAL_ELAPSEActive 트랜잭션의 스택 트레이스 수집 주기(소요 시간 기준)10
APP_SLEEP트랜잭션 종료 시 설정값 만큼 Thread sleep을 적용한다.(seconds)0
ENABLE_RELOAD_ADVICEadvice 동적 적용 가능 여부true
LOG_ALERTJEUS 서버 로그 기록을 파싱해서 보여주는 옵션이다.(empty string)
RESP_HEADER_TIDHTTP Header에 연동 정보를 저장하여 웹서버 모니터링 연동에 활용한다.false
TRACE_SIMPLE_METHOD짧은 메소드도 위빙한다.false
MTD_MAX_SIZE메소드 용량이 설정값을 초과하는 메소드는 위빙하지 않는다.60
USE_METHOD_LISTJVM에 로드된 클래스의 메소드 리스트 수집 여부true
USE_JAR_LISTJVM에 로드된 jar 리스트 수집 여부true
LOG_PATH로그 파일 생성 경로log
LOG_MAX_COUNT에이전트의 ID에 해당하는 로그 파일을 설정값만큼 남기고 삭제한다.-1
EXEM_RUN_ON_CONTAINER컨테이너 환경 지원 여부false
EXEM_WID_PATH컨테이너 환경 지원을 위한 key 파일 생성 경로/tmp/exemwid
EXEM_WID_TYPEcontainer key 생성 방식을 결정한다.1
EXEM_GROUP_ID에이전트의 그룹을 설정한다.(empty string)
DEBUG로그 레벨을 지정한다.0x000000000
TXN_SAMPLING_MAX_COUNTCURR_TRACE_TXN 옵션에 의해 제외된 트랜잭션 중 일부를 샘플링하여 콜트리를 전송한다. (1초당 최대 전송 개수)0