Monitoring with JMX
You can monitor your Hazelcast members via the JMX protocol.
To achieve this, first add the following system properties to enable the JMX agent:
-
-Dcom.sun.management.jmxremote -
-Dcom.sun.management.jmxremote.port=_portNo\_(to specify JMX port, the default is1099) (optional) -
-Dcom.sun.management.jmxremote.authenticate=false(to disable JMX auth) (optional)
Then enable JMX by setting the hazelcast.jmx property to true using
the following configuration:
<hazelcast>
...
<properties>
<property name="hazelcast.jmx">true</property>
</properties>
...
</hazelcast>hazelcast:
properties:
hazelcast.jmx: trueconfig.setProperty("hazelcast.jmx", "true");<hz:properties>
<hz: property name="hazelcast.jmx">true</hz:property>
</hz:properties>-Dhazelcast.jmx=trueMBean Naming for Hazelcast Data Structures
Hazelcast set the naming convention for MBeans as follows:
final ObjectName mapMBeanName = new ObjectName("com.hazelcast:instance=_hzInstance_1_dev,type=IMap,name=trial");The MBeans name consists of the Hazelcast instance name,
the type of the data structure and that data structure’s name.
In the above example, _hzInstance_1_dev is the instance name,
we connect to an IMap with the name trial.
Connecting to JMX Agent
One of the ways you can connect to JMX agent is using jconsole, jvisualvm (with MBean plugin) or another JMX compliant monitoring tool.
The other way to connect is to use a custom JMX client.
First, you need to specify the URL where the Hazelcast JMX service is running. See the following code snippet:
// Parameters for connecting to the JMX Service
int port = 1099;
String hostname = InetAddress.getLocalHost().getHostName();
JMXServiceURL url = new JMXServiceURL("service:jmx:rmi://" + hostname + ":" + port + "/jndi/rmi://" + hostname + ":" + port + "/jmxrmi");The port in the above example should be the one that
you define while setting the JMX remote port number (if different than the default port 1099).
Then use the URL you acquired to connect to the JMX service and
get the JMXConnector object. Using this object, get the MBeanServerConnection object.
The MBeanServerConnection object enables you to use the MBean methods.
See the example code below.
// Connect to the JMX Service
JMXConnector jmxc = JMXConnectorFactory.connect(url, null);
MBeanServerConnection mbsc = jmxc.getMBeanServerConnection();Once you get the MBeanServerConnection object,
you can call the getter methods of MBeans as follows:
System.out.println("\nTotal entries on map " + mbsc.getAttribute(mapMBeanName, "name") + " : "
+ mbsc.getAttribute(mapMBeanName, "localOwnedEntryCount"));