모니터링 운영관리 도구 설치가이드

서버가 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 속성 정의

모니터링 운영관리 도구의 Main 화면에서 보여지는 어플리케이션 모니터링 항목의 임계치는 infrared-web.properties에서 관리하고 있다.
따라서 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

모니터링 운영관리 도구에 필요한 정보를 저장하거나 관리하기 위해 표에서 나열된 Database 테이블 생성 Script를 제공하고 있다. dbscript.zip다운로드

• HSQLDB 는 데이타베이스를 이용할 수 없는 제약환경에서 3-4시간 한시적인 테스트 용도로 사용할 것을 권장하며, 그 이상 사용하고자 한다면 HSQLDB이외의 Database에 테이블을 생성하여 모니터링 운영관리 도구를 설치하기를 권장한다.

globals.properties 파일을 수정한다.

Globals.DbType = oracle

모니터링 대상서버를 등록하기 위해서 MBean 에이전트는 대상 서버의 컨테이너 정보를 요구하며, 어플리케이션 에이전트는 구현된 어플리케이션 설치 위치까지 지정해 주어야 한다.
따라서, 서버등록, 컨테이너 등록, 어플리케이션 등록을 순차적으로 실행하여야 한다.

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

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

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

모니터링 환경은 대상서버의 MBean 에이전트가 운영관리 도구에 전송할 정보(Cpu, memory,Thread,Session,jdbc)의 모니터령 여부와 전송주기, 임계치 설정 등의 기능과 어플리케이션 에이전트 property 경로, 각 layser별 모니터링 여부 및 전송주기 등을 설정하는 기능을 제공한다.

* Mbean 에이전트 설정참조

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

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

MBean은 JMX에 제시된 표준에 따라 구현해야 하나, 벤더별 JDK, WAS에 따라서 일부 서비스의 Mbean export 명이 달라, 동일한 서비스 정보(예:cpu 사용현황)를 갖고 오기 위해서 각 JDK나 WAS별로 제공하는 표준화되지 않은 export 명을 사용하여야 한다.
따라서, 표준화된 export 명이 아닌 경우는 mbean.properties 파일에 jdk별, was별로 MBean export 명을 정의하여 운영관리도구에서 데이타 수신시 mbean.properties 에 정의된 export 명을 참조하여 각각을 구분하여 데이타를 수신하도록 구성하였다.

모니터링 대상 서버가 정상적으로 모니터링 되지 않을 때는 원인을 찾기 위해 아래와 같은 방식으로 확인한다.

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

JAVA SDK에 내장된 jconsole.exe를 실행하고 “Advanced” 탭 JMX URL란에 “service:jmx:rmi:///jndi/rmi://서버IP:RMI포트/jmxrmi” 입력하여 접속 후 테스트 수행한다. 접속이 되지 않는다면 WAS의 RMI 서비스가 작동중인지, 설정이 정상적으로 되었는지 확인해 본다.

모니터링 도구에서 모니터링 대상 서버의 데이터를 수집하기 위해 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폴더로 이동해야 한다. ( Ex. javaee.jar, clientcontainer.jar, jclient.jar )

*WAS 별 Wide Library

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