Differences

This shows you the differences between two versions of the page.

--- monitors:jmxstat [2017/11/17 15:32] – [Changelog] shadymint
+++ monitors:jmxstat [2017/11/21 17:01] (current) – [Installation] shadymint
@@ Line 5: / Line 5: @@
 ^ Requirements | Java 1.5 or above and jmxsh (http://code.google.com/p/jmxsh/)  |
 ^ Download | {{ :monitors:jmxstat_kit.zip |}} |
-^ Last Update | 2017-05-23 |
+^ Last Update | 2017-11-17 |
 ===== Description =====
-This is a tcl script that runs under jmxsh to connect to a JMX enabled JVM, extract stats and send to Xymon.  It currently monitors Tomcat on a variety of UNIX, Linux and Windows servers.  It is modelled on the beastat.pl monitor for Weblogic (http://sourceforge.net/projects/hobbit-perl-cl) but jmxstat should work for any JVM that exposes the JMX interface, especially Tomcat, but also JBoss and Weblogic.  The jmxstat monitor provides the same reporting and alerting facilities as beastat and is configured in a very similar way so anyone familiar with beastat should be comfortable with the installation.
+This is a tcl script that runs under jmxsh to connect to a JMX enabled JVM, extract stats and send to Xymon.  It currently monitors Tomcat on a variety of UNIX, Linux and Windows servers.  It is modeled on the beastat.pl monitor for Weblogic (http://sourceforge.net/projects/hobbit-perl-cl) but jmxstat should work for any JVM that exposes the JMX interface, especially Tomcat, but also JBoss and Weblogic.  The jmxstat monitor provides the same reporting and alerting facilities as beastat and is configured in a very similar way so anyone familiar with beastat should be comfortable with the installation.
 {{:monitors:jmxstat_heap.png?direct&200|}}
 {{:monitors:jmxstat_garbage_collect.png?direct&200|}}
 {{:monitors:jmxstat_threadpool.png?direct&200|}}
+jmxstat is expected to run as a 'traditional' extension and makes use of a communications program provided with the local Xymon agent such as xymon, xymon.ps1 or BBWinCMD.exe to deliver the updates to the central Xymon server.  See the README in the zipfile for discussion of the implementation differences between UNIX/Linux and Windows agents.
 ===== Installation =====
 === Client side ===
@@ Line 28: / Line 30: @@
   * The sample ini file contains definitions for generic and Tomcat (Catalina) Mbeans, definitions for JBoss Mbeans is work in progress and will be added to the sample ini in due course.  If anyone has any contributions for the defaults then please let me know.
-. Add entries to the hosts.cfg file (create one if none exists in your Xymon installation)
+. Add entries to the hosts.cfg file (create one if none exists in your Xymon installation) [NOT required on Windows Clients]
 .0.0.0 some_unique_name_in_xymon_space # noconn jmxstat
-. Edit the $XYMONHOME/etc/clientlaunch.cfg and insert the following text:
+. Edit the $XYMONHOME/etc/clientlaunch.cfg and insert the following text: [Windows Clients handle this differently - see README]
    [jmxstat]
         #DISABLED
@@ Line 255: / Line 257: @@
 ===== Changelog =====
-  * **2011-03-23 v 0.1.0 **
-    * Initial release
-  * **2011-07-03 v 0.1.1 **
-    * dont report old gcinfo alerts.
-  * **2011-07-08 v 0.1.2 **
-    * deal with gc collectors that lie about number of collections.
-    * Corrections for integer arithmetic in Heap sizes.
-  * **2011-11-11 v 0.1.3 **
-    * Support for Xymon 4.3.
-    * better error checking around jmx_get.
-    * proper flow control around down/unresponsive hosts.
-  * **2012-09-15 v 0.1.4 **
-    * caught some uninitialiased variables.
-    * better debugging.
-  * **2013-03-07 v 0.1.5 **
-    * put \" wrapper around mbean args to jmx_get.
-    * cater for jvm not providing maxSpareThreads.
-    * adapt to change in behaviour of xymongrep.
-  * **2014-04-08 v 0.1.6 **
-    * arithmetic in GCInfo sizes.
-  * **2014-08-07 v 0.1.7 **
-    * pre and post exec options to allow writing your own tcl miniprograms
-  * **2015-02-28 v 0.1.8 **
-    * re-work of 0.1.5 using MBEAN and ATTROP.
-    * New keyword "conntest" added to ini file.
-    * Runtime rrd info sent.
-  * **2016-09-07 v 0.1.9 **
-    * XYMONNETWORK removed for xymongrep
   * **2017-11-17 v 0.1.12 **
-    * Support for WinPSClient and consequent cleanup in commentary in query_bb, send_bb and send_bb_data.
+    * Support for WinPSClient in query_bb, send_bb and send_bb_data.
-    * Bug fix: uninitialised string in query_bb for BBWin.
+    * Bug fix: uninitialized string in query_bb for BBWin.
     * Strategy for no-update (-n) no longer via /bin/echo or ECHO.EXE.
     * Client Agent name added to jmxstat report.
@@ Line 293: / Line 267: @@
     * Generalized command (CMD) in query_bb, send_bb, send_bb_data.
     * Replaced quotation characters in MSG in send_bb and send_bb_data.
+  * **2016-09-07 v 0.1.9 **
+    * XYMONNETWORK removed for xymongrep
+  * **2015-02-28 v 0.1.8 **
+    * re-work of 0.1.5 using MBEAN and ATTROP.
+    * New keyword "conntest" added to ini file.
+    * Runtime rrd info sent.
+  * **2014-08-07 v 0.1.7 **
+    * pre and post exec options to allow writing your own tcl miniprograms
+  * **2014-04-08 v 0.1.6 **
+    * arithmetic in GCInfo sizes.
+  * **2013-03-07 v 0.1.5 **
+    * put \" wrapper around mbean args to jmx_get.
+    * cater for jvm not providing maxSpareThreads.
+    * adapt to change in behaviour of xymongrep.
+  * **2012-09-15 v 0.1.4 **
+    * caught some uninitialized variables.
+    * better debugging.
+  * **2011-11-11 v 0.1.3 **
+    * Support for Xymon 4.3.
+    * better error checking around jmx_get.
+    * proper flow control around down/unresponsive hosts.
+  * **2011-07-08 v 0.1.2 **
+    * deal with gc collectors that lie about number of collections.
+    * Corrections for integer arithmetic in Heap sizes.
+  * **2011-07-03 v 0.1.1 **
+    * dont report old gcinfo alerts.
+  * **2011-03-23 v 0.1.0 **
+    * Initial release