Skip to content
A simple command line too and Python module to query and collect Java metrics via JMX
Branch: master
Clone or download
dgildeh Merge pull request #13 from akki/patch-1
Use more Pythonic way to initialise attribute of JMXConnection
Latest commit 7e00e70 May 25, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
java Fixed parser tests May 15, 2018
python Use more Pythonic way to initialise attribute of JMXConnection May 15, 2019
.gitignore Ensure metric name/label tokens don't have quotes or spaces May 15, 2018 Updated root readme Feb 20, 2018


This project provides a command line tool written in Java and packaged as a Jar to allow you to connect to and query a JMX endpoint on a Java Virtual Machine.

The command line tool can be used standalone, or with the Python module also included in this project, if you want to provide a way to query JMX from Python.

This project was originally written in December 2014 and has been used in the Outlyer monitoring agent since to provide monitoring for JVM applications via Nagios plugins.

Outlyer plugins use the Jar via the Python module to query JVM metrics via JMX and provide those for dashboards and alerts on Outlyer.

However, this module can also be used standalone with any other monitoring tool that can run shell commands or include the Python module.

There are two folders under this repo:


This contains all the source to build and compile the Jar command line tool that connects to the JVM JMX endpoint.


This contains all the source to connect to the Jar with a simple to use Python class that handles all the communication via the command line.


Full instructions on how to run the JAR directly on the command line are provided under the Java folder. To use the Python module just use the pip installer:

pip install jmxquery

Note: The Python module only supports Python 3 at this time


This project is released under the MIT License so you are free to use it in your own projects. However contributions are welcome and can be made via a fork/PR for review.

Issues can also be raised in this repo if you find any, so please report them here for our attention.

You can’t perform that action at this time.