|
Instance Manager |
|
|
|
|
Instance Manager |
|
|
Instance Manager
|
Instance Manager |
|
|
|
|
Instance Manager |
|
|
관리대상 인스턴스에 대한 설정 화면으로 인스턴스 설명 및 색상등의 서버 설정과 에이전트의 설정을 관리 할수 있다.
Elevisor 서버는 Oracle 및 J2EE 엔진을 동시에 활성화 하여 사용할 수가 있는데 이 경우 J2EE Tab을 선택한다.
| □ | 설정 항목 구분 |
v Elevisor 서버 환경 설정
"인스턴스 정보" Tab은 서버의 환경 설정이므로 에이전트와의 접속 없이 관리된다.
v 에이전트 환경 설정
"인스턴스 정보" Tab을 제외하고는 에이전트 환경 설정이다.
따라서 에이전트 와 TCP/IP 통신을 통하여 관리되기 때문에 WAS 가 기동중인 상태여야 하며 방화벽에서 해당 포트를 차단할 경우 관리가 불가능하다.
| □ | 서버 설정 - 인스턴스 정보 |
인스턴스 정보 관리는 트레이스 보관주기(일), 인스턴스 설명, 색상 등을 관리 할수 있다.
v 항목 설정(파란색 항목)
| - Trace Retention | : Trace 보관 주기를 설정한다.(단위:일) |
| - Color# | : 컨테이너의 색상을 직접 입력 |
| - Color | : Color Picker를 통하여 색상을 입력 |
| - Instance ID | : 타 시스템과 이벤트 연동시 매핑용 ID 용도로 입력 |
| - URL Truncate(ms) | : URL 저장시 응답시간이 설정된 시간 이하인 경우 저장 안함. |
| - SQL Truncate(ms) | : SQL 저장시 응답시간이 설정된 시간 이하인 경우 저장 안함. |
| - Description | : 컨테이너 설명 |
v 인스턴스 삭제
인스턴스 목록에서 삭제하려는 인스턴스를 선택한 후 삭제 버튼을 클릭하면 해당 인스턴스 정보가 삭제 된다.
이때 통계 데이타는 삭제 되지 않는다.
| □ | 에이전트 설정 - 에이전트 공통 |
에이전트에서 기본 설정항목으로 초기 설치시 셋팅하는 항목이므로 임의 수정을 하지 않는 것이 좋다.
v 서버 설정
- 서버 IP
Elevisor 서버가 설치된 IP
- Common UDP Port
Elevisor 서버에서 Agent로의 성능데이터 전송용 UDP 포트
- Trace UDP Port
Elevisor 서버에서 Agent로의 트레이스 데이터 전송용 UDP 포트
v 에이전트 설정
- 에이전트명
에이전트명( 영문 4글자 )
- TCP/IP Port
서버에서 에이전트로의 접속을 위한 TCP/IP 포트
- Encoding
에이전트에서 수집한 성능데이터를 서버로 전송시 인코딩
- Agent Enable
에이전트 동작 여부를 설정
| □ | 에이전트 설정 - 트레이스 |
에이전트에서 성능데이터 수집을 위한 트레이스 설정항목으로 대부분의 항목이 설정 변경시 즉시 적용된다.
v 트레이스 공통
- 트레이스
트레이스 동작 여부를 설정한다.
- AP 클래스 트레이스
AP Class에 대한 트레이스 여부를 설정한다.
- 트레이스 길이제한
최대 트레이스 길이를 설정한다. 트레이스중 이 값을 초과하면 트레이스를 중단하여 과도한 트레이스에 따른 성능저하를 방지한다.
- 트레이스 응답시간 필터
트레이스시 지정된 응답시간 이하의 트레이스는 트레이스에서 제외시킨다. 이를 통하여 불필요한 트레이스 및 성능저하를 방지할수 있다.
- URL Query 문자열 길이제한
URL의 Query String의 길이를 지정된 값으로 제한하는 기능으로서 과도한 Query String 수집을 방지한다.
v JDBCs
- JDBC 트레이스
JDBC 관련 항목에 대한 트레이스 여부를 설정한다.
- 커넥션 미반환 트레이스
JDBC 커넥션 미반환 트레이스 여부를 설정한다.
- 커넥션 Wapper Class ( WAS 재기동시 적용 )
JDBC 커넥션 풀에서 getConnection시 Return 되는 클래스를 지정하며 비활성화가 되어 있어 에이전트 환경 설정 파일을 열어 직접 수정해야 한다.
getConnection 후에 Pool에 반환하는 close 메소드를 추적하기 위한 기능으로서 미설정시 Connection Leak으로 인식된다.
기본적으로 Weblogic, JEUS, DBCP Connection 클래스가 등록되어 있으며 추가를 위해서는 트레이스 트리에서 getConnection의 Return값의 클래스 명을 참조하여 추가한다.
v IO 트레이스
- Socket I/O 트레이스
TCP/IP 기반의 Socket I/O 트레이스 여부를 설정한다.
- JDBC Socket I/O 트레이스
DB와의 Socket I/O 정보를 트레이스 할지 여부를 설정한다.
Socket I/O 트레이스가 설정 되어 있어야 동작한다.
- File I/O 트레이스
File I/O 트레이스 여부를 설정한다.
v 캡쳐 설정
- 파라미터 값 캡쳐
메소드 호출시의 첫번째 파라미터 값에 대한 캡쳐 여부를 설정한다.
- 리턴값 캡쳐
메소드 수행후 리턴되는 값에 대한 캡쳐 여부를 설정한다.
- 캡쳐 문자열 최대 길이
캡쳐되는 파라미터나 리턴값에 대한 과도한 캡쳐를 방지하기 위하여 길이를 제한하는 값이다.
v 기타
- Exception 트레이스
Exception/Error 발생에 대한 트레이스 여부를 설정한다.
- 무시할 Exception
의미 없는 Exception일 경우 등록하여 트레이스에서 제외 시킨다.
- 무시할 URL 확장자
등록된 URL 패턴에 대하여 정보를 수집하지 않는다.
| □ | 에이전트 설정 - 서비스 제어 |
v 서비스 제어
- 서비스 덤프
액티브 서비스 임계치 초과시 서비스 덤프를 수행할지 여부를 설정한다.
- 스레드 덤프 ( JDK 1.5 이상에서만 동작 )
액티브 서비스 임계치 초과시 스레드 덤프를 수행할지 여부를 설정한다.
- 덤프 임계치
덤프를 위한 액티브 서비스의 임계치를 설정한다.
- 덤프 주기
덤프 임계치 초과시 덤프 수행 주기 설정
| □ | 에이전트 설정 - 로깅 |
v 로깅 설정
- 액세스 로그 로깅
액세스 로그를 기록할지 여부를 설정한다.
"$ELEVISOR_AGENT_HOME/log/access" 경로에 "인스턴스명_access_yyyymmdd.log" 파일에
"YYYY/MM/DD HH:MM:SS, Client IP, Responce Time, Cpu Time, URL" 포멧으로 로깅된다.
- 로딩 클래스 리스트 로깅
로딩되는 클래스 목록을 로깅할지 여부를 설정한다.
"$ELEVISOR_AGENT_HOME/log/class" 경로에 "YYYY-MM-DD_hh--mm-ss_load_classes_인스턴스명.txt" 파일에
"클래스명, 클래스로더" 포멧으로 로깅된다.
- 로딩 클래스 로깅 필터
클래스 목록에 로깅하지 않을 패턴을 설정한다.
패키지명의 prefix 형태의 패턴을 등록하며 에이전트 환경설정 파일을 열어 직접 편집해야 한다.
( 기본 설정은 유지하는 것이 좋다. )
| □ | 에이전트 설정 - Byte Code Instrument |
Byte Code Instrument 대상을 설정하면 해당 클래스 로딩시에 모니터링을 위한 코드가 동적으로 삽입되게 된다.
따라서 AP 클래스에 대한 모니터링 대상을 지정하여 트레이스 할수 있다.
AP클래스가 "WEB-INF/classes" 위치에 존재하는 경우 "Webapp 클래스 Instrument"만 설정하는것 만으로 트레이스 대상에 포함 시킬수 있다.
v Byte Code Instrument 설정( WAS 재기동시 적용 )
- Webapp 클래스 Instrument
JAR파일 내의 클래스가 아닌 "WEB-INF/classes" 에서 로딩되는 클래스에 대한 Instrument 여부를 설정한다.
Instrument 대상 클래스는 트레이스 대상 클래스가 된다.
- 클래스 Prefix
Instrument 대상 클래스에 대한 prefix를 지정한다.
"com.elevisor." 형식으로 지정할수 있다.
- 클래스 필터 패턴
Instrument 대상에서 제외할 패턴을 지정한다.
Util나 XML 파싱관련 클래스의 경우 루핑 작업이 많기 때문에 모니터링 대상에서 제외하는 것이 좋다.