packages/jmx4perl/README

   1 Java Agent for Jmx4Perl
   2 =======================
   3
   4 In order to use Jmx4Perl for monitoring Java application servers a small agent
   5 must be deployed on the target platform.  Starting with version 0.90 Jmx4Perl
   6 does not include these agents on its own but relies on the agents from its
   7 sister project Jolokia (www.jolokia.org).
   8
   9 The agent can be easily downloaded with the install 'jolokia' tool:
  10
  11 # Download the WAR agent and verify its GPG signature:
  12 $ jolokia
  13
  14 # List the content and configuration options of this agent
  15 $ jolokia jolokia.war
  16
  17 # Switch on JEE authentication within the agent
  18 $ jolokia repack --security jolokia.war
  19
  20 More about this tool can be found in its man page (man jolokia)
  21
  22 The nagios plugin can be found at lib/nagios/plugins/check_jmx4perl. It comes
  23 with a comprehensive documentation, too (man check_jmx4perl). Its
  24 configuration files are located in etc/jmx4perl/, a sample nagios command
  25 definition is included as etc/nagios/conf.d/jmx4perl_nagios.cfg and references
  26 the configuration in etc/jmx4perl/
  27
  28 Two additional tools are included in an installation, too:
  29
  30 * jmx4perl, a command line tool for querying the Jolokia agent. Can be easily
  31   used in own scripts.
  32
  33 * j4psh, a full blown JMX shell with readline support, context sensitive tab
  34   completion and syntax highlighting.
  35
  36 Please refer to their man pages for usage documentation.
  37
  38 More information about Jmx4Perl can be found at http://www.jmx4perl.org and
  39 http://www.jolokia.org, the home of the Java agents.