Tomcat monitoring using_javamelody

1. Tomcat monitoring using
javamelody

2. Table of Contents
1. JavaMelody 소개 및 설치 ................................................................................................... ４
1.1. JavaMelody 개요 및 활용 방안........................................................................................ ４
기대 효과 ...................................................................................................................... ４
제공 지표(Indicators) ........................................................................................................ ４
요구 조건 ...................................................................................................................... ４
1.2. JavaMelody 설치 ........................................................................................................ ５
Jar 파일 복사.................................................................................................................. ５
web.xml 파일 변경 ........................................................................................................... ５
서버 모니터링 ................................................................................................................. ５
PDF 리포트 생성 .............................................................................................................. ６
추가 기능 ...................................................................................................................... ６
JavaMelody 모니터링.............................................................................................................. ７
모니터링 초기화면 .............................................................................................................. ７
세부 모니터링 항목 ............................................................................................................. ８

3. Document Overview
 Purpose
본 문서는 아파치 톰캣(Apache Tomcat) 서버를 오픈소스 모니터링 도구인 JavaMelody 를 이용해 모니터링하는
방안을 포함하고 있다.
 Scope
Servlet Container 의 성능 및 자원을 모니터링 하기 위한 도구에 대한 대한 소개 및 설치, 활용 방안.

4. 1. JavaMelody 소개 및 설치
Open source J2EE application monitoring 도구인 javamelody 에 대한 소개 및 설치 방법을 설명한다.
1.1. JavaMelody 개요 및 활용 방안
JavaMelody 의 목적은 Java/Java EE 어플리케이션 서버를 품질(QA) 및 운영 환경에서 모니터링하는 것이다.
사용자의 요청을 시뮬레이션(simulation)하는 툴이 아니라, 실제 어플리케이션의 수행 성능을 측정하고 통계를
산출하는 작업을 수행한다. JavaMelody 는 오픈 소스이며, 프로파일링(profiling)이나 데이터베이스를 사용하지
않는 경량(lightweight) 모니터링 도구이다.
자바 멜로디(JavaMelody)의 홈페이지 주소는 ‘http://javamelody.googlecode.com/’ 이다.
기대 효과
JavaMelody 가 활용함으로써 얻을 수 있는 효과는 다음과 같다.
 평균 응답 시간 및 온라인 서비스의 실제 수행 횟수 제공
 성능 저하가 발생하는 문제들을 도출하여 심각한 문제가 발생하기 이전에 의사결정을 지원
 응답 시간 측정을 통한 정확한 최적화 지원
 응답 지연의 근본 원인 파악 지원
 최적화 작업의 수행 성과를 측정 가능
제공 지표(Indicators)
요약 챠트(summary charts)를 통해 다음과 같은 지표들을 시간의 흐름에 따라 표현한다.
 수행 횟수, 평균 수행 시간, HTTP 요청 오류 발생 비율, SQL 수행 횟수
 JSF/JSP/struts actions/EJB/Spring/Guice 비즈니스 메소드 수행 횟수
 자바 메모리
 자바 CPU
 사용자 세션 수행
 JDBC 연결 수
일간, 주간, 월간, 연간 혹은 지정 기간 동안의 데이터 변화를 챠트에 출력할 수 있다.
요구 조건
JavaMelody 를 설치 및 사용하기 위해서는 다음과 같은 최소 사양이 필요하다.
 Java
: 최소 버전 1.5 이상, heap dump, memory histogram, stack trace 및 system load average 를 산출하기
위해서는 1.6 이상의 버전이 필요.
 Servlet Container
: servlet API 2.4 (java EE 1.4) 이상을 지원하는 서블릿 컨테이너(Servlet container)
(Tomcat 5.5 이상, jBoss 4 이상, WebLogic 9 이상)

5.  JRobin 자바 라이브러리 (jar)
: 챠트(chart) 출력을 위해 필수
 iText v2.1.x 자바 라이브러리 (jar)
: PDF 파일 출력을 위해 필요. (옵션)
 웹 브라우저
: 성능 리포트를 조회 하기 위해 크롬(chrome), 파이어폭스(firefox), 혹은 인터넷 익스플로러(version 9
이상) 필요.
1.2. JavaMelody 설치
설치에 필요한 시간은 10 분 이내에 불과하며, 2 개의 jar 파일을 복사하고 필요하다면 XML 10 라인 정도만
추가하면 된다. (환경 설정은 필요 없으며, 제반 환경 정보는 자동으로 수집된다. 기본 설치 후 추가 기능은 필요에
따라 추후에 설정을 변경하면 된다.
Jar 파일 복사
javamelody.zip 압축 파일을 해제한 후, javamelody.jar 및 jrobin-x.jar 파일을 모니터하고자 하는 웹
어플리케이션의 WEB-INF/lib 폴더에 복사하다. 혹은 Maven 을 사용한다면 javamelody-core
의존성(dependency)을 웹 어플리케이션의 pom.xml 파일에 추가한다.
web.xml 파일 변경
Servlet API 3.0 호환 가능한 웹 어플리케이션 서버(Tomcat 7, glassfish version 3, jBoss 6 등)를 사용 중이라면
web.xml 파일을 수정할 필요 없이 서버를 재기동하면 JavaMelody 를 사용할 수 있다. 만일, Servlet API 3.0 호환
서버임에도 web.xml 파일 내에 version="3.0" 선언이 없거나, Servlet API 3.0 을 지원하지 않는 WAS 를 사용한다면
web.xml 에 다음 내용을 추가해야 한다.
<filter>
<filter-name>monitoring</filter-name>
<filter-class>net.bull.javamelody.MonitoringFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>monitoring</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<listener>
<listener-class>net.bull.javamelody.SessionListener</listener-class>
</listener>
만일, Servlet API 3.0 웹 어플리케이션 내에 위 설정을 추가했다면, <async-supported>true</async-supported>
속성을 추가해야 비동기 요청을 처리(support)할 수 있다.
서버 모니터링
war 를 배포한 후, 서버를 재기동 하면 웹 브라우저를 이용해 서버 모니터링을 시작할 수 있다. 웹 브라우저를
이용해 아래 URL 에 접속하면 된다.
http://<host>/<context>/monitoring
<host>는 웹 어플리케이션이 배포된 서버 주소이며 뒤에 포트 번호가 추가될 수 있다. (ex: localhost:8080)
<context> 는 웹 어플리케이션의 컨텍스트 명칭(context name)이다.

6. PDF 리포트 생성
HTML 뿐만 아니라 PDF 리포트를 생성하기 위해서는 iText v2.1.x (LGPL 혹은 MPL 라이센스이며, iText jar 파일
단독으로 사용할 수 있고 의존적인 jar 라이브러리는 없음)가 필요하다. javamelody.zip 파일 내의 src/test/test-
webapp/WEB-INF/lib/ 폴더에 있는 itext-2.1.7.jar 파일을 모니터 대상 웹 어플리케이션의 WEB-INF/lib 폴더에
복사하면 된다. iText 라이브러리를 추가한 후 WAS 를 재기동하면 HTML 리포트 상단에 PDF 링크가 추가된다.
추가 기능
JavaMelody 의 세부 기능을 활용하고자 할 경우에는 아래 웹 문서를 참조하면 된다.
https://code.google.com/p/javamelody/wiki/UserGuide

7. JavaMelody 모니터링
모니터링 초기화면
JavaMelody 모니터링 초기 화면 예시는 다음과 같다.

8. 세부 모니터링 항목
모니터링 화면에 포함된 항목들은 다음과 같다.
1. 기본 정보
웹 페이지 최상단에 모니터링 정보 출력 시갂 및 machine name 이 출력된다.
2. 업데이트/PDF 다운로드/구갂 설정 등
모니터링 정보 업데이트, PDF 다운로드, 통계 구갂 설정 등의 버튼이 표시된다.
3. 차트(Charts)
사용 메모리, HTTP session, 스레드, JDBC 연결,분당 HTTP 요청 횟수, HTTP 평균 응답 시갂, 에러 횟수, 분당
SQL 수행 횟수, SQL 평균 처리 시갂, SQL 오류 건수 등의 통계 차트가 표시되며 각 차트를 클릭하면 큰
화면으로 조회할 수 있다.

9. 4. HTTP 요청 통계
모티터링 대상 웹 어플리케이션 내에서 호출된 URL 들에 대한 통계가 테이블(표) 형태로 출력된다.
5. SQL 통계
지정된 기갂 동안 발생한 SQL 쿼리 통계가 출력된다.
6. HTTP 시스템 오류 통계
HTTP 시스템 오류 통계가 출력된다.
7. 시스템 오류 로그 통계
시스템 오류 로그에 대한 통계가 출력된다.
8. 실시갂 요청
실시갂으로 실행 중인 요청(request) 처리 내역이 출력된다.
9. 시스템 정보

10. WAS 가 실행 중인 장비에 대한 정보가 출력된다. ‘Details’ 링크를 클릭하면 보다 상세한 정보를 확인할 수
있다.
10. 스레드 정보
WAS 내에서 실행 중인 스레드 정보를 출력한다. ‘Details’ 링크를 클릭하면 보다 상세한 정보를 확인할 수
있다.