일러두기

각 옵션에서 사용되는 유효한 VALUE를 설명하는 도메인 키워드와 기술방법은 다음과 같다

• “default:”의 의미는 해당 옵션이 설정파일에 기술되지 않았을 경우 제니퍼가 내부에서 사용하는 기본값을 나타낸다.

• 각 옵션 설명의 마지막에 나오는 샘플 설정은 기본값이거나 권장값 혹은 단순 예제이다.

• 옵션에 대한 충분한 지식이 없는 경우에 임의로 변경하는 것을 삼가해야 한다.

제니퍼 에이전트 옵션

agent_fileroot

제니퍼 에이전트가 사용하는 임시 디렉토리를 설정한다. 설정된 값은 존재하고 WRITE가 가능해야 한다.

• default: .

• value: DIRPATH

• agent_fileroot=/jennifer/agent/data

active_graph_interval

제니퍼는 경과 시간에 따라서 액티브 서비스를 4 개의 그룹으로 분리한다. 이를 기초로 액티브 서비스 관련 차트의 각 구간 별 색상을 다르게 줄 수 있다. active_graph_interval에 대해서 콤마를 구분자로 밀리세컨드 단위의 값을 입력한다. 만약 active_graph_interval에 대해서 0,1000,3000,8000을 입력하면 액티브 서비스를 0 ~ 1 초, 1 ~ 3 초, 3 ~ 8 초, 그리고 8 초 이상으로 구분한다는 뜻이다.

• default: 0,1000,3000,8000

• value: MILLISECOND,MILLISECOND,MILLISECOND,MILLISECOND(오름차순 정렬 ,4개 숫자)

• active_graph_interval = 0,1000,3000,8000

active_param_access_method

ACTIVE PARAMETER TRACING에 포함된 클래스에서 대상 메소드의 접근 권한을 지정한다.

• default: public,protected,private,none

• value:(public|protected|private|none){,(public|protected|private|none)}*

• active_param_access_method=public,protected,private,none

active_param_class

ACTIVE PARAMETER TRACING를 위한 대상 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• active_param_class=com.TextA

active_param_ignore_method

ACTIVE PARAMETER TRACING에 포함된 클래스에서 제외할 메소드만을 지정한다.메소드명 혹은 클래스+메소드를 지정할 수 있다.

• default: NONE

• value:(CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• active_param_ignore_method=access;com.Test.save

active_param_ignore_prefix

ACTIVE PARAMETER TRACING에서 제외할 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• active_param_ignore_prefix=com.util;com.jennifersoft.util

active_param_interface

ACTIVE PARAMETER TRACING를 위한 대상 클래스들의 공통 인터페이스 클래스를 지정한다.

• default: NONE

• value:CLASS{;CLASS}*

• active_param_interface=com.ITestClassA;org.ITestClassB

active_param_postfix

ACTIVE PARAMETER TRACING를 위한 대상 클래스들의 공통 POSTFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• active_param_postfix=Adapeter;VO;Action

active_param_prefix

ACTIVE PARAMETER TRACING를 위한 대상 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• active_param_prefix=com;org.apache.common

active_param_super

ACTIVE PARAMETER TRACING를 위한 대상클래스들의 공통 SUPER클래스를 지정한다.

• default: NONE

• value:CLASS{;CLASS}*

• active_param_super=com.TestSuperA;com.TestSuperB

active_param_target_method

ACTIVE PARAMETER TRACING에 포함된 클래스에서 대상 메소드만을 지정한다. 메소드명 혹은 클래스+메소드를 지정할 수 있다.

• default: NONE

• value:(CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• active_param_target_method=access;com.Test.save

active_param_type

ACTIVE PARAMETER TRACING의 대상 메소드 파라미터 타입을 지정한다.

• default: java.lang.String

• value: java.lang.Sring|byte[]

• active_param_type=java.lang.String

agent_boot_class

제니퍼 에이전트 모듈이 초기화 되기 위한 클래스를 지정한다. 이 클래스가 지정되지 않으면 HttpServlet과 같은 서비스 시작 클래스가 호출될 때 초기화 된다.

• default: NONE

• value: CLASS

• agent_boot_class=javax.servlet.GenericServlet

agent_db_enabled

제니퍼 에이전트에서 사용하는 Simple ISAM DB모듈이 포함되어 있다. 이것을 활성화한다.

• default: false

• value: BOOL

• agent_db_enabled = true

agent_db_keep_hours

제니퍼 에이전트 DB(Simple ISAM DB)는 시계열 데이터만을 저장한다. 데이터의 보관 주기를 지정한다.

• default: 24

• value:DATE

• agent_db_keep_hours = 2

agent_db_rootpath

제니퍼 에이전트 DB(Simple ISAM DB)가 사용할 저장 디렉토리를 지정한다.

• default: .

• value: DIRPATH

• agent_db_rootpath =/jennifer/agent/db

agent_fileroot

제니퍼 에이전트는 제니퍼 에이전트를 설치한 운영 체계의 특정 디렉토리에 로딩된 클래스나 성능 데이터를 임시로 저장한다. 이 때 사용하는 디렉토리는 제니퍼 에이전트를 설치한 자바 애플리케이션을 수행한 WORKING_DIRECTORY이다. 이 디렉토리에는 .data와 .class라는 서브디렉토리가 만들어 진다. 제니퍼 에이전트 설정에서 디렉토리를 변경할 수 있다. 설정된 디렉토리는 존재하고 액세스 가능해야 한다. 자바(WAS) 프로세스 런타임에 수정할 수는 있으나 일부 데이터가 (변경순간)일시적으로 손실될 수 있다. 자바(WAS) 프로세스가 실행되기 전에 설정할 것을 권고한다.

• default: .

• value: DIRPATH

• agent_fileroot=/jennifer/agent/data

agent_name

WAS에 설치된 제니퍼 에이전트의 고유한 이름이다. 제니퍼 서버는 해당 이름으로 WAS의 인스턴스를 구분한다. 영어+숫자로 반드시 세자로 등록해야 한다.

• default: NUL

• value: AGENT

• agent_name = W11

agent_tcp_port

제니퍼 서버로부터의 요청을 받아주는 제니퍼 에이전트의 TCP 포트다. 해당 포트를 통하여 SQL, Method, Application, Error 등의 문자열 정보 및 10분 주기의 통계 데이터를 넘겨준다. TCP Socket을 바인딩하므로 물리적인 서버 별로 포트는 고유해야 한다. 해당 포트를 변경하려면 제니퍼 에이전트가 설치된 WAS를 재시작해야 한다.

• default: 7750

• value: PORT

• agent_tcp_port = 7750

alsb_enabled

WebLogic ALSB 추적을 위한 byte code instrumentation을 활성화 한다.

• default: true

• value: BOOL

• alsb_enabled=true

app_bad_responsetime

애플리케이션의 응답시간이 해당 옵션 값 이상을 초과한 경우, 로그 파일에 기록되고 제니퍼 에러에 등록된다. 매우 작은 시간을 지정하면 로그 파일의 크기가 커지고 , 에러 건수가 증가하기 때문에 사이트의 성능 특성을 고려하여 적절하게 지정하도록 한다. 단위는 밀리세컨드이다.

• default: 30000

• value: MILLISECOND

• app_bad_responsetime = 30000

approximate_tpmc_on_this_system

모니터링 대상 서버의 하드웨어의 한개 CPU에 대한(machine TPMC / number of CPU) 알려진 tpmC 값을 지정한다. 이를 통해서 애플리케이션이 사용한 CPU 시간을 tpmC 단위로 환산하여 통계 분석의 애플리케이션 메뉴에서 보여준다. 단 tpmC가 비단 CPU 관점에서만의 단위가 아니기 때문에 그 값이 100% 정확하지는 않다.

• default: 0

• value: MILLISECOND

• approximate_tpmc_on_this_system = 30000

cpu_sum_tpmc = cpu_sum * approximate_tpmc_on_this_system / 60;

class_dump_after_hooking

제니퍼 에이전트는 모든 로딩되는 클래스의 정보를 관리하기 위해 별도의 디렉토리에 보관한다. 이때 제니퍼 로직이 Instrument된 이전의 상태의 클래스로 보관되는데 이 옵션이 true로 설정되면 제니퍼가 추적로직을 삽입한 이후 상태로 보관된다.

• default: false

• value: BOOL

• class_dump_after_hooking = false

connection_trace_class

제니퍼가 인식하지 못하는 JDBC드라이버의 Key커넥션을 등록한다. 제니퍼가 JDBC드라이버를 인식하지 못하면 커넥션 상태(IDLE,ALLOCATED,ACTIVE)가 모니터링 되지 않는다.값이 변경되면 WAS가 재기동 되어야 한다.

• default: NONE

• value: CLASS{;CLASS}*

• connection_trace_class=com.ibm.db2.jcc.b.bb

config_refresh_check_interval

해당 옵션 값 간격으로 제니퍼 에이전트 구성파일의 변경사항을 체크한다. 비동기 처리를 통해서 구성파일을 읽고 변경하므로 성능저하는 없다. 단위는 (ms)이다.

• default: 30000

• value: MILLISECOND

• config_refresh_check_interval = 3000

custom_trace_access_method

METHOD CUSTOM TRACING에 포함된 클래스에서 대상 메소드의 접근 권한을 지정한다.

• default: public,protected,private,none

• value:(public|protected|private|none){,(public|protected|private|none)}*

• custom_trace_access_method=public,protected,private,none

custom_trace_adapter_class_name

METHOD CUSTOM TRACING을 위한 어뎁터 클래스를 지정한다.

• default: NONE

• value: CLASS

• custom_trace_adapter_class_name=jennifer.custom.AdapterCustomError

custom_trace_adapter_class_path

METHOD CUSTOM TRACING을 위한 어뎁터 클래스가 포함된 jar파일 패스를 지정한다

• default: NONE

• value: JARPATH{;JARPATH}*

• custom_trace_adapter_class_path=/jennifer/lwst40.custom.jar

custom_trace_class

METHOD CUSTOM TRACING를 위한 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• custom_trace_class=com.TestClassA;com.TestClassB

custom_trace_hotswap

Custom Trace를 위한 Adapter클래스가 변경 시 리로딩 될지를 선택한다.

• default: true

• value: BOOL

• custom_trace_hotswap = false

custom_trace_ignore_method

METHOD CUSTOM TRACING에 포함된 클래스에서 제외할 메소드만을 지정한다.

• default: NONE

• value:(CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• custom_trace_ignore_method=access;com.Test.save

custom_trace_ignore_prefix

METHOD CUSTOM TRACING에서 제외할 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• custom_trace_ignore_prefix=com.util;com.jennifersoft.util

custom_trace_interface

METHOD CUSTOM TRACING를 위한 대상 클래스들의 공통 인터페이스 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• custom_trace_interface=com.ITestClassA;org.ITestClassB

custom_trace_param_type

METHOD CUSTOM TRACING를 위한 메소드에서 추적하고자 하는 파라미터 타입을 설정한다.객체 타입만 가능하며 기본값은 java.lang.String이다.

• default: java.lang.String

• value: CLASS

• custom_trace_param_type=java.lang.String

단, 모든 파라미터를 추적하고자 하면 “all”로 설정한다.

custom_trace_param_type=all

custom_trace_postfix

METHOD CUSTOM TRACING를 위한 대상 클래스들의 공통 POSTFIX를 지정한다.

• default: NONE

• value: STRING{,STRING}*

• custom_trace_postfix=Adapeter;VO;Action

custom_trace_prefix

METHOD CUSTOM TRACING를 위한 대상 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• custom_trace_prefix=com;org.apache.common

custom_trace_super

METHOD CUSTOM TRACING를 위한 대상클래스들의 공통 SUPER 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• custom_trace_super=com.TestSuperA;com.TestSuperB

custom_trace_target_method

METHOD CUSTOM TRACING에 포함된 클래스에서 대상 메소드만을 지정한다.

• default: NONE

• value:(CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• custom_trace_target_method=access;com.Test.save

dbsession_query

JDBC Connection 연결 상황을 모니터링 할 때, 데이터베이스의 DB 세션 아이디를 추출한다.

• default: NONE

• value: CLASS:SQL{,CLASS:SQL}*

• dbsession_query = oracle.jdbc.driver.PhysicalConnection: select sid from v$session where audsid = (select userenv ('SESSIONID') from dual)

debug_connection_open

DB Connection이 오픈될 때 그 위치를 로깅하도록 설정하는 옵션

• default: false

• value: BOOL

• debug_connection_open = true

debug_vendor_wrap

jdbc_vendor_wrap=true인 경우 Vendor Wrap 기능이 잘 동작하는지를 확인하기 위한 옵션이다.

• default: false

• value: BOOL

• debug_vendor_wrap = true

default_cookie_domain

해당옵션의 설정으로 여러 시스템에 동시에 접속한 고유한 사용자를 같은 사용자로 구분할 수 있다. 예를들어, 아래와 같은 몇개의 사내 시스템을 동시에 접속하여 사용한다고 가정한다.

http://www.jennifersoft.com
http://sales.jennifersoft.com
http://mail.jennifersoft.com

이 사용자를 한명의 동시단말 사용자로 카운팅하려면 해당 옵션에 .jennifersoft.com 으로 설정한다. 해당 옵션 값 맨 앞에 ( “.” )를 반드시 넣어야 한다. 만약 이 옵션을 설정하고 http://192.168.0.1의 IP로 접속하면 해당 사용자는 동시단말 사용자 및 방문자 수로 카운팅되지 않는다.

• default: NONE

• value: STRING

• default_cookie_domain = .jennifersoft.com

dump_http_header_url_prefix

Http Header를 로그 파일에 로깅할 URL의 prefix를 지정한다. 운영부하를 감안해서 사용해야 한다.

• default: NONE

• value: STRING{,STRING}*

• dump_http_header_url_prefix = /biz1/board, /biz2/save

dump_http_hide_all

Http Header나 Parameter를 로깅할 때 값을 모두 감추도록 설정한 것이다.("***"로 표시)

• default: true

• value: BOOL

• dump_http_hide_all = false

dump_http_hide_key

Http Header나 Parameter를 로깅할 때 값을 감출 키를 설정한다. 설정된 키에 대한 값은 "***"로 출력된다.

• default: NONE

• value: STRING{,STRING}*

• dump_http_hide_key = sso, password

dump_http_parameter_url_prefix

Http Request 파라미터를 덤프할 URL의 prefix를 지정한다.

• default: NONE

• value: STRING{,STRING}*

• dump_http_header_parameter_prefix = /biz1/board, /biz2/save

dump_trigger_sleep_interval

액티브서비스 목록이 덤프 최소 간격을 설정한다. 빈번한 액티브서비스 덤프는 시스템에 과부하를 유발한다. 단위는 밀리세컨드이다.

• default: 180000

• value: MILLISECOND

• dump_trigger_sleep_interval = 180000

enable

해당 옵션이 true 인 경우에만 제니퍼가 동작한다. 해당 옵션이 false로 설정된 경우, 애플리케이션에 trace를 하지 않아 제니퍼 서버로 성능 정보를 보내지 않는다. 제니퍼를 설치하지 않는 것과 동일한 효과를 볼 수 있으며, 실시간으로 반영된다.

• default: false

• value: BOOL

• enable = true

enable_active_profile

액티브 서비스 모니터링시 현재 진행중인 프로파일을 보여줄지의 여부를 지정한다.

• default: true

• value: BOOL

• enable_active_profile=true

enable_active_thread_kill

제니퍼 서버의 요청에 의해서 모니터링 대상 자바 애플리케이션의 액티브 쓰레드를 중지할 수 있다. 기본값이 true다. 그러나 일부 WAS에서 액티브 쓰레드를 중지하면 웹 애플리케이션 서버가 재시작하는 현상이 발생하기도 하는데 해당 옵션을 false로 하여 이런 현상을 미연에 방지할 수 있다.

• default: true

• value: BOOL

• enable_active_thread_kill = true

enable_all_request_logging

해당 옵션 값이 true이면 응답 시간과 무관하게 모든 요청을 로그파일에 기록한다. 그러나 모든 요청을 로그 파일에 기록하는 것은 성능 관리 차원에서 권장하지 않는다.

• default: false

• value: BOOL

• enable_all_request_logging = false

enable_auto_callablestatement_close

java.sql.CallableStatement 객체의 close 메소드가 호출되지 않을 경우, 제니퍼 에이전트가 해당 객체를 가비지 컬렉션 시점에 자동으로 close 시킬지의 여부를 지정한다.

• default: false

• value: BOOL

• enable_auto_callablestatement_close=false

enable_auto_connection_close

java.sql.Connection 객체의 close 메소드가 명시적으로 호출되지 않을 경우, 제니퍼 에이전트가 해당 객체를 가비지 컬렉션 시점에 자동으로 close 시킬지의 여부를 지정한다.

• default: false

• value: BOOL

• enable_auto_connection_close = false

enable_auto_preparedstatement_close

java.sql.PreparedStatement 객체의 close 메소드가 호출되지 않을 경우, 제니퍼 에이전트가 해당 객체를 가비지 컬렉션 시점에 자동으로 close 시킬지의 여부를 지정한다.

• default: false

• value: BOOL

• enable_auto_preparedstatement_close = false

enable_auto_resultset_close

java.sql.ResultSet 객체의 close 메소드가 호출되지 않을 경우, 제니퍼 에이전트가 해당 객체를 가비지 컬렉션 시점에 자동으로 close 시킬지의 여부를 지정한다.

• default: false

• value: BOOL

• enable_auto_resultset_close = false

enable_auto_statement_close

java.sql.Statement 객체의 close 메소드가 명시적으로 호출되지 않을 경우, 제니퍼 에이전트가 해당 객체를 가비지 컬렉션 시점에 자동으로 close 시킬지의 여부를 지정한다.

• default: false

• value: BOOL

• enable_auto_statement_close = false

enable_class

제니퍼 에이전트는 모든 로딩되는 클래스의 정보를 관리하기 위해 별도의 디렉토리에 보관한다. 이 기능을 On/Off하기 위해 사용된다.

• default: true

• value: BOOL

• enable_classdump = false

enable_dbstat

WAS쪽 DB세션이 사용한 DB리소스를 추적하고 X-View에 출력한다. 단, DB에 overhead 가 유발될 수 있기 때문에 테스트 목적으로만 사용해야 한다.

• default: false

• value: BOOL

• enable_dbstat = false

enable_dummy_httpsession_trace

모니터링 대상 애플리케이션의 JSP코드에서 명시적으로 session=false를 지정하지 않으면 자동으로 javax.servlet.HttpSession객체가 만들어지는데 경우에 따라서는 불필요한 HttpSession객체의 생성으로 인하여 성능이 저하될 수 있다. 해당 옵션을 true로 설정하면 불필요하게 HttpSession을 만드는 애플리케이션을 추적하여 이를 에러/예외 사항으로 취급한다.

• default: false

• value: BOOL

• enable_dummy_httpsession_trace = false

enable_dump_triggering

자동 서비스덤프 기능을 enable/disable 한다.

• default: false

• value: BOOL

• enable_dump_triggering = true

enable_guid_from_tuid

제니퍼 에이전트는 각 쓰레드마다 TUID를 부여하여 사용하는데, 이를 하나의 트랜잭션 GUID로 설정할지의 여부를 지정한다.

• default: false

• value: BOOL

• enable_guid_from_tuid = true

enable_hooking_boot

Boot Class Path에 설정된 클래스를 추적하기 위해서는 true로 설정한다.

• default: false

• value: BOOL

• enable_hooking_boot = true

enable_jdbc_callablestatement_fullstack_trace

java.sql.CallableStatement 객체에 대한 전체 스택트레이스를 남길지의 여부를 지정한다. enable_jdbc_stack_trace 가 true 인 경우에만 유효하며, LWST Stack Trace 에 비하여 성능저하가 있을 수 있으니 선별적으로 사용할 것을 권장한다.

• default: false

• value: BOOL

• enable_jdbc_callablestatement_fullstack_trace = false

enable_jdbc_callablestatement_trace

java.sql.CallableStatement 객체에 대한 모니터링 여부를 지정한다.

• default: true

• value: BOOL

• enable_jdbc_callablestatement_trace = true

enable_jdbc_connection_fullstack_trace

java.sql.Connection 객체에 대한 전체 스택트레이스를 남길지의 여부를 지정한다. enable_jdbc_stack_trace 가 true 인 경우에만 유효하며, LWST Stack Trace 에 비하여 성능 저하가 있을 수 있으니 선별적으로 사용할 것을 권장한다.

• default: false

• value: BOOL

• enable_jdbc_connection_fullstack_trace = false

enable_jdbc_databasemetadata_trace

java.sql.DatabaseMetaData 객체에 대한 모니터링 여부를 지정한다.

• default: true

• value: BOOL

• enable_jdbc_databasemetadata_trace = true

enable_jdbc_datasource_trace

DataSource를 추적을 on/off한다. 디폴트는 true이다.

• default: true

• value: BOOL

• enable_jdbc_datasource_trace = true

enable_jdbc_oracle_dependency_used

오라클 9i JDBC 드라이버를 사용하면서 JDBC2.0 표준 API 가 아닌 오라클에 종속적인 CLOB/BLOB 형을 애플리케이션에서 사용하면서 아래와 같이 캐스팅을 하면 java.lang.ClassCastException이 발생할 수 있다.

CLOB clob = ((OracleResultSet) rs).getClob(i)

이런 경우, 오라클 10g JDBC 드라이버를 사용하고 애플리케이션 코드를 JDBC 2.0 API에 맞추어 수정할 것을 권장하나 이런 수정이 불가능 하면 해당 옵션을 true 로 지정하여 사용한다.

• default: false

• value: BOOL

• enable_jdbc_oracle_dependency_used = false

enable_jdbc_preparedstatement_fullstack_trace

java.sql.Connection 객체에 대한 전체 스택트레이스를 남길지의 여부를 지정한다. enable_jdbc_stack_trace 가 true 인 경우에만 유효하며, LWST Stack Trace 에 비하여 성능 저하가 있을 수 있으니 선별적으로 사용할 것을 권장한다.

• default: false

• value: BOOL

• enable_jdbc_preparedstatement_fullstack_trace = false

enable_jdbc_preparedstatement_trace

java.sql.PreparedStatement 객체에 대한 모니터링 여부를 지정한다.

• default: true

• value: BOOL

• enable_jdbc_preparedstatement_trace = true

enable_jdbc_resultset_fullstack_trace

jjava.sql.ResultSet 객체에 대한 전체 스택트레이스를 남길 지의 여부를 지정한다. enable_jdbc_stack_trace 가 true 인 경우에만 유효하며, LWST Stack Trace 에 비하여 성능저하가 있을 수 있으니 선별적으로 사용할 것을 권장한다.

• default: false

• value: BOOL

• enable_jdbc_resultset_fullstack_trace = false

enable_jdbc_resultset_trace

java.sql.ResultSet 객체에 대한 모니터링 여부를 지정한다.

• default: true

• value: BOOL

• enable_jdbc_resultset_trace = true

enable_jdbc_sql_trace

JDBC및 SQL에 대한 모니터링 여부를 지정한다.

• default: false

• value: BOOL

• enable_jdbc_sql_trace = true

enable_jdbc_stack_trace

JDBC Connection/Statement/ResultSet등의 JDBC객체의 close 메소드가 명시적으로 호출되지 않았을 때, 해당 JDBC객체가 애플리케이션의 어느 위치에서 생성되었는지를 알려면 스택트레이스가 필요한데 해당 스택트레이스를 남길지의 여부를 지정한다.

• default: true

• value: BOOL

• enable_jdbc_stack_trace = true

enable_jdbc_statement_fullstack_trace

java.sql.Statement 객체에 대한 전체 스택트레이스를 남길지의 여부를 지정한다. enable_jdbc_stack_trace 가 true 인 경우에만 유효하며, LWST Stack Trace 에 비하여 성능저하가 있을 수 있으니 선별적으로 사용할 것을 권장한다.

• default: false

• value: BOOL

• enable_jdbc_statement_fullstack_trace = false

enable_jdbc_statement_trace

java.sql.Statement 객체에 대한 모니터링 여부를 지정한다.

• default: true

• value: BOOL

• enable_jdbc_statement_trace = true

enable_jdbc_trace_parent

본 옵션이 false이면 아래와 같이 프로그램 되어있는 경우 Statement Not Closed 에러가 발생한다.

Statement stmt=...
ResultSet rs = stmt.executeQuery(...);
...
Statment stmt2= rs.getStatement();
rs.close();
stmt2.close();

• default: true

• value: BOOL

• enable_jdbc_trace_parent = true

enable_jdbc_vendor_wrap

제니퍼가 SQL을 포함한 JDBC수행 정보를 수집할 때 기 정의된 Wrapper Class를 사용한다. 그런데 Vendor JDBC Driver 의존적인 Wrapper를 사용하고자 할 때 true로 설정한다.

• default: false

• value: BOOL

• enable_jdbc_vendor_wrap = false

enable_logfile_daily_rotation

해당 옵션이 true 인 경우, 제니퍼 에이전트의 로그파일을 날짜 별로 남기고 형식은 로그 파일명.yyyymmdd 형식으로 남긴다.

• default: false

• value: BOOL

• enable_logfile_daily_rotation = false

enable_long_running_thread_auto_kill

서비스 요청에 따른 쓰레드 경과시간이 지정한 일정 시간을 초과할 경우, 해당 서비스를 자동으로 강제중단 시킬지를 지정한다.

• default: false

• value: BOOL

• enable_long_running_thread_auto_kill = false

enable_non_servlet_thread_jdbc_trace

기본적으로 서블릿이나 JSP 쓰레드에서의 JDBC를 이용한 데이터베이스 작업에서만 JDBC 및 SQL에 대해서 모니터링 한다. 서블릿이나 JSP와 상관이 없는 쓰레드에서 발생하는 JDBC/SQL정보를 추출하려면 해당 옵션을 true로 지정하여 사용한다. EJB CMP 빈의 경우 아직 지원하지 않으므로 이 속성의 값을 false로 지정해야 한다.

• default: false

• value: BOOL

• enable_non_servlet_thread_jdbc_trace = false

enable_oracle_xdb_xmltype_trace

Oracle XDB oracle.xdb.XMLType 사용시 명시적으로 close()를 하지 않을 경우 native memory leak을 야기한다. 명시적으로 close하지 않은 어플리케이션을 추적할 지 결정한다.

• default: true

• value: BOOL

• enable_oracle_xdb_xmltype_trace = true

enable_rollback_uncommited_close

Non-XA JDBC 드라이버를 사용하여 java.sql.Connection 객체의 commit 혹은 rollback 메소드를 호출하여 데이터베이스 트랜잭션을 관리하는 애플리케이션에서 Connection 객체의 setAutoCommit(false)를 호출하고 나서 commit 혹은 rollback 을 호출하지 않을 때 Connection 객체를 커넥션 풀에 반환하면 제니퍼 에이전트가 자동으로 rollback 메소드를 호출해 주는 기능이다. 애플리케이션의 코드에 대단히 종속적인 기능이므로 반드시 검증 후에 사용해야 한다.

• default: false

• value: BOOL

• enable_rollback_uncommited_close = false

enable_sql_error_trace

JDBC API를 이용한 데이터베이스 처리중에 java.sql.SQLException이 발생한 경우에 그 예외를 로그파일에 기록할지의 여부를 지정한다.

• default: false

• value: BOOL

• enable_sql_error_trace = false

enable_web_service_logging

WAS의 애플리케이션 서비스의 성능을 로컬 파일로 로깅한다.일반적으로는 사용되지 않는다.

• default: false

• value: BOOL

• enable_web_service_logging=false

enable_wrap_context_jdbc_trace

제니퍼는 InitialContext로부터 DataSource가 lookup되면 SQL을 추적하지만, 그 외 다른 javax.naming.Context를 구현한 객체에 의한 DataSource lookup을 사용하는 코드에서는 기본 옵션 상태에서 SQL추적이 안된다. 이런 경우에 true로 설정해서 사용한다. EJB 가 초기화될 때 ClassCastException이 발생할 수 있다.

• default: false

• value: BOOL

• enable_wrap_context_jdbc_trace = false

extra_agent_class

제니퍼 에이전트의 모니터링 기능을 확장한 ExtraAgent를 구현한 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• extra_agent_class = jennifer40.TestExtraAgent

extra_agent_classpath

제니퍼 에이전트의 모니터링 기능을 확장한 ExtraAgent를 구현한 클래스를 지정한다.

• default: NONE

• value: JARPATH{;JARPATH}*

• extra_agent_classpath = /jennifer/agent/lwst40.custom.jar

extra_agent_enabled

제니퍼 에이전트의 모니터링 기능을 확장한 ExtraAgent를 활성화한다.

• default: false

• value: BOOL

• extra_agent_enabled = true

extra_agent_hotswap

제니퍼 에이전트에서 ExtraAgent Adapter클래스가 변경 되었을 때 리로딩 될지를 설정한다.

• default: true

• value: BOOL

• extra_agent_hotswap = true

extra_data_interval

ExtraAgent가 호출되는 주기를 지정한다.(Unit: ms)

• default: 1000

• value: MILLISECOND

• extra_data_interval = 1000

extra_data_send_target

ExtraAgent로부터 수집되는 데이터를 보내기 위한 REMON 프로세스의 주소를 지정한다. 이 값이 설정되지 않으면 제니퍼 서버로 바로 전송된다.

• default: NONE

• value: HOST:PORT

• extra_data_send_target = 127.0.0.1:7701

extra_enable

제니퍼 에이전트의 모니터링 기능을 확장한 ExtraAgent컴포넌트를 설정할지의 여부를 지정한다.

• default: false

• value: BOOL

• extra_enable=true

guid_param

로직에서 GUID를 추출하기 위한 클래스메소드를 설정한다.JDBC CONNECTION설정 처럼 파라미터까지 설정해야 한다.

• default: NONE

• value: CLASS_METHOD_PARAM

• guid_param=com.TestAction.process(String)

guid_param_index

guid_param에서 String혹은 byte[]타입이 여러개이면서 첫번째가 아닌 경우 인덱스를 설정한다. ‘0’은 첫번째를 의미한다. 기본값은 -1이다.

• default: -1

• value: INT

• guid_param_index=1

guid_return

로직에서 GUID를 추출하기 위한 클래스메소드를 설정한다. 설정된 메소드의 리턴값이 GUID로 사용된다.

• default: NONE

• value: CLASS_METHOD_PARAM

• guid_return = com.TestAction.process(String)

hook_class_max_size

LWST모듈에서 byte code를 instrument할 수있는 최대 크기를 설정한다. 기본값은 1048576(1mb)이다

• default: 1048576

• value: INT

• hook_class_max_size=1048576

hotfix_disable_thread_active_count

IBM JDK1.3 에서 Thread수가 많은 경우, waiting 이 발생할 수 있다. 해당 옵션을 true로 설정하면 이러한 현상이 발생하지 않는다.

• default: false

• value: BOOL

• hotfix_disable_thread_active_count = false

hotfix_remote_address_for_wmonid

제니퍼는 쿠키를 이용하여 동시단말 사용자 수와 방문자 수를 측정한다. 쿠키를 과도하게 사용하는 시스템에 제니퍼를 설치할 경우 쿠키 Overflow가 발생할 수 있다. 쿠키 Overflow가 발생할 경우 해당 옵션을 true로 설정한다. 동시단말 사용자와 방문자 수를 측정할 수 없으므로 반드시 필요한 경우가 아니면 사용하지 않기를 권장한다.

• default: false

• value: BOOL

• hotfix_remote_address_for_wmonid = false

http_agent_classpath

Http Agent 구현 모듈을 포함한 클래스 패스를 설정한다.

• defult: NONE

• value: JARPATH{;JARPATH}*

• http_agent_classpath = jenniferhttp.jar

http_post_request_tracking_list

HTTP Post방식으로 들어오는 요청은 URL에서 그 값을 볼 수 없다. 해당 옵션에 HTTP request의 key값을 나열해주면 액티브 서비스 목록에 함께 표시된다.

• default: NONE

• value: STRING{,STRING}*

• http_post_request_tracking_list = txid,txid2,txid3

http_service_class

HttpServlet.service(ServletRequest, ServletResponse) 를 재정의한 서블릿 클래스를 등록한다.

• default: NONE

• value: CLASS{;CLASS}*

• http_service_class = mysys.TestServlet

http_service_method

웹 애플리케이션 서비스 시작 메소드를 설정할 때 사용한다. 이값은 http_service_class에 설정된 클래스의 서비스 메소드가 service가 아닌 경우 사용된다.

• default: service

• value: STRING{,STRING}*

• http_service_method=service

ignore_jdbc_trace_url

배치(batch) 업무등과 같이 JDBC추적이 필요하지 않은 애플리케이션을 등록하여 JDBC 추적을 하지 않도록 설정한다. URL이 하나 이상인 경우에는 콤마를 구분자로 구분한다.

• default: NONE

• value: STRING{,STRING}*

• ignore_jdbc_trace_url = /batch.jsp

ignore_rollback_uncommited_error

제니퍼는 Statement.execute()에 대해서 Uncommit/Rollback을 추적하는데, 특정 애플리케이션이 Statement.execute()를 통해서 SELECT를 할 경우, 트랜잭션이 commit/rollback 없이 Connection 을 close 했다는 에러로 등록되는데, 해당 에러를 감지하지 않게하는 설정이다.

• default: false

• value: BOOL

• ignore_rollback_uncommited_error = false

ignore_url

등록된 URL을 추적에서 완전히 제외시킨다. ignore_url_postfix 와 동일한 효과다.

• default: NONE

• value: STRING{,STRING}*

• ignore_url = /board/check.jsp

ignore_url_post_request_parsing_prefixes

HTTP Post 방식의 요청에서 javax.servlet.http.HttpServletRequest 객체의 getInputStream 메소드를 호출하여 로직을 수행하는 경우에, http_post_request_tracking_list 혹은 url_additional_request_keys 옵션을 사용하면 getInputStream 메소드가 null 을 반환하여 애플리케이션이 정상적으로 동작하지 않을 수 있다. 이를 방지하기 위해서 getInputStream 메소드를 호출하는 URL의 prefix 를 등록한다.

• default: NONE

• value: STRING{,STRING}*

• ignore_url_post_request_parsing_prefixes = /kesa.web,/insa/x_servlet

ignore_url_postfix

이미지와 같은 정적 컨텐츠를 웹 애플리케이션 서버가 직접 서비스하는 경우에 컨텐츠에 대한 모니터링을 하지 않으려면 해당 옵션에 정적 컨텐츠의 (“.”) 와 확장자를 포함하여 등록한다. 두 개 이상인 경우 공백(space)나 콤마(,)를 구분자로 입력한다.

• default: NONE

• value: STRING{[ ‘ ‘|,]STRING}*

• ignore_url_postfix = .gif .GIF .jpg .JPG .zip .html .HTML .txt .css .js .swf .htc .HTC .png .PNG

ignore_url_prefix

모니터링에서 무시해야하는 URL이 여러개인 경우 그것을 prefix로 설정할 수있다.

• default: NONE

• value: STRING{,STRING}*

• ignore_url_prefix=/admin, /console

is_all_request_logging

서비스 트랜잭션 성능 데이터를 제니퍼 로그 파일로 로깅하도록 설정한다.

• default: false

• value: BOOL

• is_all_request_logging=false

jdbc_connection_close

JDBC Connection Pool을 자체 제작하였거나, Connection Pool을 Wrapping 하는 경우에 JDBC Connection을 반환하는 부분을 설정한다.

1. 패키지.클래스명.메소드명은 반드시 full package명이 기술되어야 한다.

2. 메소드의 파라미터중에 java.sql.Connection 이 반드시 포함되어 있어야 한다.

3. jdbc_connection_get 과 반드시 쌍으로 존재할 필요는 없다. conn.close() 형태로 pool로 반환한다면 해당 옵션이 필요없다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• jdbc_connection_close = oracle.apps.fnd.common.Context.releaseJDBCConnection(Connection,String)

jdbc_connection_get

JDBC Connection Pool을 자체 제작하였거나, Connection Pool을 Wrapping 하는 경우에 JDBC Connection을 얻어오는 부분을 설정한다.

1. 패키지.클래스명.메소드명은 반드시 full package명이 기술되어야 한다.

2. 메소드의 return type이 반드시 java.sql.Connection 이어야 한다.

3. 메소드의 파라미터도 기술되어야 한다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• jdbc_connection_get = db.DBConnectionManager.getConnection(String)

jdbc_connection_justget

Connection반환을 추적할 수 없는 경우에 Connection획득부분만 이 옵션에 설정한다.여기에 설정된 Connection은 LEAK여부를 검사하지 않는다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• jdbc_connection_justget=db.DBConnectionManager.getConnection(String)

jdbc_resultset_warning_fetch_count

특정 애플리케이션이 수행되는 과정에서 java.sql.ResultSet 객체의 next 메소드가 지정한 값 이상으로 호출되면 WARNING_JDBC_TOOMANY_RS_NEXT 유형의 장애가 발생한다.

• default: 10000

• value: INT

• jdbc_resultset_warning_fetch_count = 10000

jdump_dir

서비스덤프 파일이 생성될 디렉토리 위치를 지정한다.

• default: ./

• value: DIRPATH

• jdump_dir = ./

leakcheck_${xxx}_close

사용자 정의형 리소스릭을 추적하기 위한 설정이다. 애플리케이션이 리소스를 반환하는 부분을 지정한다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• leakcheck_mypool_close=com.MyPool.release(ResItem)

leakcheck_${xxx}_get

사용자 정의형 리소스릭을 추적하기 위한 설정이다. 애플리케이션이 리소스를 가져가는 부분을 지정한다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• leakcheck_mypool_get=com.MyPool.get()

license_filename

제니퍼 에이전트의 라이센스 키 파일의 위치를 지정한다. 해당 옵션에 파일명만 기입하면 JVM의 현재 디렉토리에 파일이 생성된다. 파일의 전체경로로 지정하는 것을 권장한다.

• default: license.txt

• value: FILEPATH

• license_filename = license.txt

liveobject_class

LIVE OBJECT COUNTING을 위한 대상 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• liveobject_class=com.TextA

liveobject_interface

LIVE OBJECT COUNTING을 위한 대상 클래스들의 공통 인터페이스클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• liveobject_interface=com.ITestClassA;org.ITestClassB

liveobject_postfix

LIVE OBJECT COUNTING을 위한 대상 클래스들의 공통 POSTFIX를 지정한다.

• default: NONE

• value: STRING{,STRING}*

• liveobject_postfix=Adapeter;VO;Action

liveobject_prefix

LIVE OBJECT COUNTING을 위한 대상 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{,STRING}*

• liveobject_prefix=com;org.apache.common

liveobject_super

LIVE OBJECT COUNTING을 위한 대상 클래스들의 공통 SUPER클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• liveobject_super=com.TestSuperA;com.TestSuperB

logfile

제니퍼 에이전트가 남기는 로그를 기록하는 파일의 위치를 지정한다. 해당 로그 파일에는 애플리케이션에서 발생하는 에러 로그, 서비스 덤프 내용, 디버그 내용들이 기록된다. 해당 옵션에 파일 명만 기입하면 JVM의 현재 디렉토리에 파일이 생성된다. 파일의 전체경로로 지정하는것을 권장한다. 제니퍼 에이전트의 로그를 날짜별로 기록하기 원하면 enable_logfile_daily_rotaion 옵션을 활성화 시킨다.

• default: jennifer.log

• value: FILEPATH

• logfile = jennifer.log

logfile_encoding_characterset

제니퍼 에이전트가 로그를 남길 때, 로그파일의 인코딩 형식을 지정한다. 대부분의 경우 WAS의 기본 인코딩을 사용하므로 해당 옵션을 사용하지 않지만, z/OS인 경우 Cp933 으로 설정해준다.

• default: NONE

• value: STRING

• logfile_encoding_characterset = Cp933

long_running_thread_auto_kill_timeout

사용자의 요청을 처리하는 쓰레드의 경과시간이 해당 옵션값을 초과한 경우에 중단시킨다. 단 해당 옵션은 enable_long_running_thread_auto_kill 이 true일 경우에만 의미를 갖는다.

• default: -1

• value: INT

• long_running_thread_auto_kill_timeout = 300000

lwst_call_stack_transfering

제니퍼 에이전트에서 메소드 레벨에서의 Call Stack(중요 메소드, SQL, EJB 등)을 제니퍼 서버로 전송할지 결정한다.

• default: true

• value: BOOL

• lwst_call_stack_transfering = true

lwst_collection_auto_stacktrace_size

콜렉션을 모니터링 할때 엘리먼트 개수가 해당 옵션 값 이상이되면 자동으로 stack trace를 남기도록 하는 설정이다.

• default: 100000

• value: INT

• lwst_collection_auto_stacktrace_size = 100000

lwst_collection_minimum_monitoring_size

콜렉션을 모니터링 할때 엘리먼트 개수가 해당 옵션 값 이상일 경우에만 추적하도록 설정한다.

• default: 3000

• value: INT

• lwst_collection_minimum_monitoring_size = 3000

lwst_debug

LWST모듈의 디버그 정보를 로깅한다. 특히 로딩되는 클래스명과 로더등을 로그파일에 남긴다.

• default: false

• value: BOOL

• lwst_debug=false

lwst_enable

제니퍼 LWST의 동작 여부를 지정한다. 이 옵션이 false이면 제니퍼 LWST가 동작하지 않는다. LWST 모니터링 대상클래스는 build시(lwst.bat실행) 추적 로직이 삽입되기도 하고 실행시에 클래스 로드 시점에 추적 로직이 삽입되기도 한다. lwst_enable옵션은 런타임에 로딩되는 클래스에 대한 추적여부를 결정한다.

• default: true

• value: BOOL

• lwst_enable=false

lwst_logfile

제니퍼 에이전트의 lwst와 관련된 로그를 기록하는 파일의 위치를 지정한다. 해당 로그 파일에는 tx-server, tx-naming, tx-client, profile 대상의 클래스/메소드 정보, lwst 디버그 내용 등이 기록된다. 해당 옵션에 파일 명만 기입하면 JVM의 현재 디렉토리 내에 파일이 생성된다. 파일의 전체 경로로 지정하는 것을 권장한다.

• default: lwst.log

• value: FILEPATH

• lwst_logfile = lwst.log

lwst_posthooking_dump

LWST는 class byte code를 핸들링한다. 원하는 옵션이 정확히 적용된 내용을 코드상에서 확인하기 위해서 byte code가 instrument된 상태를 덤프한다.

• default: NONE

• value: CLASS

• lwst_posthooking_dump=com.Test

lwst_profile_method_param_limit

메소드의 파라미터나 리턴 값을 프로파일링할때 최대 문자열을 지정한다.

• default: 100

• value: INT

• lwst_profile_method_param_limit = 100

lwst_profile_method_using_param

메소드의 파라미터를 프로파일링 한다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• lwst_profile_method_using_param=foo.XBoardVO.setOid(String);foo.XBoardVO.get(String)

lwst_profile_method_using_return

메소드의 리턴값을 프로파일링 한다.(String리턴만 가능)

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• lwst_profile_method_using_return=foo.ATomServlet.getActName(String,String)

lwst_trace_local_port

lwst_trace_local_port 옵션으로 지정한 로컬 포트로 모니터링 대상 애플리케이션이 TCP/IP 소켓을 사용하면 제니퍼 에이전트는 자동으로 해당 애플리케이션의 스택 트레이스를 저장한다. 사용자는 이 정보를 제니퍼 사용자 인터페이스의 [장애 진단 | 파일/소켓] 메뉴에서 확인할 수 있다. 하나의 포트만 지정할 수 있으며, Socket이 열릴 때마다 Stack Trace를 남기기 때문에, 풀링이 되지 않는 연결의 포트를 지정하면 성능저하가 발생할 수있다.

• default: 0

• value: INT

• lwst_trace_local_port=7700

lwst_trace_remote_port

lwst_trace_remote_port 옵션으로 지정한 원격 포트로 모니터링 대상 애플리케이션이 TCP/IP 소켓을 사용하면 제니퍼 에이전트는 자동으로 해당 애플리케이션의 스택 트레이스를 저장한다. 사용자는 이 정보를 제니퍼 사용자 인터페이스의 [장애 진단 | 파일/소켓] 메뉴에서 확인할 수 있다. 하나의 포트만 지정할 수있으며, Socket이 열릴때 마다 Stack Trace를 남김으로 풀링이되지 않는 연결의 포트를 지정하면 성능저하가 발생할 수있다.

• default: 0

• value: INT

• lwst_trace_local_port=1521

lwst_txclient_method_using_param

TX-CLIENT(외부 트랜잭션) 이름을 특정 메소드의 파라미터 값으로 사용하도록 지정한다. 두개 이상의 메소드는 세미 콜론(;)을 구분자로 구분한다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• lwst_txserver_method_using_param=foo.Foo.getFoo(String)

lwst_txclient_method_using_return

TX-CLIENT(외부 트랜잭션) 이름을 특정 메소드의 리턴 값을 사용하도록 지정한다.두개 이상의 메소드는 세미 콜론(;)을 구분자로 구분한다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• lwst_profile_method_using_return=foo.Foo.getFoo(String,String)

lwst_txserver_method_using_param

서비스 트랜잭션명을 특정 메소드의 파라미터 값으로 사용하도록 지정한다. 두개 이상의 메소드는 세미 콜론(;)으로 구분한다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• lwst_txserver_method_using_param=foo.Foo.getFoo(String)

lwst_txserver_method_using_return

서비스 트랜잭션명을 특정 메소드의 리턴 값을 사용하도록 지정한다. 두개 이상의 메소드는 세미 콜론(;)을 구분자로 구분한다.

• default: NONE

• value: CLASS_METHOD_PARAM{;CLASS_METHOD_PARAM}*

• lwst_profile_method_using_return=foo.Foo.getFoo(String,String)

max_num_of_active_service

set_limit_active_service가 true인 경우에 한하여, 액티브 서비스가 해당 옵션 값보다 커지면 서비스 큐잉 현상을 막기 위해서 추가적인 요청을 배척(Reject)한다.

• default: 1024

• value: INT

• max_num_of_active_service = 100

max_num_of_direct_alert

제니퍼 에이전트에서 초당으로 직접 발령가능한 최대 경보 수를 설정한다. 본 설정은 에이전트가 프로그래매틱하게 발령하는 USER_DEFINED_XXX 경보들만 해당된다.

• default: 10

• value: INT

• max_num_of_direct_alert=10

max_num_of_parsed_sql

매번 SQL을 파싱하는 부하를 줄이기 위해, 전혀 파싱할 필요가 없는 SQL들과 파싱된 SQL들을 메모리에 캐싱을 한다. 해당 옵션으로 그 메모리에 캐싱할 수 있는 SQL수를 지정한다.

• default: 513

• value: INT

• max_num_of_parsed_sql = 513

max_num_of_text

제니퍼는 단위 시간동안 제니퍼 서버가 데이터를 수집하기 전까지 TEXT(APP이름, SQL문, TX-CLIENT 이름, 에러)을 메모리에 보관한다. 이때 보관할 최대 크기이다. 이 값이 커지면 비정상 상황일 때 제니퍼가 사용하는 메모리가 증가할 수 있다. 특히 SQL의 경우 제니퍼는 모든 SQL을 파싱하여 상수부를 제거함으로 정상 상황에서 사용되는 SQL 종류가 과도하게 증가할 경우는 드물다. 그러나 TPS가 높고, 일정시간단위 동안 SQL 의 수가 많은 경우 해당 옵션값을 늘려줘야한다.

• default: 1003

• value: INT

• max_num_of_text = 1003

non_public_class

public이 아닌 클래스의 접근 권한을 public으로 변환한다.

• default: NONE

• value: CLASS

• non_public_class=com.TestClass

non_public_member

public이 아닌 필드/메소드의 접근자를 public으로 변환한다.

• default: NONE

• value: CLASS_FIELD|CLASS_METHOD

• non_public_member=com.TescClass.field

number_of_dump_trigger

자동으로 서비스덤프가 생성될 액티브 서비스 개수를 지정한다.

• default: 100

• value: INT

• number_of_dump_trigger = 90

number_of_tcp_workers

제니퍼 서버의 요청을 처리하는 제니퍼 에이전트의 쓰레드 수를 지정한다. 해당 옵션 값을 반영하려면 제니퍼 에이전트가 설치된 WAS를 재시작해야 한다.

• default: 3

• value: INT

• number_of_tcp_workers = 5

patch@

테 스트 목적으로 백엔드 연동 모듈 등의 특정 클래스/메소드의 반환 값을 상수처리 하거나 혹은 운영 환경에 적용된 특정 클래스를 임시로 변경하고 싶을 때도 patch@ 옵션을 사용할 수 있다. 다음과 같이 변경하고자 하는 원본 클래스명을 patch@ 다음에 지정하고 패치할 클래스의 물리적 파일 위치를 지정한다.

• default: NONE

• format: patch@CLASS=FILEPATH

• patch@foo.bar.BizLogic=C:/foo/bar/PatchedBizLogic.clz

profile_access_method

서비스 PROFILING에 포함된 클래스에서 대상 메소드의 접근 권한을 지정한다.

• default: public,protected,private,none

• value:(public|protected|private|none){,(public|protected|private|none)}*

• profile_access_method=public,protected,private,none

profile_buffer_size

트랜잭션당 최대 프로파일 엔트리 개수이다. X-View에서 최대 프로파일 선과 같다.

• default: 1000

• value: INT

• profile_buffer_size=1000

profile_call

프로파일링 대상 메소드의 코드를 검토하여 해당 코드가 이 옵션으로 등록한 메소드를 호출하면 이를 X-View 그래프에 표시한다. 두개 이상의 메소드는 세미 콜론(;)을 구분자로 구분한다.

• default: NONE

• value: (CLASS_METHOD|\*\.METHOD){;(CLASS_METHOD|\*\.METHOD)}*

• profile_call=java.lang.Thread.sleep;*.wait

앞의 옵션처럼 설정하면 java.lang.Thread 클래스의 sleep 메소드나 어떤 클래스나 객체의 wait 메소드를 호출하는 메소드를 X-View 그래프에 표시한다.

profile_class

서비스 PROFILING을 위한 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• profile_class=com.TestClassA;com.TestClassB

profile_class_on

이 설정이 true이면 profile_class에 설정된 클래스가 최초 로딩시 부터 호출 정보를 추적한다.

• default: false

• value: BOOL

• profile_class_on=true

profile_default_on

이 설정이 true이면 프로파일 대상 클래스가 최초 로딩시 부터 호출 정보를 추적한다.

• default: false

• value: BOOL

• profile_default_on=false

profile_ignore_method

서비스 PROFILING에 포함된 클래스에서 제외할 메소드만을 지정한다.

• default: NONE

• value: (CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• profile_ignore_method=access;com.Test.save

profile_ignore_postfix

서비스 PROFILING에서 제외할 클래스들의 공통 POSTFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• profile_ignore_postfix=Util;VO

profile_ignore_prefix

서비스 PROFILING에서 제외할 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• profile_ignore_prefix=com.util;com.jennifersoft.util

profile_interface

서비스 PROFILING을 위한 대상 클래스들의 공통 인터페이스 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• profile_interface=com.ITestClassA;org.ITestClassB

profile_interface_on

이 설정이 true이면 profile_interface에 설정된 클래스가 최초 로딩시 부터 호출 정보를 추적한다.

• default: false

• value: BOOL

• profile_interface_on=true

profile_method_max_byte

PROFILING이 적용될 메소드의 최대 코드 사이즈를 지정한다. 코드 사이즈는 메소드 바이너리 기준이다.

• default: 48000

• value: INT

• profile_method_max_byte=48000

profile_method_min_byte

PROFILING이 적용될 메소드의 최소 코드 사이즈를 지정한다. 코드 사이즈는 메소드 바이너리 기준이다.

• default: 0

• value: INT

• profile_method_min_byte = 0

profile_postfix

서비스 PROFILING을 위한 대상 클래스들의 공통 POSTFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• profile_postfix=Adapeter;VO;Action

profile_prefix

서비스 PROFILING을 위한 대상 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• profile_prefix=com;org.apache.common

profile_super

서비스 PROFILING을 위한 대상 클래스들의 공통 SUPER 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• profile_super=com.TestSuperA;com.TestSuperB

profile_super_on

이 설정이 true이면 profile_super에 의해 설정된 클래스가 최초 로딩시 부터 호출 정보를 추적한다.

• default: false

• value: BOOL

• profile_super_on=true

profile_target_method

서비스 PROFILING에 포함된 클래스에서 대상 메소드만을 지정한다.

• default: NONE

• value: (CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• profile_target_method=access;com.Test.save

recurrsive_call_max_count

RequestDispatcher의 forward()를 잘못 사용할 경우, IOException발생할 때, 통상 error 페이지로 분기하는데, 이때 error페이지가 없으면 또다시 IOException이 발생하고, 자칫 무한 반복 재귀 호출이 일어날 수 있으며, 이는 JVM의 StackOverFlow를 유발하여 JVM이 다운될 수 있다. 이처럼 동일 Thread에서 HttpServlet.service()가 반복적으로 호출될 때, 그 호출 횟수를 제한하는 기능이다.

• default: 50000

• value: INT

• recurrsive_call_max_count = 50000

remote_address_header_key

X-View를 통해서 사용자 IP를 확인할 수 있다. 해당 IP는 request.getRemoteAdd()의 값이다. 사용자 IP가 아닌 L4나 웹서버의 IP가 보일 경우 request.getHeader(key)에서 실제 사용자 IP를 얻을 수 있다. 해당 키값을 옵션에 설정하면 실제 사용자의 IP가 나온다.

• default: NONE

• value: STRING

• remote_address_header_key=key1

request_reject_message

request_reject_type의 속성을 message로 지정한 경우 사용자에게 보여줄 메시지를 지정한다.

• default: Workload so high. Please, try again later!

• value: STRING

• request_reject_message = Workload so high. Please, try again later!

request_reject_redirect_url

request_reject_type의 속성을 redirect로 지정한 경우, 사용자에게 보여줄 페이지를 지정한다.

• default: NONE

• value: STRING

• request_reject_redirect_url = /error.html

request_reject_type

set_limit_active_service가 true인 경우에 한하여, PLC에 의해 사용자의 요청이 거부될 경우 어떠한 형식으로 관련 메세지를 보여줄것인가를 지정한다. message 와 redirect 형식이 있다.

• default: message

• value: message|redirect

• request_reject_type = message

request_set_character_encoding

아파치 톰켓과 같이 웹 애플리케이션 서버 차원에서 다국어 문자 지원이 미비할 때, HttpServletRequest의 getParameter 메소드가 다국어(예: 한국어)를 지원하지 않을 수 있다. 그런데 서블릿 2.3부터는 HttpServletRequest의 setCharacterEncoding 메소드를 통해서 다국어에 대한 처리를 쉽게 할 수 있다.

그런데 http_post_request_tracking_list이나 url_additional_request_keys 속성을 사용하면 모니터링 대상 애플리케이션에서 HttpServletRequest의 setCharacterEncoding 메소드를 호출하여도 제니퍼 에이전트가 먼저 HttpServletRequest의 getParameter 메소드를 호출하기 때문에 다국어에 대한 처리가 올바르게 되지 않을 수 있다. 이 문제를 해결하기 위해서 이 속성을 지정하면 제니퍼 에이전트가 맨 앞단에서 setCharacterEncoding 메소드를 호출한다.

• default: NONE

• value: STRING

• request_set_character_encoding = KSC5601

server_udp_listen_port

제니퍼 에이전트는 주기적으로 (기본 1초) 통계 데이터를 해당 포트를 통해서 제니퍼 서버로 전송하며 ,대략 230바이트 정도의 데이터를 전송한다. 해당 데이터를 받아 줄 제니퍼 서버의 UDP포트를 지정한다.

• default: 6902

• value: PORT

• server_udp_listen_port = 6902

server_udp_lwst_call_stack_port

제니퍼 에이전트는 사용자의 요청이 수행되고 종료될 때마다 프로파일링 데이터를 해당 포트를 통해서 제니퍼 서버로 전송한다. 해당 데이터를 받아 줄 제니퍼 서버의 UDP 포트를 지정한다.

• default: 6703

• value: PORT

• server_udp_lwst_call_stack_port = 6703

server_udp_runtime_port

제니퍼 에이전트는 사용자의 요청이 발생할 때마다 실시간 데이터를 해당 포트를 통해서 제니퍼 서버로 전송하며, 매번 약 12~33바이트 정도의 데이터를 전송한다. 해당 데이터를 받아 줄 제니퍼 서버의 UDP포트를 지정한다.

• default: 6901

• value: PORT

• server_udp_runtime_port = 6901

service_log_class

서비스 트랜잭션 추적에서 사용할 ServiceLogger 어뎁터 클래스를 지정한다. 여기에 지정된 클래스는 ServiceLogger.Adapter를 Implemdnt해야 한다.

• default: NONE

• value: CLASS

• service_log_class=jennifer.service.MemAllocTrace

service_log_end

서비스 트랜잭션 추적 종료부에 ServiceLogger.Adapter의 동작을 허용한다.

• default: false

• value: BOOL

• service_log_end = true

service_log_classpath

ServiceLogger 어뎁터를 포함한 jar파일의 경로를 지정한다.

• default : NONE

• value : JARPATH{;JARPATH}*

• service_log_classpath : /jennifer/agent/lwst40.custom.jar

service_log_start

서비스 트랜잭션 추적 시작부에 ServiceLogger.Adapter의 동작을 허용한다.

• default: false

• value: BOOL

• service_log_start = true

session_class

WAS의 HTTP SESSION 객체를 지정한다. 아래의 값중에 하나만 지정가능하다

• default: NONE

• value: CLASS{;CLASS}*

• session_class=org.apache.tomcat.session.StandardManager;org.apache.tomcat.modules.session.SimpleSessionStore$SimpleSessionManager;org.apache.catalina.session.StandardManager

• session_class=com.evermind.server.http.HttpApplication;org.apache.jserv.JServServletManager;com.evermind._ay;jrun.servlet.session.SessionService

• session_class=weblogic.servlet.internal.session.MemorySessionContext;weblogic.servlet.internal.session.JDBCSessionContext;weblogic.servlet.internal.session.ReplicatedSessionContext;weblogic.servlet.internal.session.FileSessionContext;weblogic.servlet.internal.session.CookieSessionContext

• session_class=jeus.servlet.engine.ContextGroupsession_class=com.fujitsu.interstage.jservlet.tomcat.session.StandardManager

set_limit_active_service

성능 제어기능인 PCL(Peak Load Control)의 사용여부를 지정한다.

• default: false

• value: BOOL

• set_limit_active_service = false

socket_simple_trace

소켓에 의한 전송량과 상태 등은 추적하지 않고 특정 포트가 열렸다는 정보만을 X-View에 표시한다. lwst_trace_remote_port나 lwst_trace_local_port 옵션으로 지정한 포트는 그 옵션 지정에 따른 방식으로 처리된다.

• default: false

• value: BOOL

• socket_simple_trace=true

sql_bad_responsetime

트랜잭션 중에 SQL의 응답시간이 해당 옵션 값 이상을 초과한 경우, 로그파일에 기록되고 제니퍼 에러에 등록된다. 매우 작은 시간을 지정하면 로그 파일의 크기가 커지고 , 에러 건수가 증가하기 때문에 사이트의 성능 특성을 고려하여 적절하게 지정한다. 단위는 밀리세컨드(ms)이다.

• default: 20000

• value: MILLISECOND

• sql_bad_responsetime = 20000

stacktrace_class

LWST STACKTRACING를 위한 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• stacktrace_class=com.TestClassA;com.TestClassB

stacktrace_interface

LWST STACKTRACING를 위한 대상 클래스들의 공통 인터페이스 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• stacktrace_interface=com.ITestClassA;org.ITestClassB

stacktrace_postfix

LWST STACKTRACING를 위한 대상 클래스들의 공통 POSTFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• stacktrace_postfix=Adapeter;Action

stacktrace_prefix

LWST STACKTRACING를 위한 대상 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• stacktrace_prefix=com.mybiz

stacktrace_stacksize

LWST STACKTRACING를 위한 스택의 크기를 지정한다.

• default: 200

• value:INT

• stacktrace_stacksize=200

stacktrace_super

LWST STACKTRACING를 위한 대상클래스들의 공통 SUPER 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• stacktrace_super=com.TestSuperA;com.TestSuperB

trace_related_transaction

멀티 쓰레드에 의해 동작하는 트랜잭션을 추적할지의 여부를 지정한다. ESB 환경에서 적용되는 옵션이다.

• default: true

• value: BOOL

• trace_related_transaction = true

tx_bad_responsetime

애플리케이션의 외부 트랜잭션 (TX-tuxedo, tmax, cics, etc...)의 응답 시간이 지정한 시간 이상을 초과한 경우, 로그파일에 기록되고 제니퍼 에러로 등록된다. 매우 작은 시간을 지정하면 로그 파일의 크기가 커지고 에러건수가 증가하기 때문에 사이트의 성능 특성을 고려하여 적절하게 지정한다. 단위는 밀리세컨드(ms)이다.

• default: 10000

• value: MILLISECOND

• tx_bad_responsetime = 10000

tx_client_access_method

TX-CLIENT(외부 트랜잭션) 추적에 포함된 클래스에서 대상 메소드의 접근권한을 지정한다.

• default: public,protected,private,none

• value:(public|protected|private|none){,(public|protected|private|none)}*

• tx_client_access_method=public,protected,private,none

tx_client_class

TX-CLIENT(외부 트랜잭션) 추적을 위한 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• tx_client_class=com.TestClassA;com.TestClassB

tx_client_ignore_method

TX-CLIENT(외부 트랜잭션) 추적에 포함된 클래스에서 제외할 메소드만을 지정한다.

• default: NONE

• value: (CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• tx_client_ignore_method=access;com.Test.save

tx_client_ignore_prefix

TX-CLIENT(외부 트랜잭션) 추적에서 제외할 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• tx_client_ignore_prefix=com.util;com.jennifersoft.util

tx_client_interface

TX-CLIENT(외부 트랜잭션) 추적을 위한 대상 클래스들의 공통 인터페이스 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• tx_client_interface=com.ITestClassA;org.ITestClassB

tx_client_ntype

TX-CLIENT(외부 트랜잭션) 추적에서 Naming타입을 지정한다.

• default: FULL

• value: FULL|CLASS|METHOD|SIMPLE

• tx_client_ntype=CLASS

tx_client_postfix

TX-CLIENT(외부 트랜잭션) 추적을 위한 대상 클래스들의 공통 POSTFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• tx_client_postfix=Adapeter;VO;Action

tx_client_prefix

TX-CLIENT(외부 트랜잭션) 추적을 위한 대상 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• tx_client_prefix=com;org.apache.common

tx_client_super

TX-CLIENT(외부 트랜잭션) 추적을 위한 대상클래스들의 공통 SUPER클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• tx_client_super=com.TestSuperA;com.TestSuperB

tx_client_target_method

TX-CLIENT(외부 트랜잭션) 추적에 포함된 클래스에서 대상 메소드만을 지정한다.

• default: NONE

• value: (CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• tx_client_target_method=access;com.Test.save

tx_client_using_param

TX-CLIENT(외부 트랜잭션) 이름을 메소드의 스트링 파라미터로 부여한다.

• default: false

• value: BOOL

• tx_client_using_param=true

tx_naming_access_method

TX-NAMING(서비스 추가 이름)에 포함된 클래스에서 대상 메소드의 접근 권한을 지정한다.

• default: public,protected,private,none

• value:(public|protected|private|none){,(public|protected|private|none)}*

• tx_naming_access_method=public,protected,private,none

tx_naming_class

TX-NAMING(서비스 추가 이름)을 위한 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• tx_naming_class=com.TestClassA;com.TestClassB

tx_naming_ignore_method

TX-NAMING(서비스 추가 이름)에 포함된 클래스에서 제외할 메소드만을 지정한다.

• default: NONE

• value: (CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• tx_naming_ignore_method=access;com.Test.save

tx_naming_ignore_prefix

TX-NAMING(서비스 추가 이름)에서 제외할 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• tx_naming_ignore_prefix=com.util;com.jennifersoft.util

tx_naming_interface

TX-NAMING(서비스 추가 이름)을 위한 대상 클래스들의 공통 인터페이스 클래스를 지정한다.

• default: NONE

• value: CLASS{;CLASS}*

• tx_naming_interface=com.ITestClassA;org.ITestClassB

tx_naming_ntype

TX-NAMING(서비스 추가 이름)에 적용된 클래스가 애플리케이션 서비스 명에 추가될 때는 클래스명+메소드명이 사용된다(단 tx_naming_using_param=false). 이때 추가되는 서비스 명을 축약하여 사용하기 위한 옵션이다.

• default: FULL

• value: FULL|CLASS|METHOD|SIMPLE

• tx_naming_ntype=CLASS

tx_naming_postfix

TX-NAMING(서비스 추가 이름)을 위한 대상 클래스들의 공통 POSTFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• tx_naming_postfix=Adapeter;VO;Action

tx_naming_prefix

TX-NAMING(서비스 추가 이름)을 위한 대상 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value: STRING{;STRING}*

• tx_naming_prefix=com;org.apache.common

tx_naming_super

TX-NAMING(서비스 추가 이름)을 위한 대상 클래스들의 공통 SUPER 클래스를 지정한다.

• default: NONE

• value:CLASS{;CLASS}*

• tx_naming_super=com.TestSuperA;com.TestSuperB

tx_naming_target_method

TX-NAMING(서비스 추가 이름)에 포함된 클래스에서 대상 메소드만을 지정한다.

• default: NONE

• value:(CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• tx_naming_target_method=access;com.Test.save

tx_naming_using_param

TX-NAMING(서비스 추가 이름)에 설정된 클래스가 호출될 때 첫번째 String 파라미터 값을 Additional 서비스 명으로 사용하도록 한다.

• default: false

• value:BOOL

• tx_naming_using_param=true

tx_naming_using_return

TX-NAMING(서비스 추가 이름)에 설정된 클래스가 호출될 때 String 리턴 값을 Additional 서비스 명으로 사용하도록 한다.

• default: false

• value:BOOL

• tx_naming_using_return=false

tx_server_access_method

TX-SERVER(서비스 시작)에 포함된 클래스에서 대상 메소드의 접근 권한을 지정한다.

• default: public,protected,private,none

• value:(public|protected|private|none){,(public|protected|private|none)}*

• tx_server_access_method=public,protected,private,none

tx_server_class

TX-SERVER(서비스 시작)를 위한 클래스를 지정한다.

• default: NONE

• value:CLASS{;CLASS}*

• tx_server_class=com.TestClassA;com.TestClassB

tx_server_ignore_method

TX-SERVER(서비스 시작)에 포함된 클래스에서 제외할 메소드만을 지정한다.

• default: NONE

• value:(CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• tx_server_ignore_method=access;com.Test.save

tx_server_ignore_prefix

TX-SERVER(서비스 시작)에서 제외할 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value:STRING{;STRING}*

• tx_server_ignore_prefix=com.util;com.jennifersoft.util

tx_server_interface

TX-SERVER(서비스 시작)를 위한 클래스들의 공통 인터페이스클래스를 지정한다.

• default: NONE

• value:CLASS{;CLASS}*

• tx_server_interface=com.ITestClassA;org.ITestClassB

tx_server_ntype

TX-SERVER(서비스 시작)에서 네이밍 타입을 지정한다.

• default: FULL

• value: FULL|CLASS|METHOD|SIMPLE

• tx_server_ntype=CLASS

tx_server_postfix

TX-SERVER(서비스 시작)를 위한 클래스들의 공통 POSTFIX를 지정한다.

• default: NONE

• value:STRING{;STRING}*

• tx_server_postfix=Adapeter;VO;Action

tx_server_prefix

TX-SERVER(서비스 시작) 를 위한 클래스들의 공통 PREFIX를 지정한다.

• default: NONE

• value:STRING{;STRING}*

• tx_server_prefix=com;org.apache.common

tx_server_super

TX-SERVER(서비스 시작)를 위한 클래스들의 공통 SUPER클래스를 지정한다.

• default: NONE

• value:CLASS{;CLASS}*

• tx_server_super=com.TestSuperA;com.TestSuperB

tx_server_target_method

TX-SERVER(서비스 시작)에 포함된 클래스에서 대상 메소드만을 지정한다.

• default: NONE

• value:(CLASS_METHOD|METHOD){;(CLASS_METHOD|METHOD)}*

• tx_server_target_method=access;com.Test.save

tx_server_using_param

서비스명을 서비스 시작 메소드의 스트링 파라미터로 부여한다. 이 옵션이 true로 설정되면 tx_server_ntype은 무시된다.

• default: false

• value:BOOL

• tx_server_using_param=true

udp_server_host

제니퍼 서버가 기동중인 서버의 IP Address 이다. 해당 IP를 변경하면 실시간으로 반영된다.

• default: 127.0.0.1

• value:IP|HOSTNAME

• udp_server_host = localhost

uri_separator

일반 웹시스템에서 URL과 파라미터 사이의 구분은 ‘?’가 사용된다.그러나 이동 단말기를 위한 시스템에서는 다른 문자가 사용될 수 있는데 이때 구분 문자를 설정한다.

• default: NONE

• value:CHAR

• uri_separator=?

uri_starter

제니퍼에이전트가 HttpRequest에서 URL을 추출할때 앞부분을 잘라내기 위해 설정한다.

• default: NONE

• value: STRING

• uri_starter=/http

url_additional_request_keys

MVC(Model-View-Controll) 패턴 등의 설계로 인해서 성격이 다른 사용자의 여러 요청이 하나의 URL로 들어오고 이를 하나의 컨트롤 서블릿 객체가 특정 HTTP파라미터 값을 이용해서 분기하는 구조라면 애플리케이션 트랜잭션을 URL만으로 표현하는 것은 부족하다. 이 경우 해당 프레임워크에서 공유한 요청을 구분해 내는 HTTP 요청값이 있다면 그 키값을 해당 옵션에 지정한다. 이 경우 애플리케이션명은 URL+키 값 형태가 된다.

• default: NONE

• value:STRING{,STRING}*

• url_additional_request_keys = key1,key2

user_defined_jdbc_connectionpool_prefixes

JDBC SQL을 추적할 때, DriverManager.getConnection() 유형을 사용하는 경우에 설정할 수 있다. 여려개라면 ( “,” )로 구분하여 기술한다.

• default: NONE

• value:STRING

• user_defined_jdbc_connectionpool_prefixes=jdbc:apache:commons:dbcp

user_defined_jdbc_ignore_close

user_defined_jdbc_connectionpool_prefixes사용하여 JDBC를 추적하면 Connection Not Close를 감지하지 않는다. 이것을 감지하려면 false로 설정해야 한다.

• default: true

• value:BOOL

• user_defined_jdbc_ignore_close=true

xview_profile_ignore_resp_time

응답시간이 옵션 값 미만의 트랜잭션의 프로파일 정보를 전송하지 않는 옵션이다. 응답시간이 상대적으로 매우 짧은 트랜잭션 보다는 응답시간이 오래 걸린 트랜잭션이 관심의 대상이 될 수 있으므로, 응답시간이 짧은 트랜잭션을 필히 분석할 필요가 없다면 제니퍼 서버로 전송하지 않는다. 따라서 제니퍼 서버의 부하도 줄일 수 있다.

• default: 0

• value:MILLISECOND

• xview_profile_ignore_resp_time = 0

xview_profile_udp_packet_size

제니퍼 에이전트는 트랜잭션 프로파일링 데이터를 UDP 패킷으로 제니퍼 서버에 보내는데, UDP패킷에는 64kbyte 의 제약이 있다. 이 경우 패킷을 여러개로 나누어 전송할 수 있는데 한번에 전송되는 UDP 패킷의 크기를 지정한다.

• default: 32757

• value:INT

• xview_profile_udp_packet_size = 32757

web_service_logfile

WAS의 애플리케이션 서비스 성능을 로깅하기 위한 파일명을 설정한다.

• default: NONE

• value:FILEPATH

• web_service_logfile=service.log

제니퍼 서버 옵션

active_graph_interval

이 설정은 액티브 서비스 수를 화면에 디스플레이 할때 사용되는 그룹핑 기준이다.

• default: 0,1000,3000,8000

• value: MILLISECOND,MILLISECOND,MILLISECOND,MILLISECOND(오름차순 정렬,4개 숫자)

• active_graph_interval = 0,1000,3000,8000

위 설정은 0-1,1~3, 3~8, 8+를 의미 한다.

agent_group

에이전트 그룹을 정의한다. 그룹명은 반드시 ‘@’이로 시작되고 2개의 숫자로 구성되어야 한다.따라서 가능한 그룹명은 @01~@99 이다.그룹명 뒤에 ‘:’을 붙이고 해당되는 에이전트 명을 ‘,’로 분리하여 기술한다. 그룹과 그룹사이는 ‘;’로 구분한다

• default: NONE

• value:@99:AGENT{,AGENT}*{;@99:AGENT{,AGENT}*}*

• agent_group = @01:W11,W12; @02:W13,W14

active_service_alert_limit

액티브 서비스 큐잉 경고를 위한 기준값을 설정한다. 큐잉 카운트가 설정값을 초과하면 경보(ERROR_SERVICE_QUEUING) 가 발령된다.

• default: 70

• value:INT

• active_service_alert_limit = 70

adf_stream_buffer_size

REMON 에서 “STREAM” 타입의 데이터를 제니퍼 클라이언트에 서비스하기 위한 버퍼사이즈를 설정한다 . 제니퍼 클라이언트가 데이터를 조회하는 시간간격 (2 초 ) 동안 버퍼링되는 데이터 크기이다 . 버퍼 사이즈는 REMON SCRIPT ID 별로 적용된다 .

• default: 512

• value:INT

• adf_stream_buffer_size=512

agent_death_auto_remove_time

정지된 에이전트를 제니퍼 서버의 관리목록에서 제거하기 위한 기준시간을 설정한다.

• default: 3600000

• value:MILLISECOND

• agent_death_auto_remove_time = 86400000

agent_death_detection_time

SUMMARY 데이터(6902)가 여기에 설정된 시간동안 전달되지 않으면 에이전트가 다운되었다고 판단한다.

• default: 3000

• value:MILLISECOND

• agent_death_detection_time = 8000

agent_tcp_connect_timeout

제니퍼 서버에 에이전트에 연결시 사용되는 연결 TIMEOUT 값이다.

• default: 3000

• value:MILLISECOND

• agent_tcp_connect_timeout=3000

agent_tcp_io_timeout

제니퍼 에이전트와 TCP 통신시 IO Time Out Limit를 설정한다.

• default: 5000

• value:MILLISECOND

• agent_tcp_io_timeout = 5000

bbs_type_list

제니퍼 서버에서 사용할 수있는 게시판 유형을 정의한다.

• default: NONE

• value:STRING{;STRING}*

• bbs_type_list=biz:Business;rpt:Report;chat:Personal

config_refresh_check_interval

해당 옵션 값 간격으로 제니퍼 서버 설정파일의 변경사항을 체크한다.

• default: 3000

• value:MILLISECOND

• config_refresh_check_interval = 3000

data_directory

데이터 디렉토리 패스를 설정한다.만약 데이터 디렉토리가 변경되면 이전 데이터를 모두 상실한다.윈도우 환경에서도 ‘\’ 대신에 ‘/’를 사용한다.

• default:../data/

• value: DIRPATH

• data_directory = ../../data/file/

debug_tcp

제니퍼 클라이언트 TCP연결 요청을 로깅한다.

• default: false

• value:BOOL

• debug_tcp=false

default_max_rows_for_report_item

보고서 생성시 하나의 아이템을 위한 최대 데이터 row수이다.이 값이 커지면 제니퍼 서버에 부하를 유발할 수있다.

• default: 3600

• value:INT

• default_max_rows_for_report_item=3600

disable_app_mapping_db

제니퍼 서버에서 Application과 SQL/TX간의 맵핑정보 저장하지 않도록 설정한다.기본값은 false이다.맵핑 정보의 활용도가 떨어지는 시스템에 대해서는 true로 설정할 것을 권고한다.

• default: false

• value:BOOL

• disable_app_mapping_db=false

domain_name

하나의 제니퍼 서버에서 여러개의 서버 혹은 여러개의 제니퍼 에이전트를 중앙에서 관장하여 모니터링한다. 그러나 경우에 따라서는 이러한 모니터링 대상 서버를 비지니스 시스템 그룹별로 구분하여 별도의 제니퍼 서버로 모니터링해야할 수도 있다. 이때 제니퍼 서버가 관장하는 단위를 도메인(domain)이라 부르며, 각 도메인을 구분할 수 있도록 속성을 지정한다.

• default: SYS1

• value:STRING

• domain_name = SYS1

enable_biz_monitor

타 시스템(ex ITSM)과 제니퍼 서버간 데이터 연동시 비즈니스 그룹 성능을 계산한다. 값이 false이면 업무별 성능정보를 타 시스템에 전달할 수없다. 타 시스템과 연계가 있는 경우에만 true로 설정할 것을 권고한다.

• default: false

• value:BOOL

• enable_biz_monitor=false

enable_including_standalone_statistics

제니퍼 에이전트는 WAS에서 웹 서비스트 혹은 다른 프로토콜의 서비스를 같이 모니터링할 수 있다. 그런데 웹이 아닌 다른 서비스에 대한 성능 통계를 전체 통계에서 제외하고자 할때 false로 설정한다.

• default: true

• value:BOOL

• enable_including_standalone_statistics=true

enable_logfile_daily_rotation

로그파일을 일자별로 생성하도록 한다.

• default: false

• value:BOOL

• enable_logfile_daily_rotation=true

enable_minimize_db

데이터베이스 저장을 최소화 한다. 이 옵션이 true로 설정되면 데이터베이스에 성능데이터가 저장되지 않는다. 제니퍼 서버 문제 해결을 위해서만 사용해야 한다.

• default: false

• value:BOOL

• enable_minimize_db=false

enable_remon_data_save

레몬 프로토콜로 전송되는 데이터에 대한 저장을 DISABLE할 수 있다.

• default: true

• value:BOOL

• enable_remon_data_save=true

enable_server_trace

제니퍼 서버에서 수행되는 내부 SQL의 성능이나 에러를 로깅한다.

• default: false

• value:BOOL

• enable_server_trace=false

enable_visit_user_added_while_reloading

이값이 true로 설정되면 제니퍼서버가 재기동될때 현재의 시간당/일자별 방문자 수에 이전(제니퍼 서버 재기동 전) 시간당/일자별 방문자 수를 합산한다. 쇼핑몰 처럼 불특정 유저가 사용하는 시스템에서만 true를 설정한다.

• default: false

• value:BOOL

• enable_visit_user_added_while_reloading=false

enable_xview_data_logging

X-View를 위한 트랜잭션별 성능데이터 저장 여부를 결정한다. 제니퍼 서버의 문제 해결을 위해서만 사용(false로 설정)해야 한다.

• default: true

• value:BOOL

• enable_xview_data_logging=true

high_rate_failed_alert_limit

서비스 실패율 경고를 위한 기준값(%)을 설정한다. 실패율이 지정한 퍼센트를 초과하면 경보(ERROR_HIGH_RATE_FAIL)를 발령한다.

• default: 50

• value:INT

• high_rate_failed_alert_limit = 50

high_rate_reject_alert_limit

PLC에 의해 REJECT되는 서비스 율에 대한 경고를 설정한다. REJECT되는 서비스율이 설정값을 초과하면(ERROR_HIGH_RATE_REJECT) 경보가 발령된다.단 서비스 처리량이 최소 3TPS 이상인 경우에만 이 규칙이 적용된다.

• default: 50

• value:INT

• high_rate_reject_alert_limit = 50

ignore_unallowed_alert

ALERT설정에서 true가 아닌 경보는 발령하지 않는다.(무시된다)

• default: false

• value:BOOL

• ignore_unallowed_alert=false

jvm_cpu_alert_limit

JVM CPU사용량 경고를 위한 기준값을 설정한다. 사용량이 설정값을 초과하면 경보(ERROR_JVM_CPU_HIGH_LONGTIME)가 발령된다.

• default: 90

• value:INT

• jvm_cpu_alert_limit = 90

jvm_cpu_warning_limit

JVM CPU사용량 경고를 위한 기준값을 설정한다. 사용량이 jvm_cpu_alert_limit 미만 이면서 설정값을 초과하면 경보(WARNING_JVM_CPU_HIGH)가 발령된다.

• default: 90

• value:INT

• jvm_cpu_warning_limit = 90

jvm_heap_check_time

jvm_heap_warning_limit에서 지정한 사용량 초과 상태가 유지되는 시간(초)을 지정한다. 조건에 해당되면 WARNING_JVM_HEAP_MEM_HIGH이라는 경보가 발령된다

• default: 0

• value:MILLISECOND

• jvm_heap_check_time=300

jvm_heap_warning_interval

경고가 발생하는 시간 간격(초)을 설정한다.

• default: 0

• value:MILLISECOND

• jvm_heap_check_warning_interval=3600

jvm_heap_warning_limit

힙 메모리 사용량(%)을 지정한다.

• default: 0

• value:INT

• jvm_heap_warning_limit=95

logfile

제니퍼 서버 로그파일(파일명 포함) 위치를 지정한다.

• default: jennifer.log

• value:FILEPATH

• logfile = ../logs/jennifer.log

logfile_encoding_characterset

제니퍼 서버가 로그를 남길 때, 로그파일의 인코딩 형식을 지정한다. 일반적으로는 제니퍼 서버는 OS 기본 인코딩을 사용하므로 해당 옵션을 사용하지 않는다.

• default: NONE

• value:STRING

• logfile_encoding_characterset = Cp933

number_of_tcp_pooled_workers

동시에 처리할 수있는 제니퍼 클라이언트(애플릿)에서의 연결요청 수를 설정한다. 한 클라이언트당 동시에 2개이상의 연결을 요청한다.

• default: 80

• value:INT

• number_of_tcp_pooled_workers = 80

number_of_udp_callstack_workers

제니퍼 에이전트로 부터 전송되는 프로파일 데이터(6703)를 처리하기 위한 쓰레드 수를설정한다.

• default: 30

• value: INT

• number_of_udp_callstack_workers = 30

number_of_udp_listen_workers

제니퍼 에이전트로 부터 전송되는 SUMMARY데이터(6902)를 처리하기 위한 쓰레트 수를 설정한다.

• default: 10

• value: INT

• number_of_udp_listen_workers = 10

number_of_udp_runtime_workers

제니퍼 에이전트로 부터 전송되는 RUNTIME데이터(6901)를 처리하기 위한 쓰레스 수를 설정한다.

• default: 10

• value: INT

• number_of_udp_runtime_workers = 10

perf_host_update_interval

이 옵션은 PERF_HOST 테이블의 저장 간격이다.

• default: 300000

• value: MILLISECOND

• perf_host_update_interval = 300000

perf_x_update_interval

이 옵션은 PERF_X 테이블의 저장 간격이다.제니퍼 통계 그래프에서 표시하는 데이터는 5분 기준이다. 따라서 이값이 1분으로 수정되어도 5분 단위 데이터만 그래프에서 사용된다. 1분 데이터는 템플릿 보고서을 사용하거나 쿼리 수행기를 통해서 확인해야 한다.

• default: 300000

• value: MILLISECOND

• perf_x_update_interval = 300000

remon_addr

제니퍼 화면 컴포넌트 중에는 레몬으로 접속하여 데이터를 조회하는 기능이 있다. 일반적으로 각 레몬 프로세스 IP주소는 제니퍼 서버에 의해 자동으로 감지되지만 네트웍 구성에 따라서는 이것이 불가능할 수도 있다. 이때 레몬 프로세스의 주소를 명시적으로 기술할 수있다. 여러개의 주소를 설정할 수 없다.

• default: NONE

• value: HOST:PORT

• remon_addr=192.168.10.1:7701

remon_debug

REMON데이터를 디버깅할때 true로 설정한다.

• default: false

• value: BOOL

• remon_debug=false

report_image_height

SQL콘솔이나 웹리포팅에서 그래프의 세로 크기를 설정한다.

• default: 200

• value: INT

• report_image_height=200

report_image_width

SQL콘솔이나 웹리포팅에서 그래프의 가로 크기를 설정한다.

• default: 800

• value: INT

• report_image_width=800

server_jdbc_trace_overthan

설정된 시간 이상의 SQL(제니퍼 서버내부) 수행 지연이 발생하면 로깅한다.

• default: 10000

• value: MILLISECOND

• server_jdbc_trace_overthan=10000

server_tcp_port

UDP 포트와는 별도로, 관리자의 브라우져의 Applet기반의 GUI Viewer와 통신하는 제니퍼 서버의 TCP 포트다. Applet은 주기적으로 제니퍼 서버의 해당 포트를 통해 데이터를 가져가게 된다.

• default: 6701

• value: PORT

• server_tcp_port = 6701

server_trace_filename

제니퍼 서버내부에 수행되는 SQL성능을 로깅하기 위한 파일명을 설정한다.

• default: servertrace.log

• value: FILEPATH

• server_trace_filename=servertrace.log

server_udp_listen_port

실시간이 아닌 주기적(1초)으로 Agent로 부터 넘어오는 통계 데이터를 취합하는 UDP 포트다. 제니퍼 독립에이전트(wmond, remon)가 보내주는 데이터도 해당 포트로 취합된다.

• default: 6902

• value: PORT

• server_udp_listen_port = 6902

server_udp_lwst_call_stack_port

Agent로부터 전송된 실시간 Call Stack 정보를 취합하는 UDP 포트다.

• default: 6703

• value: PORT

• server_udp_lwst_call_stack_port = 6703

server_udp_runtime_port

사용자 요청이 발생할때마다 넘어오는 실시간 데이터를 전송하는 UDP 포트다. 이 값은 각 Agent 구성파일의 것과 동일해야 한다.

• default: 6901

• value: PORT

• server_udp_runtime_port = 6901

sms_adapter_class_name

Sendsms어뎁터 클래스를 설정한다. 어뎁터 클래스는 제니퍼서버가 기동되기 전에 JENNIFER_HOME/server/common/lib에 jar파일 형태로 배포되어 있어야 한다.

• default: 6902

• value: CLASS{;CLASS}*

• sms_adapter_class_name = com.javaservice.jennifer.server.SMSExample

sms_alert_minimal_interval

SMS 메세지 처리 interval을 설정한다. Sendsms어뎁터는 여기에 설정된 간격으로 trigger된다.

• default: 60000

• value: MILLISECOND

• sms_alert_minimal_interval = 1000

specified_agent_ip

에이전트의 실제 IP주소와 서버에서 에이전트로 연결할 때 사용해야 하는 IP 주소가 다를때 해당 에이전트의 IP주소를 이 설정에 명시한다.설정 방법은 아래 예를 참조한다

• default: NONE

• value: AGENT:IP{,AGENT:IP}*

• specified_agent_ip = W11:192.168.10.101, W12:192.168.10.102

supported_language_list

제니퍼 서버가 지원하는 언어의 목록이다. 현재 영어, 한국어, 일본어를 지원하고 있다.

• default: en,ko,ja,zh,fr

• value: STRING{,STRING}*

• supported_language_list = en,ko,ja,zh,fr

sys_cpu_alert_limit

시스템 CPU사용량 경고를 위한 기준값을 설정한다. 사용량이 설정값을 초과하면 경보(ERROR_SYSTEM_CPU_HIGH_LONGTIME)가 발령된다.

• default: 90

• value: INT

• sys_cpu_alert_limit = 95

sys_cpu_warning_limit

시스템 CPU사용량 경고를 위한 기준값을 설정한다. 사용량이 sys_cpu_alert_limit 미만이면서 설정값을 초과하면 경보(WARNING_SYSTEM_CPU_HIGH)가 발령된다.

• default: 95

• value: INT

• sys_cpu_warning_limit = 95

system.derby.system.home

제니퍼 데이터 베이스의 위치를 설정한다

• system.derby.system.home = ../../data/database

system.derby.drda.startNetworkServer

제니퍼 데이터 베이스에 대한 네트웍 접속을 허용한다. 제니퍼 서버가 기동되기 전에 설정되어야 한다.

• default: false

• value: BOOL

• system.derby.drda.startNetworkServer = true

system.derby.drda.portNumber

system.derby.drda.startNetworkServer = true인 상태에서 제니퍼 데이터 베이스의 서비스 포트를 설정한다.제니퍼 서버가 기동되기 전에 설정되어야 한다.

• default: NONE

• value: PORT

• system.derby.drda.portNumber = 1527

udp_server_host

제니퍼 서버가 UPD로 바인딩할 서버의 IP Address 다. 서버에 하나 이상의 N/W 카드가 있다면, 해당 N/W카드로 들어오는 요청만 바인딩한다.

• default: localhost

• value:HOST

• udp_server_host = 0.0.0.0

unspecified_alert_is_allowed

ALERT설정에서 명시되지 않은 ALERT은 true로 설정된다.

• default: false

• value: BOOL

• unspecified_alert_is_allowed=false

upload_directory

제니퍼서버 게시판에 파일을 업로드할 때 사용할 디렉토리를 지정한다.

• default: ../../data/upload

• value: DIRPATH

• upload_directory = ../../data/upload

user_defined_jdbc_ignore_close

JDBC 추적 유형2(DriverManager) 추적시 Connection close감지 여부를 결정한다. 값이 true이면 close를 감지하지 않으며, Connection이 애플리케이션에 할당 되어도 상태가 ALLOCATED로 변경되지 않는다.

• • default: true

• • value: BOOL

• • user_defined_jdbc_ignore_close = true

xvdaily_agents

일자별 X-View프로파일 정보를 저장할 에이전트를 선별 할 수있다.

• default: NONE

• value: AGENT{,AGENT}*

• xvdaily_agents=W11,W12

xvdaily_enable

일자별 X-View 프로파일 데이터 저장 여부를 결정한다. 기본값은 true이다.

• default: true

• value: BOOL

• xvdaily_enable=true

xvdaily_ignore_resp_time

일자별 X-View 프로파일 데이터를 저장하는 기준시간을 설정한다. 여기에 설정된 시간미만의 응답 트랜잭션의 프로파일 정보는 서버에 저장되지 않는다.

• default: 0

• value: MILLISECOND

• xvdaily_ignore_resp_time = 500

xview_point_ignore_resp_time

응답시간이 옵션 값 미만의 트랜잭션에 대해서는 X-View 데이터 파일에 성능 정보를 저장하지 않는다.

• default: 0

• value:MILLISECOND

• xview_point_ignore_resp_time = 0

xview_profile_ignore_resp_time

여기에 설정한 값보다 적은 응답시간을 갖는 트랜잭션의 프로파일 데이터는 무시(저장 않함)된다.

• default: 0

• value: MILLISECOND

• xview_profile_ignore_resp_time = 0

xview_profile_cache_queue_size

프로파일 정보를 저장하기 위해 임시 보관하는 CACHE 크기이다.

• default: 512

• value: INTEGER

• xview_profile_cache_queue_size=512

xview_profile_isam_file_max_size

실시간 X-View 프로파일 데이터를 저장하기 위한 파일 사이즈를 설정한다.

• default: 0

• value: 999kb|999mb|999gb

• xview_profile_isam_file_max_size = 512mb

xview_profile_multi_packet_check_interval

X-View 프로파일이 멀티패킷으로 전달될때 모든 패킷이 도착했는지 검사하는 주기를 설정한다.

• default: 2000

• value: MILLISECOND

• xview_profile_multi_packet_check_interval=2000

xview_profile_multi_packet_queue_size

X-View 프로파일이 멀티패킷으로 전달될때 받아들이는 큐사이즈를 설정한다.

• default: 303

• value: INT

• xview_profile_multi_packet_queue_size = 103

xview_profile_multi_packet_time_out

X-View 프로파일이 멀티패킷으로 전달될때 모든 패킷이 도착할 때까지지 기다리는 시간을 설정한다.

• default: 1000

• value: MILLISECOND

• xview_profile_multi_packet_time_out=1000

xview_server_queue_size

서버에 받은 프로파일을 저장할 때 사용하는 큐 사이즈를 설정한다.

• default: 512

• value: INT

• xview_server_queue_size = 512

제니퍼 닷넷 전용 옵션

startup_url

IIS 의 AppPool은 기본값으로 20분 동안 요청이 없으면 프로세스가 종료(Recycle)된다. 하지만, IISConfigHelper에서 해당 웹 사이트에 "Enable Auto Start" 옵션을 지정하면 자동으로 다시 w3wp.exe 가 실행된다. 이 때, 최초로 방문되는 웹 페이지를 startup_url에 지정할 수 있다.

• default: "Enable Auto Start"가 적용된 웹 애플리케이션의 루트 URL (ex: http://localhost)

• setting: http://localhost

• value: STRING (URL)

• restart: Unnecessary

• example: http://localhost:8000/default.aspx

disable_complus_resource_leak

COM+ 프록시 객체에 대한 Dispose 호출이 안 된 경우, WARNING_RESOURCE_LEAK 경고를 발생하지 않도록 설정한다.

• default: true

• setting: true

• value: BOOL

• restart: Unnecessary

• example: disable_complus_resource_leak=false

disable_process_info

에이전트의 EXE 단위로 수집되는 정보(메모리, CPU사용량)에 대한 수집 작업을 중단한다.

• default: false

• setting: false

• value: BOOL

• restart: Unnecessary

• example: disable_process_info=false

• related: disable_system_info

disable_system_info

에이전트가 설치된 시스템 단위로 수집되는 정보(전체 메모리, 전체 CPU사용량)에 대한 수집 작업을 중단한다.

• default: false

• setting: false

• value: BOOL

• restart: Unnecessary

• example: disable_system_info=false

• related: disable_system_info

enable_db_stack_trace

DB 쿼리 실행 중 오류가 발생한 경우, 그 쿼리를 실행한 시점의 스택트레이스를 보여준다. 이 옵션이 동작하려면 반드시 enable_db_sql_trace 가 true로 설정되어 있어야 한다.

• default: true

• setting: true

• value: BOOL

• restart: Unnecessary

• example: enable_db_stack_trace=true

enable_ext_var_info

"Problem Determination" / "Utilities" / "System Env." 에서 "System Environment Variables" 측에 제니퍼 닷넷을 위한 환경 정보를 추가적으로 출력한다.

• default: false

• setting: false

• value: BOOL

• restart: 설정할 때는 필요없지만, 해제할 때는 필요

• example: enable_ext_var_info=false

enable_method_profile

profiler.ini 에 프로파일되도록 설정된 메소드들에 대한 실행 프로파일 기록을 X-View에서 볼 것인지를 설정한다.

• default: true

• setting: true

• value: BOOL

• restart: Unnecessary

• example: enable_method_profile=true

enable_os_full_dump

메모리가 os_full_dump_trigger_start, os_full_dump_trigger_step, os_full_dump_trigger_count 설정을 만족할 때마다 프로세스의 Full Dump를 생성한다.

이 옵션이 언제나 동작하는 것은 아니다. 예를 들어, 급격한 메모리 상승으로 순간적으로 프로세스가 종료해 버릴 때는 제니퍼 닷넷에서 이 순간을 감지할 수 없으므로 덤프를 남기지 못한다.

• default: false

• setting: false

• value: BOOL

• restart: Unnecessary

• example: enable_os_full_dump=true

• related: os_full_dump_trigger_start, os_full_dump_trigger_step, os_full_dump_trigger_count

enable_service_dump

메모리가 service_dump_trigger_start, service_dump_trigger_step, service_dump_trigger_count 설정을 만족할 때마다 Active Server에 대한 덤프를 생성한다.

• default: true

• setting: true

• value: BOOL

• restart: Unnecessary

• example: enable_service_dump=true

• related: service_dump_trigger_start, service_dump_trigger_step, service_dump_trigger_count

enable_trace_http_user_agent

웹 요청의 "User Agent" 헤더에 대한 추적을 활성화시킨다.

• default: true

• setting: true

• value: BOOL

• restart: Unnecessary

• example: enable_trace_http_user_agent=true

master_host_name

배치 잡 모니터링 시에 sub agent 측에서 통신할 master agent 가 설치된 컴퓨터 이름 또는 IP 주소를 설정한다.

• default: 127.0.0.1

• setting: 127.0.0.1

• value: STRING 또는 IP

• restart: Unnecessary

• example: master_host_name=127.0.0.1

• related: master_udp_listen_port

master_udp_listen_port

배치 잡 모니터링 시에 sub agent 측에서 통신할 master agent 가 대기하고 있는 UDP 포트 주소를 설정한다.

• default: 6705

• setting: 6705

• value: 포트번호

• restart: Unnecessary

• example: master_udp_listen_port=6705

• related: master_host_name

output_aspnet_exception

aspx/asmx/wcf 호출 이외의 ASP.NET 오류가 발생한 경우 이를 X-View 데이터로 확인하고 싶을 때 설정한다. 예를 들어, IIS 7 이상의 경우에는 HTTP 404 Not Found 에 해당하는 요청도 X-View에서 확인할 수 있다.

• default: false

• setting: false

• value: BOOL

• restart: Unnecessary

• example: output_aspnet_exception=false

os_full_dump_trigger_start, os_full_dump_trigger_step, os_full_dump_trigger_count

enable_os_full_dump 옵션이 true일 때, 메모리 덤프를 뜰 조건을 설정한다. start는 메모리의 처음 조건을 만족하는 용량을 지정하고, step은 처음 조건 이후 다시 덤프를 남길 메모리 용량 간격을 지정한다. 마지막으로 count는 덤프 횟수를 나타낸다. 예를 들어 다음과 같이 조건을 설정한 경우,

os_full_dump_trigger_start = 1024
os_full_dump_trigger_step = 500
os_full_dump_trigger_count = 1

count 가 1이므로 메모리가 1024MB(== 1GB)에 도달했을 때 단 한번 메모리 덤프를 남긴다. 또 다른 예로 다음과 같이 설정한 경우,

os_full_dump_trigger_start = 1024
os_full_dump_trigger_step = 100
os_full_dump_trigger_count = 3

count가 3이므로 메모리가 1024MB에 도달했을 때 한번 남기고, 이후 1124MB, 1224MB에 도달했을 때 2번 더 덤프를 남긴다.

덤프 조건은 한번 만족된 경우 재적용되지 않는다. 즉, 1024MB에 도달했다가 900MB로 메모리가 떨어진 다음 다시 1024MB에 도달해도 덤프는 남기지 않는다.

• value: INT

• restart: Unnecessary

• related: enable_os_full_dump

profile_ignore_connection

DB 연결에 대한 X-View 프로파일 데이터를 생략한다.

• default: false

• setting: false

• value: BOOL

• restart: Unnecessary

• example: profile_ignore_connection=false

profile_ignore_fetch

ADO.NET의 DataReader 사용시 Fetch 건수에 대한 X-View 프로파일 데이터를 생략한다.

• default: false

• setting: false

• value: BOOL

• restart: Unnecessary

• example: profile_ignore_fetch=false

profile_sql_time

SQL 쿼리의 수행 시간이 profile_sql_time에 지정된 시간보다 낮은 경우 X-View 프로파일 데이터로 남기지 않는다. 이 값이 0이면 모든 SQL 쿼리를 남기지만, 0을 초과해서 설정하면 밀리초 단위로 수행 시간이 적용된다.

• default: 0

• setting: 0

• value: INT

• restart: Unnecessary

• example: profile_sql_time=1000

service_dump_trigger_start, service_dump_trigger_step, service_dump_trigger_count

enable_service_dump 옵션이 true일 때, 액티브 서비스 덤프를 뜰 조건을 설정한다. start는 메모리의 처음 조건을 만족하는 용량을 지정하고, step은 처음 조건 이후 다시 덤프를 남길 메모리 용량 간격을 지정한다. 마지막으로 count는 덤프 횟수를 나타낸다. 예를 들어 다음과 같이 조건을 설정한 경우,

service_dump_trigger_start = 1024
service_dump_trigger_step = 500
service_dump_trigger_count = 1

count 가 1이므로 메모리가 1024MB(== 1GB)에 도달했을 때 단 한번 메모리 덤프를 남긴다. 또 다른 예로 다음과 같이 설정한 경우,

service_dump_trigger_start = 1024
service_dump_trigger_step = 100
service_dump_trigger_count = 3

count가 3이므로 메모리가 1024MB에 도달했을 때 한번 남기고, 이후 1124MB, 1224MB에 도달했을 때 2번 더 덤프를 남긴다.

덤프 조건은 한번 만족된 경우 재적용되지 않는다. 즉, 1024MB에 도달했다가 900MB로 메모리가 떨어진 다음 다시 1024MB에 도달해도 덤프는 남기지 않는다.

• value: INT

• restart: Unnecessary

• related: enable_service_dump

string_data_interval

수집된 user agent 문자열을 제니퍼 서버로 보내는 주기를 설정한다.

• default: 10000

• setting: 10000

• value: INT

• restart: Unnecessary

• example: string_data_interval=5000

• related: enable_trace_http_user_agent

string_data_send_id

수집된 user agent 문자열의 버퍼를 초기화 시킨다. string_data_send_id 를 새롭게 바꾸면, 에이전트 측에 수집되어 있던 user agent 캐시를 모두 삭제하고 새로 수집한다.

• default: 0

• setting: 0

• value: INT

• restart: Unnecessary

• example: string_data_send_id=1

• related: string_data_interval

trace_related_transaction

이 값이 true 이면 HTTP 헤더로부터 relatx_guid_keyname 키에 해당하는 값을 구해 트랜잭션의 GUID로 설정한다. 이렇게 웹 서비스들끼리의 호출 관계가 GUID로 연결되면 이후 멀티 트랜잭션 뷰에서 확인할 수 있다.

• default: true

• setting: true

• value: BOOL

• restart: Unnecessary

• example: trace_related_transaction=true

• related: relatx_guid_keyname

제니퍼 에러 코드

제니퍼 에이전트와 서버에서 발생할 수 있는 에러 리스트이다. 다음 설명은 에러가 발생한 상황이나 위치에 대한 설명이다.

에이전트 에러 코드

제니퍼 에이전트가 실행되면서 발생한 에러코드이다. 제니퍼 에이전트 로그파일에 기록된다.

제니퍼에이전트 LWST 에러 코드

제니퍼 Byte Code Instrumentation모듈인 LWST에서 발생할 수 있는 에러 코드이다. 해당 에러가 발생하면 lwst log파일에 기록된다.

제니퍼 서버 에러 코드

제니퍼 서버가 동작하면서 발생하는 비정상적인 상황에 대한 코드이다. 제니퍼 서버 로그파일에 기록된다.