제니퍼 에이전트 설정 파일

모니터링 수준과 방법, 네트워크 포트 번호 지정 등을 포함한 대부분의 설정은 제니퍼 에이전트 옵션을 통해서 이루어진다. 제니퍼 에이전트 설치 시에 자바 -Djennifer.config 옵션으로 지정한 파일이 제니퍼 에이전트 설정 파일이다.

설정 파일 형식

제니퍼 에이전트 옵션은 텍스트 형식의 설정 파일에 기록된다. 이 파일은 다음과 같은 특징을 갖는다

• 키 = 값 형식으로 기술한다. 키는 제니퍼 에이전트의 옵션을 의미한다.

• [#]으로 시작하는 줄은 주석이다. 그러나 문자열 중간에 있는 [#] 기호는 주석으로 인식되지 않는다.

• [=] 대신 '공백'을 키와 값의 구분자로 사용할 수 있다.

• 앞의 이유로 인하여 키에 공백을 사용하는 것을 허용하지 않는다.

• 그러나 값에는 공백을 사용할 수 있다.

• 두 줄 이상을 사용하려면 라인의 끝에 [\] 문자를 사용한다. 만약, [\] 문자 자체가 필요한 경우에는, [\]대신 [\\]을 사용한다.

• 앞의 이유로 인하여 마이크로소프트 윈도우즈 환경에서 디렉토리 구분은 [\]가 아니라 [\\]로 해야 한다. 그런데 윈도우즈 환경에서 유닉스처럼 [/]을 사용할 수 있기 때문에 윈도우즈 환경에서도 [/]을 사용하는 것을 권장한다.

• 일부 옵션을 제외한 대부분의 옵션들은 수정과 함께 실시간으로 반영된다. 수정된 옵션을 반영하기 위해 제니퍼 에이전트를 설치한 자바 애플리케이션을 재시작해야 하는 경우에는 해당 옵션을 설명할 때 이를 명기하였다.

설정 변경

설정 파일은 에디터를 통해서 직접 수정하거나, [구성 관리 | 구성 설정 ] 메뉴에서 수정할 수 있다. 단, 제니퍼 클리이언트에서는 관리자 그룹에 속한 사용자만이 옵션을 수정할 수 있다.

1. 에이전트 선택 영역 - 제니퍼 에이전트 옵션 내용을 확인하거나 수정하려면 해당 제니퍼 에이전트를 선택한다.

2. 현재 설정 내용 - 왼쪽에 있는 현재 설정 내용에서 제니퍼 에이전트 옵션을 확인한다.

3. 설정 내용 변경 - 오른쪽에 있는 설정 내용 변경 입력 폼에서 기존 옵션을 수정하거나 새로운 옵션을 추가한 후에, 하단에 있는 [수정] 버튼을 클릭한다.

제니퍼 에이전트 설정 파일은 제니퍼 에이전트의 config_refresh_check_interval 옵션으로 설정한 시간마다 반복적으로 변경 여부가 체크된다. 단위는 밀리 세컨드이다.

config_refresh_check_interval = 3000

새로운 설정 파일 만들기

새로운 제니퍼 에이전트 설정 파일을 만들려면 JENNIFER_HOME/agent 디렉토리에 있는 기존 설정 파일(예, w11.conf)을 복사하여 다음의 옵션 값을 수정한다.

agent_name = W11
agent_tcp_port = 7750

동일한 하드웨어에서 두개 이상의 자바 애플리케이션을 모니터링하기 위해서는, 새로운 제니퍼 에이전트 아이디를 부여하고 에이전트 TCP 리스닝 포트 번호를 달리 설정해야 한다.

그런데 모니터링해야 하는 자바 애플리케이션이 몇 개가 아닌 수십 개가 되는 경우에, 각각을 복사하여 설정 파일을 만드는 것은 상당히 번거로운 일이다. 그래서 이러한 과정을 용이하게 하기 위한 유틸리티를 제공한다.

confutil.sh

JENNIFER_HOME/agent/confutil.sh 유틸리티는 현재 디렉토리에서 w11.conf 파일을 읽어 c01.conf 파일에서 c50.conf 파일까지 50개의 설정 파일을 자동으로 생성한다.

제니퍼 에이전트 기본 설정 및 관리

제니퍼 에이전트를 설치하고 기본적으로 변경해야 하는 제니퍼 에이전트 옵션들과 설치 과정에서 발생할 수 있는 예외 현상들을 설명한다.

제니퍼 에이전트 아이디

하나의 제니퍼 서버는 여러 개의 제니퍼 에이전트로부터 성능 데이터를 수집할 수 있다. 그래서 제니퍼 서버가 수집한 성능 데이터를 제니퍼 에이전트 별로 식별할 수 있도록 제니퍼 에이전트 아이디는 유일해야 한다. 이는 제니퍼 에이전트의 agent_name 옵션으로 설정한다.

agent_name = W11

제니퍼 에이전트의 아이디가 중복되면 제니퍼 클라이언트에서 해당 제니퍼 에이전트가 짧은 주기로 반복해서 정지된 것으로 나타나거나 ERROR_MAYBE_GC_TIME_DELAY 경보가 발령될 수 있다. 이 경우에 중복된 제니퍼 에이전트 아이디 중의 하나를 변경하고 [구성 관리 | 구성 설정 | 실시간 운영 관리] 메뉴에서 [에이전트 목록]과 [실시간 데이터 목록]을 삭제하면 정상적으로 작동한다.

로그 파일

제니퍼 에이전트의 로그 파일은 제니퍼 에이전트의 logfile 옵션으로 설정한다.

logfile = jennifer.log

기본 설정의 경우에는 WORKING_DIRECTORY/jennifer.log 파일에 로그가 기록된다. 이 로그 파일에는 애플리케이션에서 발생한 예외, 서비스 덤프, 디버그 내용 등이 기록된다.

로그 파일을 일자별로 기록하려면 제니퍼 에이전트의 enable_logfile_daily_rotation 옵션을 true로 설정한다.

enable_logfile_daily_rotation = true

제니퍼 에이전트의 logfile_encoding_characterset 옵션으로 제니퍼 에이전트 로그 파일의 텍스트 인코딩을 지정할 수도 있다.

기본 설정의 경우에는 WORKING_DIRECTORY/jennifer.log 파일에 로그가 기록된다. 이 로그 파일에는 제니퍼 에이전트의 tx-server, tx-naming, tx-client, profile 등의 옵션으로 설정한 클래스와 메소드에 대한 정보와 LWST 디버그 내용 등이 기록된다.

라이센스키 파일

제니퍼 에이전트 라이센스키는 제니퍼 에이전트의 license_filename 옵션으로 설정한 텍스트 파일에 저장된다.

license_filename = license.txt

기본 설정의 경우에는 WORKING_DIRECTORY/license.txt 파일에 라이센스키가 저장된다.

라이센스키와 제니퍼 에이전트 enable

IP 주소의 변경과 유효 기간 경과 등의 이유로 라이센스키가 유효하지 않게 되거나 제니퍼 에이전트의 enable 옵션을 false로 설정하면 제니퍼 에이전트는 다음과 같이 동작한다.

자바 애플리케이션 재시작 여부와 상관없이 LWST 모듈을 제외한 모든 제니퍼 에이전트의 기능은 동작하지 않는다. 즉, 모든 데이터 수집과 전송 기능이 정지한다. 물론 자바 애플리케이션의 동작에는 영향을 주지 않는다.

그러나 자바 애플리케이션을 재시작하지 않으면 LWST 모듈은 기존과 동일하게 동작한다. 이는 LWST 모듈이 클래스 로딩 시에 바이트 코드를 변경하는 방식으로 동작하기 때문이다. 즉, 이미 로딩된 클래스에 의한 프로파일링을 포함한 LWST 기능 수행을 무효화할 수 는 없다. 물론 자바 애플리케이션을 재시작하면 LWST와 관련한 기능도 모두 정지한다.

네트워크 설정

제니퍼 에이전트는 수집한 성능 데이터를 제니퍼 서버에 전송한다. 다음은 이를 위한 네트워크 설정에 대한 설명이다.

TCP 네트워크 설정

제니퍼 서버가 제니퍼 에이전트의 TCP 포트로 역방향 연결을 하기도 한다. 주로 액티브서비스 목록, 10분간 애플리케이션 처리 현황 통계, 로딩 클래스 목록, 소켓/파일 목록 등과 같이 데이터의 크기가 크고 데이터베이스나 파일에 저장되지 않는 데이터를 조회하는데 TCP 역방향 연결을 사용한다. 그래서 제니퍼 에이전트의 agent_tcp_port 옵션으로 제니퍼 서버로부터의 TCP 요청을 받아들이는 제니퍼 에이전트의 포트 번호를 설정한다. 기본 포트 번호는 7750이다.

agent_tcp_port = 7750

그리고 제니퍼 에이전트의 agent_tcp_port 옵션으로 설정한 포트로 들어오는 제니퍼 서버의 요청을 처리하는 제니퍼 에이전트의 자바 쓰레드를 Agent TCP Worker라고 한다. Agent TCP Worker의 숫자는 제니퍼 에이전트의 number_of_tcp_workers 옵션으로 설정한다. 기본 값은 5이다.

number_of_tcp_workers = 5

TCP 네트워크 설정과 관련한 옵션을 수정하는 경우에는 제니퍼 에이전트를 설치한 자바 애플리케이션을 재시작해야 한다.

UDP 네트워크 설정

제니퍼 에이전트는 제니퍼 서버의 UDP 포트로 성능 데이터를 전송한다. 우선 제니퍼 에이전트의 udp_server_host 옵션으로 제니퍼 서버의 IP 주소를 설정한다.

udp_server_host = 127.0.0.1

그리고 제니퍼 서버에 설정한 UDP 포트 번호와 동일하게 제니퍼 에이전트에도 해당 옵션을 설정한다.

server_udp_runtime_port = 6901
server_udp_listen_port = 6902
server_udp_lwst_call_stack_port = 6703

이 두 옵션을 수정하는 경우에는 제니퍼 에이전트를 설치한 자바 애플리케이션을 재시작 할 필요가 없다.

운영 체계별 UDP 사이즈 설정

운영 체계별로 UDP 송신 버퍼 사이즈를 설정하는 방법이다. 이를 변경하려면 시스템 root 권한이 필요하다.

IBM AIX의 경우에는 다음과 같이 UDP 송신 버퍼 사이즈를 변경한다.

설정 값 확인 : # no -a | grep udp_sendspace
설정 값 변경 : # no -o udp_sendspace=65535
영구 설정 값 변경 : # no -p -o udp_sendspace

선 솔라리스의 경우에는 다음과 같이 UDP 송신 버퍼 사이즈를 변경한다.

설정 값 확인 : # ndd -get /dev/udp udp_xmit_hiwat
설정 값 변경 : # ndd -set /dev/udp udp_xmit_hiwat 65535
영구 설정 값 변경 : /etc/system 혹은 /etc 아래의 RC Script 안에 ndd -set /dev/udp udp_xmit_hiwat 65535 추가한다.

HP hp-ux의 경우에는 다음과 같이 UDP 송신 버퍼 사이즈를 변경한다

설정 값 확인 : # sysconfig –q inet udp_sendspace
설정 값 변경 : # sysconfig –i inet udp_sendspace = 65535

네트워크 테스트

제니퍼 서버와 제니퍼 에이전트는 UDP와 TCP 연결을 모두 사용한다. 그런데 방화벽과 같은 네트워크 장비로 인한 제약으로 통신이 정상적으로 이루어지지 않는 경우가 있다. 이러한 문제를 해결하기 위해서 네트워크가 정상인지를 확인할 필요가 있다.

TCP 연결은 간단한 텔넷 프로그램으로 해당 포트가 열려 있는지를 확인할 수 있다.

telnet 127.0.0.1 7750

그러나 UDP 연결은 제니퍼 서버가 데이터를 올바르게 받는지를 확인해야 한다. 이를 테스트할 수 있는 JENNIFER_HOME/agent/udptest.sh 유틸리티를 제공한다. 제니퍼 에이전트를 설치한 하드웨어에서 이 유틸리티를 실행하면 UDP 연결 테스트를 위한 임의의 데이터를 제니퍼 서버에 전송한다. 이 유틸리티를 실행하려면 자바가 패스에 등록되어 있어야 한다.

udptest.sh [jennifer_server_ip] [port] [datalen]
ex) udptest.sh 127.0.0.1 6901 100

만약 제니퍼 서버의 콘솔에 다음과 같은 메시지가 출력되면 UDP 연결이 정상적임을 의미한다.

RECV(6901) from=127.0.0.1 data=100 bytes

다중 프로세스에 제니퍼 설치

제니퍼 에이전트는 자바 프로세스 단위로 설정해야 한다. 각 자바 프로세스의 -Djennifer.config 옵션을 다르게 설정해야 하기 때문이다.

그러나 일부 WAS나 자바 데몬이 동일 실행 명령에 설정된 값을 이용하여 여러 개의 다중 프로세스를 실행하는 경우가 있다. 이 경우에는 각 자바 프로세스를 위한 서로 다른 -Djennifer.config 옵션을 개별적으로 설정할 수 없다.

이런 다중 프로세스 환경에 제니퍼 에이전트를 설치할 때는 공통으로 사용되는 자바 실행옵션에 -Dconfig.auto=true를 추가로 설정한다.

-Dconfig.auto=true

제니퍼는 에이전트는 프로세스 기동시 TCP 포트를 체크하여 -Djennifer.config 옵션에 설정된 파일 이름을 토대로 적절한 제니퍼 에이전트 설정 파일을 찾아낸다.

-Dconfig.auto=true -Djennifer.config=x01.conf

만약 위와 같이 설정하면 제니퍼 에이전트는 x01.conf에서부터 파일명의 숫자(뒷2자리)를 증가 시키며 각 프로세스를 위한 제니퍼 에이전트 설정 파일을 찾아서 적용한다. 다중 프로세스를 위한 제니퍼 설정을 위한 가이드는 다음과 같다

• 예상되는 프로세스 수 만큼의 config 파일을 -Djennifer.config 옵션으로 설정한 제니퍼 에이전트 설정 파일(x01.conf)이 위치한 디렉토리에 만들어 두어야 한다.

• 기본 설정 파일(x01.conf) 이름은 2자의 숫자를 포함해야 한다.

• -Djennifer.config 옵션에는 숫자가 가장 빠른 파일을 설정한다.

• 제니퍼 에이전트 설정 파일의 이름에서 숫자는 연속되어야 하고(예를 들어, x01.conf, x02.conf ... x50.conf, x51.conf), 숫자를 제외한 나머지 이름은 동일 해야 한다.

• 각 제니퍼 에이전트 설정 파일의 agent_tcp_port와 agent_name 옵션의 값은 서로 달라야 한다.

제니퍼 에이전트 임시 디렉토리 변경

제니퍼 에이전트는 제니퍼 에이전트를 설치한 운영 체계의 특정 디렉토리에 로딩된 클래스나 성능 데이터를 임시로 저장한다. 이 때 사용되는 디렉토리는 제니퍼 에이전트가 설치된 자바 애플리케이션을 수행하고 있는 WORKING_DIRECTORY이다. 이 디렉토리에는 .data와 .class라는 서브디렉토리가 만들어진다. 제니퍼 에이전트의 agent_fileroot 옵션으로 해당 디렉토리를 변경할 수 있다.

agent_fileroot = /jennifer/agent/data

제니퍼 에이전트 설치 과정에서 발생할 수 있는 예외 현상

X-View 프로파일에서 SQL 파라미터가 정상적으로 보이지 않는 현상

제니퍼 에이전트와 제니퍼 서버의 file.encoding이 다른 경우에 제니퍼 서버가 수집한 성능 데이터가 정상적으로 보이지 않을 수 있다. 이 경우에는 명시적으로 제니퍼 서버의 file.encoding 값을 제니퍼 에이전트의 server_encoding 옵션으로 설정한다.

server_encoding = UTF8

선 자바 1.5, 6.0 등에서 Native Memory Leak 발생

선 자바 1.5 혹은 6.0 등에서 Native Memory Leak 현상이 발생하면, 다음 자바 실행 옵션을 설정한다.

-XX:CompileCommand=exclude,org/apache/jennifer/bcel/classfile/Attribute,readAttribute

제니퍼 설치 후 애플리케이션 쿠키 정보 유실

제니퍼 에이전트는 방문자 수와 동시단말 사용자 수를 수집하기 위해서 쿠키를 사용한다. 그런데 사용할 수 있는 쿠키의 숫자와 크기에는 제한이 있기 때문에, 기존 자바 애플리케이션에서 많은 쿠키를 사용하고 있으면 쿠키 정보가 유실될 수가 있다. 이 경우에는 제니퍼 에이전트의 hotfix_remote_address_for_wmonid 옵션을 true로 설정한다.

hotfix_remote_address_for_wmonid = true

이 옵션이 true로 설정되면 remote address를 사용자 구분으로 사용한다.

과도한 WARNING_JDBC_CONN_ILLEGAL_ACCESS 발생

제니퍼는 java.sql.DriverManager와 javax.sql.DataSource 클래스에서 JDBC를 모니터링 하는데, 이 클래스들의 앞단에서 자바 애플리케이션이 임의의 또 다른 커넥션 풀을 사용하면 WARNING_DB_CONN_ILLEGAL_ACCESS 예외가 과도하게 발생할 수 있다. 이 문제를 해결하려면 [JDBC 커넥션 객체의 중복 할당]를 참조한다.

부정확한 WARNING_JDBC_UN_COMMIT_ROLLBACK 발생

부정확한 WARNING_JDBC_UN_COMMIT_ROLLBACK 예외가 발생하면 제니퍼 에이전트의 ignore_rollback_uncommited_error 옵션을 true로 설정한다.

ignore_rollback_uncommited_error = true

오라클 JDBC에서 Class Cast Exception이 발생

오라클 JDBC를 사용하는 과정에서 java.sql.Connection이나 java.sql.ResultSet 클래스와 관련한 java.lang.ClassCastException이 발생하면 제니퍼 에이전트의 enable_jdbc_oracle_dependency_used 옵션을 true로 설정한다.

enable_jdbc_oracle_dependency_used = true

자세한 사항은 [오라클 Dependency ]를 참조한다.

세션 덤프 설정 후 HTTP 세션 클래스가 초기화되지 않는 경우

HTTP 세션을 모니터링하기 위해서 세션 덤프를 설정한 후에 HTTP 세션 클래스가 초기화되지 않으면, 제니퍼 에이전트의 session_class 옵션을 제거한다.

CPU 사용률이 매우 높고, 자바 코어 덤프에 네트워크 통신과 관련한 부분이 자주 나타나는 경우

CPU 사용률이 매우 높고, 자바 코어 덤프에 네트워크 통신과 관련한 부분이 자주 나타나는 경우에는, 제니퍼 에이전트의 socket_simple_trace 옵션을 true로 설정한다.

socket_simple_trace = true

IBM JDK 1.3에서 액티브 서비스 목록 조회시 WAITING 현상 발생

자바 애플리케이션이 IBM JDK 1.3을 사용하는 경우에 [실시간 모니터링 | 애플리케이션] 메뉴에서 액티브 서비스 목록을 조회할 때 WAITING 현상이 발생할 수 있다. 이는 IBM JDK 1.3에서 자바 쓰레드 개수가 많아지면, 액티브 서비스를 처리하는 자바 쓰레드의 정보를 얻는 과정에서 문제가 발생할 수 있기 때문이다.

이 경우에는 제니퍼 에이전트의 hotfix_disable_thread_active_count 옵션을 true로 설정한다. 단, 이렇게 설정하면 자바 쓰레드 정보를 확인할 수 없다.

JRockit 1.5.0_06에서 DriverManager 클래스의 getCallerClassLoader 메소드를 호출할 때 에러가 발생하는 현상

JRockit 1.5.0_06 버전에서 DriverManager 클래스의 getCallerClassLoader 메소드를 호출할 때 에러가 발생한다. 이 문제를 해결하기 위한 패치 파일을 제공한다. 제니퍼 에이전트를 설치할 때 -Xbootclasspath를 다음과 같이 설정한다.

-Xbootclasspath/p:/jennifer/agent/lwst.jrockit150_06.jar:/jennifer/agent/lwst.boot.jar:/jennifer/agent/lwst.jdk.jar

lwst.jrockit150_06.jar 파일을 lwst.jdk.jar 파일보다 앞에 설정해야 한다.

제니퍼 에이전트 이름 설정

제니퍼 에이전트 아이디는 W11과 같이 3자로 제한되어 있기 때문에, 차트를 포함한 제니퍼 클라이언트에서 제니퍼 에이전트 아이디로는 업무와 관련한 의미를 전달하는데 한계가 있다. 이 문제를 해결하려면 제니퍼 에이전트에 임의의 이름을 부여하고, 그 이름을 제니퍼 클라이언트에서 사용하면 된다.

제니퍼 에이전트 이름을 부여하는 방법은 다음과 같다.

우선, [구성 관리 | 구성 설정 | 도메인 관리] 메뉴로 이동하여 도메인 정보를 입력한다.

다음은 도메인 입력 폼의 필드에 대한 설명이다.

그러면 도메인 목록에 새로 추가한 도메인 정보가 나타나고, 도메인 정보의 아이디를 클릭하면 하단에 도메인 정보가 나타난다. 여기서 하단 오른쪽에 있는 [불러오기] 버튼을 누르면 제니퍼 에이전트 목록이 나타난다.

기본적으로 제니퍼 에이전트 이름은 제니퍼 에이전트 아이디와 동일하다. 제니퍼 에이전트 이름 칼럼에서 이름을 수정한 후에 [저장] 버튼을 클릭하면, 제니퍼 에이전트의 이름이 변경된다.

제니퍼 에이전트 목록 하단에 있는 [정렬] 버튼을 통해서 제니퍼 에이전트가 화면에 나타나는 순서를 설정할 수 있다. 기본 정렬 기준은 제니퍼 에이전트 아이디이다.

Byte Code Instrumentation

효율적인 모니터링을 하려면 모니터링을 할 자바 애플리케이션의 소스 코드를 수정하지 않고, 성능 데이터 수집에 필요한 추적 코드와 프로파일 정보 추출 코드를 자바 애플리케이션을 구성하는 클래스에 삽입할 수 있어야 한다. 이를 Byte Code Intrumentation(이하 BCI)이라 한다. 제니퍼에서 BCI를 담당하는 모듈을 Instrumentation 혹은 LWST 모듈이라고 부른다.

LWST 빌드와 설치

LWST 모듈에 의한 BCI는 lwst.boot.jar와 lwst.javaagent.jar 파일에 의한 런타임 처리와 오프라인에서 java.lang.ClassLoader, java.net.Socket 등의 주요 자바 클래스를 패치하여 패키지한 lwst.jdk.jar 파일에 의한 처리로 구분된다.

우선 lwst.boot.jar 파일은 LWST 코어 모듈로서 bootclasspath에 설치한다. 그리고 자바 1.5 이상에서만 사용하는 lwst.javaagent.jar 파일은 javaagent로 등록한다.

그리고 오프라인에서 java.lang.ClassLoader, java.net.Socket 등의 주요 자바 클래스를 패치하여 lwst.jdk.jar 파일로 패키지하는 것을 LWST 빌드라고 한다. LWST 빌드를 통해서 JAVA_HOME/jre/lib/rt.jar 파일이나 그와 동일한 역할을 하는 JVM 모듈을 기반으로 lwst.jdk.jar 파일을 생성한다. 그리고 LWST 빌드로 생성한 lwst.jdk.jar 파일은 bootclasspath에 설치한다.

LWST 빌드를 하는 방법은 다음과 같다. 이 유틸리티는 JENNIFER_HOME/agent 디렉토리에 존재한다.

lwst40.sh [command option] [rt.jar]

lwst40.sh 유틸리티를 실행할때 사용하는 첫번째 파라미터를 COMMAND 옵션이라 한다. COMMAND 옵션은 대/소문자를 구분하지 않는다.

두번째 파라미터에는 java.lang.ClassLoader, java.net.Socket 등의 주요 자바 클래스를 포함하고 있는 자바 라이브러리 파일의 위치를 지정한다. 선의 JVM을 사용하는 경우에는 주로 JAVA_HOME/lib/rt.jar 파일이다.

LWST 빌드를 통해서 JDBC, 자바 쓰레드, 클래스로더 등의 모니터링 여부를 결정할 수 있다. 이를 LWST 빌드 패치 옵션이라고 한다. 이 옵션은 lwst40.sh 파일을 직접 수정해서 설정해야 한다.

다음은 lwst40.sh 파일에서 LWST 빌드 패치 옵션과 관련한 부분이다.

OPT="$OPT -Dbuild_jdbc=true"
OPT="$OPT -Dbuild_classloader=true"
OPT="$OPT -Dbuild_thread=false"
OPT="$OPT -Dbuild_collection=false"
#OPT="$OPT -Dtype_collection=TRU64"
#OPT="$OPT -Dbuild_collection_map=false"
#OPT="$OPT -Dbuild_collection_list=false"
OPT="$OPT -Dbuild_file=true"
OPT="$OPT -Dbuild_socket=true"
OPT="$OPT -Dbuild_xml=true"

다음은 각 옵션에 대한 설명이다.

LWST 적용 과정에서 주의 사항

LWST로 프로파일 등을 수행할 때 다음의 사항에 주의한다.

크기가 큰 JSP 파일을 프로파일링하면 부하가 발생할 수 있다.

JSP 파일도 운영시에는 WAS에 의해서 클래스 파일로 전환되는데, 이 클래스를 LWST로 프로파일링할 수 있다. 그런데 크기가 약 2 MB 이상의 JSP 파일을 프로파일링하면 CPU 사용률이나 메모리 사용량이 높아질 수 있다.

제니퍼 에이전트에는 이를 방지하기 위한 옵션이 존재한다. 제니퍼 에이전트의 hook_class_max_size 옵션으로 설정한 크기 이상의 클래스에 대해서는 BCI를 하지 않는다. 기본 값은 1048576(1mb)이고 단위는 바이트이다.

hook_class_max_size = 1048576

만약 이 옵션으로 설정한 크기보다 큰 클래스를 프로파일링하면 LWST 로그 파일에 'too big class[class name] len nnn bytes'라는 메세지가 출력된다. BCI 부하에 대한 염려가 없는 경우에는 이 값을 늘려 줄 수 있다.

Data Transfer Object로 java.util.ArrayList 등과 같은 콜렉션 클래스를 사용하는 경우에, 콜렉션 모니터링을 하면 부하가 발생할 수 있다.

예외적으로 보고된 현상으로 java.util.HashMap, java.util.ArrayList 클래스 등을 Data Transfer Object로 사용하고 있는 경우에, 콜렉션 모니터링을 하면 자바 가비지 콜렉션이 빈번하게 일어나는 등의 부하가 발생할 수 있다.

자바 1.5 이상에서 LWST 빌드 COMMAND 옵션으로 JDK15를 사용하지 않으면 중복 Instrumentation이 발생한다.

기본적으로 제니퍼는 클래스로더를 패치하여 BCI를 수행한다. 그러나 자바 1.5 이상에서 는 javaagent 기능을 사용한다.

따라서 자바 1.5 이상에서 LWST 빌드를 할 때는 COMMAND 옵션으로 JDK15를 지정하여 java.lang.ClassLoader 클래스를 패치하지 않아야 한다. 만약 이렇게 하지 않으면서 javaagent 옵션에 lwst.javaagent.jar 파일을 설정하면, LWST 로그 파일에 중복 Instrumentation이 시도되었다는 경고 메세지가 기록된다.

[WARNING] Dupplicated instrumentation!!

중복 Instrumentation으로 인해 버그가 발생하지는 않지만, 자바 1.5 환경에서 기능 제약이 발생할 수 있다. 따라서 JDK15 옵션으로 LWST 빌드를 다시 하도록 한다.

그리고 어떤 방식으로 Instrumentation 모듈이 초기화가 되는지를 로그 파일에서 확인할 수 있다.

• lwst.javaagent.jar 파일에 의한 Instrumentation 모듈 초기화

[INF] -javaagent used!!

• lwst.jdk.jar 파일에 의한 Instrumentation 모듈 초기화

[INF] The instrumentation mode is for java14/java13!!

제니퍼 에이전트 유틸리티

제니퍼 에이전트 설치 과정에서 유용하게 사용할 수 있는 유틸리티에 대해서 설명한다.

클래스 FINDER

클래스 FINDER는 클래스패스에서 클래스 정보를 검색하는 유틸리티이다. 이 유틸리티는 JENNIFER_HOME/agent 디렉토리에 존재한다.

finder.sh [mode] [classpath] [target]

다음은 옵션에 대한 설명이다.

• [mode] 옵션에는 CALL, CLASS, SUPER, INTERFACE 중에 하나를 지정한다.

• [classpath] 옵션에는 jar 파일을 세미콜론(;)을 구분자로 하여 지정한다.

• [target] 옵션에는 찾고자 하는 클래스나 메소드 정보를 지정한다.

rt.jar 파일에서 java.lang.Thread 클래스의 sleep 메소드를 호출하는 클래스는 다음과 같이 검색한다.

finder.sh CALL /usr/java/jre/lib/rt.jar java.lang.Thread.sleep

rt.jar 파일에서 클래스와 상관없이 sleep 메소드를 호출하는 클래스는 다음과 같이 검색한다.

finder.sh CALL /usr/java/jre/lib/rt.jar *.sleep

rt.jar 파일에서 java.lang.Thread 클래스를 사용하는 클래스는 다음과 같이 검색한다.

finder.sh CALL /bin/java/jre/lib/rt.jar java.lang.Thread.*

rt.jar 파일에서 java.lang.Thread 클래스를 찾으려면 다음과 같이 검색한다.

finder.sh CLASS /usr/java/jre/lib/rt.jar java.lang.Thread

rt.jar 파일에서 getConnection 메소드를 가지고 있는 클래스를 찾으려면 다음과 같이 검색한다.

finder.sh METHOD /usr/java/jre/lib/rt.jar getConnection

rt.jar 파일에서 java.lang.Thread 클래스의 하위 클래스를 찾으려면 다음과 같이 검색한다.

finder.sh SUPER /usr/java/jre/lib/rt.jar java.lang.Thread

rt.jar 파일에서 java.lang.Runnable 인터페이스를 구현한 클래스를 찾으려면 다음과 같이 검색한다.

finder.sh INTERFACE /usr/java/jre/lib/rt.jar java.lang.Runnable

JSP 유틸리티

JENNIFER_HOME/agent/tunning 디렉토리에는 제니퍼 에이전트 설치와 관련한 오류를 파악하는데 사용할 수 있는 JSP 파일이 존재한다. 이 JSP 파일들을 WAS에 복사하여 실행시킨다.

다음은 각 JSP 파일에 대한 설명이다.