모니터링 도구 설치가이드

서버가 Tomcat일 경우 war파일 배포방법은 다음과 같다.

[CATALINA_HOME]\webapps 폴더 하위에 다운로드한 monitoring-web.war 파일을 복사한다.

Tomcat 서버를 기동하면 자동으로 monitoring-web.war가 배포되며 [CATALINA_HOME]\webapps\monitoring-web 폴더가 생성된다.

Tomcat이외의 어플리케이션 서버의 배포방법에 대해서는 해당 어플리케이션 서버의 메뉴얼을 참고한다.

• Web.xml 에 init Servlet 정의

    <servlet>
       <servlet-name>EgovMBCManagerServlet</servlet-name>
       <servlet-class>egovframework.oe2.svr.mbean.mbeanmanager.service.EgovMBCManagerServlet</servlet-class>
       <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet>
       <servlet-name>infraRedListenerServlet</servlet-name>
       <servlet-class>egovframework.oe2.svr.collector.base.InfraRedListenerServlet</servlet-class>
       <init-param>
          <param-name>port</param-name>
          <param-value>7777</param-value>
       </init-param>
       <init-param>
	  <param-name>resetCacheInterval</param-name>       
          <param-value>1800</param-value>
	</init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>infraRedListenerServlet</servlet-name>
        <url-pattern>/infraRedListenerServlet</url-pattern>
    </servlet-mapping>
    <servlet>
        <servlet-name>AgentManagerServlet</servlet-name>
        <servlet-class>egovframework.oe2.agt.aggregator.base.AgentManagerServlet</servlet-class>
    </servlet>
 
    <servlet-mapping>
        <servlet-name>AgentManagerServlet</servlet-name>
        <url-pattern>/AgentManagerServlet</url-pattern>
    </servlet-mapping>

• JEUS 일 경우 rmiRegistery 등록

JEUSMain.xml

<engine-container>
    <command-option> 
        -Djeus.jndi.rmi.useRmiRegistry=true -Dsun.rmi.transport.tcp.connectionPool=true
    </command-option>

• classes 폴더에 infrared-web.properties 속성 정의

어플리케이션 모니터링데이타 저장주기 및 어플리케이션 모니터링 항목에 대한 임계치를 조정한다.

<표 1.1.1 모니터링 서버 속성>

위의 기본값을 포함하고 있는 설정파일 infrared-web.properties의 내용은 다음과 같다.

	#The sample infrared-web.properties
	persist-interval=30000
	threshold.http=3000
	threshold.application=3000
	threshold.jdbc=3000
	threshold.sql=2000

• HSQLDB 는 데이타베이스를 이용할 수 없는 제약환경에서 3-4시간 한시적인 테스트 용도로 사용할 것을 권장한다.

globals.properties 파일을 수정한다.

Globals.DbType = oracle

모니터링 대상 서버의 정보를 등록한다. 서버 등록참조

모니터링 대상 컨테이너 정보를 등록한다. 컨테이너 등록참조

모니터링 대상 어플리케이션 정보를 등록한다. 어플리케이션 등록참조

* Mbean 에이전트 설정참조

* 어플리케이션 에이전트 설정참조

모니터링 도구는 모니터링 대상 서버에 노출되어 있는 MBean에 접속하여 데이터를 가져오는 Mechanism으로 구성되어 있어 정보를 갖고 오기 위해서는 노출된 MBean 명을 알아야 한다.

MBean은 JDK, WAS에 따라서 export 명이 다를 수 있는데 모니터링 서버 개발 시 유연하게 사용하기 위하여 최대한 시스템에 정의된 export 명을 사용하도록 하였으며 JDK 버전에 따라서 export명이 다른 경우(예:Garbage Collection)거나 WAS에서 동일한 패턴의 export 명을 사용하는 경우 mbean.properties 파일에 MBean export 명을 정의 하였다.

모니터링 대상 서버가 정상적으로 모니터링 되지 않을 때는 아래와 같은 방식으로 확인 가능하다.

jconsole에 Server IP 및 RMI Port 등을 정확히 입력하고 접속이 가능하지 확인해본다.

JAVA SDK에 내장된 jconsole.exe를 실행하고 “Advanced” 탭 JMX URL란에 “service:jmx:rmi:///jndi/rmi://서버IP:RMI포트/jmxrmi” 입력하여 접속 후 테스트 수행한다.

모니터링 도구에서 프레임워크 모니터링 데이터를 수집하기 위해 Mbean export name을 사용한다. 현재까지 테스트 된 환경을 통해 수집된 default export name을 모니터링 도구에서 사용하고 있다.

Mbean export name

프레임워크 모니터링 항목에 해당하는 각각의 export name을 알기 위해서는 JConsole이나 POJO 프로그램을 이용한다. JConsole을 사용하거나 POJO 프로그램을 이용하여 모니터링 대상 서버에 export 된 MBean List를 획득 후 default export MBean 명과 비교해보고, 제공하는 MBean export 명이 다른 경우 MBean.properties 파일을 수정하여야 한다.

2-1. Jconsole 을 이용하여 JVM에 노출된 MBean Export Name 확인하는 방법

2-2. Java POJO 프로그램을 이용하여 WAS에 노출된 Export Name 확인하는 방법

POJO 실행명령
javac -classpath .:[was library|none] JvmMBean.java
java -classpath .:[was library|none] JvmBean 127.0.0.1 8992

import java.io.IOException;
import java.lang.management.ManagementFactory;
import java.util.Hashtable;
import java.util.Iterator;
import java.util.Set;
 
import javax.management.AttributeNotFoundException;
import javax.management.InstanceNotFoundException;
import javax.management.MBeanException;
import javax.management.MBeanServerConnection;
import javax.management.MalformedObjectNameException;
import javax.management.ObjectInstance;
import javax.management.ObjectName;
import javax.management.ReflectionException;
import javax.management.remote.JMXConnector;
import javax.management.remote.JMXServiceURL;
import javax.naming.InitialContext;
import javax.naming.NamingException;
 
public class JvmMBean
 {
    public static void main(String[] args) throws IOException, 
                  NamingException, MalformedObjectNameException, 
                  NullPointerException, InterruptedException {
 
        // args[0] : server IP
        // args[1] : rmi port 
        JMXServiceURL url = new JMXServiceURL("service:jmx:rmi:///jndi/rmi://"+args[0]+":"+args[1]+"/jmxrmi");
 
        JMXConnector conn = javax.management.remote.JMXConnectorFactory.connect(url, null); 
        MBeanServerConnection mbsc = conn.getMBeanServerConnection();    
        Set jvmMBean = mbsc.queryMBeans(null, null);
 
        for (Iterator i = jvmMBean.iterator(); i.hasNext();) {
              ObjectName objName = ((ObjectInstance) i.next()).getObjectName();
              System.out.println("[JMX MBean] " + objName);      
        }
    }
}

JVM, JEUS, JBoss, Tomcat, WebLogic Export Name 확인을 위한 POJO 프로그램: mbean_pojo.zip

✔ 주의: JDK 또는 WAS에 모니터링 대상 항목을 아예 노출하지 않은 경우 즉, MBean Export 항목 없을 경우에는 모니터링 할 수가 없으므로 대상에서 제외하여야 한다.

현재 테스트 된 WAS는 아래와 같으며 war파일에도 이와 동일한 버전의 Library가 포함되어 있다. 위의 jconsole, MBean POJO 테스트를 수행하고도 모니터링이 비정상적으로 수행 될 경우 버전에 맞는 Library를 사용하기를 권장한다.

✔ 주의: 모니터링 운영 서버는 같은 WAS의 서로 다른 버전을 모니터링 하는 경우 즉 JEUS 5.0, JEUS6.0 등이 혼재된 상황에서는 수행이 되지 않는다.

웹 어플리케이션 서버 기동시 jarfile is not loaded 라는 에러 메시지가 나오면 해당 라이브러리를 Wide Library폴더로 이동해야 한다.

*WAS 별 Wide Library

Java Remote Method Invocation 1.5.0 Specification
JSR-000154 JavaTM Servlet 2.4 Specification