Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Tool to export jmx data into file, cloudwatch, zabbix,...
Java Shell
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
.settings
src
.gitignore
LICENSE.txt
README.md
pom.xml
sample.properties

README.md

Tool to export jmx data into file,... JMX data can come from local JVM or a remote JVM

Usage

java -jar jmx-exporter xxx.properties ...

The application export data to stdout (System.out) and log into stderr (System.err), so common usage can be

java -jar jmx-exporter monitor0.properties 2> /tmp/jmx-monitor0.log 1> /tmp/jmx-monitor0.data

Some sample shell script are provide in the zip archive (jmx-exporter-X.Z-app.zip)

configuration

Configuration is read from property file (see sample.properties). If there are several configuration files, each configuration will run independently, so several application or several export can be run in a single run.

System properties can define and override any configuration define in property file, they can be used for shared configuration.

The minimal property to define is "jmx.metrics" that list info to retrieve.

with [CloudWatch]

with [CloudWatch] command line tool

Configure (in property file) the cloudwatch properties and set exporter exporter.class=com.mimesis.jmx.Exporter4CloudwatchCli

Integration with [Zabbix] can be done via the command line tool "mon-put-data". The tool generate a set of commands (calls mon-put-data) that can be execute after

with [CloudWatch] java SDK

You need to provide jar from AWS SDK for java (1.2.0) into the classpath. Configure (in property file) the cloudwatch properties and set exporter exporter.class=com.mimesis.jmx.Exporter4CloudwatchAsyncClient.

with [Zabbix]

Configure (in property file) the zabbix properties and set exporter exporter.class=com.mimesis.jmx.Exporter4ZabbixSender

Integration with [Zabbix] is done via zabbix_sender. The application generate a data file that can be used as input files for zabbix_sender (1.8.3) (TODO, document how to create Items into Zabbix for JMX data, and how to configure and to use the template)

with [Cacti]

The code was originaly build to export data for Cacti (in 2009), but it was not re-tested for Cacti after full refactor (0.2, ...). Contribution, feedback is hope.

Alternatives

Why

  • Want a bulk request (or at least several request per connection)
  • Want to monitor java application without require some modification into their code
  • Version 0.1 was created to work with [Catci], then 0.2 to import data into [Zabbix], between 0.1 and this version competitor emerge but I keep it
  • I use Java (instead of Scala) to reduce dependencies of the agent, and allow java dev (main JMX user) to contribute.

TODO

References

Something went wrong with that request. Please try again.