πŸ“¦ Jolokia Python Client
Python Java
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
debian Project setup Sep 22, 2011
docs wide logo Sep 27, 2013
java normalized trailing whitespace Sep 27, 2013
project.d πŸ”€ moved information out of pavement Mar 26, 2015
src πŸ”€ added future imports + coding; fixed pylint problems Mar 27, 2015
.env
.gitignore
.project Eclipse / pydev project config Nov 3, 2011
.pydevproject Eclipse / pydev project config Nov 3, 2011
.travis.yml imported py-generic-project af437de (2015-03-25) Mar 26, 2015
CONTRIBUTING.md imported py-generic-project af437de (2015-03-25) Mar 26, 2015
LICENSE normalized trailing whitespace Sep 27, 2013
MANIFEST.in imported py-generic-project af437de (2015-03-25) Mar 26, 2015
README.md readthedocs.io May 8, 2016
_pavement_py πŸ”€ get old pavement.py out of the way Mar 27, 2015
dev-requirements.txt imported py-generic-project af437de (2015-03-25) Mar 26, 2015
requirements.txt imported py-generic-project af437de (2015-03-25) Mar 26, 2015
setup.cfg imported py-generic-project af437de (2015-03-25) Mar 26, 2015
setup.py imported py-generic-project af437de (2015-03-25) Mar 26, 2015
tasks.py imported py-generic-project af437de (2015-03-25) Mar 26, 2015
test-requirements.txt
tox.ini imported py-generic-project af437de (2015-03-25) Mar 26, 2015

README.md

jmx4py

Logo

A Python Client for the Jolokia JMX Agent

β€ˆTravis CI β€ˆGitHub Issues β€ˆLicense β€ˆDevelopment Status β€ˆLatest Version β€ˆDownload format β€ˆDownloads

Overview

Jolokia is a JMX-HTTP bridge giving an alternative to JSR-160 connectors. It is an agent based approach with support for many platforms. In addition to basic JMX operations it enhances JMX remoting with unique features like bulk requests or fine grained security policies.

jmx4py offers a client API similar to the existing Jolokia clients for Perl (jmx4perl), Java and Javascript. Additionally, it'll build upon the basic API and offer further features related to monitoring and controlling JVMs via JMX using Python.

Setup

To create a working directory for this project, follow these steps on a POSIX system:

git clone "https://github.com/jhermann/jmx4py.git"
cd "jmx4py"
. .env --yes --develop
invoke build --docs test check

The .env script creates a virtualenv and installs the necessary tools into it. See the script for details.

Now you can explore the API by simply issuing the following command:

invoke explore

For that to succeed, you must also have a working Java + Maven environment, since a small test application is built and then started in the background, so you can work against a live JVM.

See CONTRIBUTING for more.

Installation

TODO: pip install / dh-virtualenv

Usage

jmx4py offers the following command line tools... TODO

For using jmx4py from Python, consult the API documentation available at TODO

Known Limitations & Issues

  • The API is subject to change for 0.x, until enough practical experience is gained.
  • Only Jolokia 1.0 and up (Protocol v6) is supported.
  • GET requests aren't supported.
  • Bulk requests aren't supported.
  • Python 2.7 is used for development, and 2.7 and 3.4 are tested in continuous integration.

References

Project

Tools

Packages

Acknowledgements

…