[CONF] Apache MINA: JMX Integration (page edited)

confluence Mon, 02 Mar 2009 22:40:37 -0800

Page Edited : MINA : JMX Integration

JMX Integration has been edited by Ashish Paliwal (Mar 02, 2009).

Change summary:

Updated for 2.0 M4

Content:

Java Management Extensions (JMX) is used for managing and monitoring java applications. This tutorial will provide you with an example as to how you can JMX-enable your MINA based application.

This tutorial is designed to help you get the JMX technology integrated in to your MINA-based application. In this tutorial, we will integrate the MINA-JMX classes into the imagine server example program.

Version Note
This tutorial has been verified on MINA 2.0 M4

Adding JMX Support

To JMX enable MINA application we have to perform following

Create/Get MBean server
Instantiate desired MBeans (IoAcceptor, IoFilter)
Register MBeans with MBean server

We shall follow \src\main\java\org\apache\mina\example\imagine\step3\server\ImageServer.java, for the rest of our discussion

Create/Get MBean server

// create a JMX MBean Server server instance
MBeanServer mBeanServer = ManagementFactory.getPlatformMBeanServer();

This lines get the MBean Server instance.

Instantiate MBean(s)

We create an MBean for IoService

// create a JMX-aware bean that wraps a MINA IoService object.  In this
// case, a NioSocketAcceptor. 
IoServiceMBean acceptorMBean = new IoServiceMBean( acceptor );

This creates an IoService MBean. It accepts instance of an acceptor that it exposed via JMX.

Similarly, you can add IoFilterMBean and other custom MBeans as well

Registering MBeans with MBean Server

 // create a JMX ObjectName.  This has to be in a specific format.  
 ObjectName acceptorName = new ObjectName( acceptor.getClass().getPackage().getName() +
            ":type=acceptor,name=" + acceptor.getClass().getSimpleName());
        
 // register the bean on the MBeanServer.  Without this line, no JMX will happen for
 // this acceptor.
 mBeanServer.registerMBean( acceptorMBean, acceptorName );

We create an ObjectName that need to be used as logical name for accessing the MBean and register the MBean to the MBean Server. Our application in now JMX enabled. Lets see it in action.

Start the Imagine Server

Java Version Note
Depending on the version of Java you are using, your command line arguments may be different.

If you are using Java 5 or earlier:

java -Dcom.sun.management.jmxremote -classpath <CLASSPATH> org.apache.mina.example.imagine.step3.server.ImageServer

If you are using Java 6:

java -classpath <CLASSPATH> }}{{{}org.apache.mina.example.imagine.step3.server.ImageServer

Start JConsole

Start JConsole using the following command:

<JDK_HOME>/bin/jconsole

We can see the different attributes and operations that are exposed by the MBeans

Powered by Atlassian Confluence (Version: 2.2.9 Build:#527 Sep 07, 2006) - Bug/feature request

Unsubscribe or edit your notifications preferences