Accessing WildFly JMX Bus Remotely with novaordis-jmx

Internal

• novaordis-jmx
• WildFly and JMX

Overview

The WildFly JMX bus can be accessed programmatically using standard JMX remoting API, as described in the Remote Access to a JMX Server section. novaordis-jmx is a library that provides a thin layer of functionality in top of the client-side JMX remoting API, with the intention to facilitate programmatic JMX access to a remote JMX bus. Note that novaordis-imx is NOT necessary for programmatic JMX access, but its code introduces a certain degree of convenience, and it can be used as an example for direct use of the JMX remote API.

Classpath

JBoss 6 Classpath

JBoss 6 exposes the JMX bus over its remoting protocol, so the JMX client needs JBoss remoting support in its classpath, which is available in ${JBOSS_HOME}/bin/client/jboss-cli-client.jar.

java ... -cp ...:${JBOSS_HOME}/bin/client/jboss-cli-client.jar:...

URL

JBoss 6 URL

The URL that is being sent to the underlying JBoss remoting logic is service:jmx:remoting-jmx://localhost:9999.

Note that if using javax.management.remote.JMXServiceURL, only the "remoting-jmx" is needed as "protocol", the "service:imx" part is automatically prepended by the built-in logic:

JMXServiceURL jmxServiceURL = new JMXServiceURL("remoting-jmx", host, port);

API

JMXConnector jmxConnector = JMXConnectorFactory.connect(jmxServiceURL);

MBeanServerConnection mBeanServerConnection = jmxConnector.getMBeanServerConnection();

mBeanServerConnection.getMBeanCount();

...