Skip to main content

JVM JMX

Monitoring Connector Assets​

Monitored Objects​

The Pack JVM JMX collects metrics for:

  • Class
  • Gc
  • Memory
  • System (cpu, load-average, fd)
  • Threads

Collected Metrics​

Metric nameDescriptionUnit
class.loaded.current.countCurrent number of classes loaded
class.loaded.countNumber of classes loaded
class.unloaded.countNumber of classes unloaded

Prerequisites​

Please install jolokia agent on your JVM Jolokia download page. Ask to your admin to deploy it and give you the URL.

Setup​

  1. Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Applications-Jvm-Jmx
  1. On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the JVM JMX Pack

Host configuration​

  • Add a new Host and apply the App-Jvm-JMX-custom Host Template

Once the template applied, some Macros have to be configured:

MandatoryNameDescription
XJOLOKIAURLJolokia URL (eg: http://jvm.centreon.com:8080/jolokia)
JOLOKIAUSERNAMEJolokia user name
JOLOKIAPASSWORDJolokia password
JOLOKIAEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

How to test the Plugin and what are the main options for?​

Once the Plugin installed, log into your Poller using the centreon-engine user account and test by running the following command (Parameters such as url have to be adjusted):

/usr/lib/centreon/plugins/centreon_jvm_jmx.pl \
--plugin=apps::java::jvm::jmx::plugin \
--mode=class-count \
--url='http://jvm.centreon.com:8080/jolokia' \
--verbose

Output example:

OK: Class current: 3009, loaded: 0, unloaded: 0 | 'class.loaded.current.count'=3009;;;0; 'class.loaded.count'=0;;;0; 'class.unloaded.count'=0;;;0;

The command above monitors JVM class usage (--mode=class-count). It uses the URL (--url='http://jvm.centreon.com:8080/jolokia') to connect.

All the options that can be used with this plugin can be found over the --help command:

/usr/lib/centreon/plugins/centreon_jvm_jmx.pl \
--plugin=apps::java::jvm::jmx::plugin \
--mode=class-count \
--help

Troubleshooting​

Troubleshooting plugins