monitors:jmxstat

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
monitors:jmxstat [2015/03/01 05:22] – [Installation] shadymintmonitors:jmxstat [2017/11/21 17:01] (current) – [Installation] shadymint
Line 4: Line 4:
 ^ Compatibility | Xymon 4.2,4.3 | ^ Compatibility | Xymon 4.2,4.3 |
 ^ Requirements | Java 1.5 or above and jmxsh (http://code.google.com/p/jmxsh/)  | ^ Requirements | Java 1.5 or above and jmxsh (http://code.google.com/p/jmxsh/)  |
-^ Download | http://dl.dropbox.com/u/92999992/jmxstat_kit.zip | +^ Download | {{ :monitors:jmxstat_kit.zip |}} | 
-^ Last Update | 2015-02-28 |+^ Last Update | 2017-11-17 |
  
 ===== Description ===== ===== 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 ===== ===== Installation =====
 === Client side === === Client side ===
Line 24: 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.   * 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.
  
-4. Add entries to the hosts.cfg file (create one if none exists in your Xymon installation)+4. Add entries to the hosts.cfg file (create one if none exists in your Xymon installation) [NOT required on Windows Clients]
  
     0.0.0.0 some_unique_name_in_xymon_space # noconn jmxstat     0.0.0.0 some_unique_name_in_xymon_space # noconn jmxstat
  
-5. Edit the $XYMONHOME/etc/clientlaunch.cfg and insert the following text: +5. Edit the $XYMONHOME/etc/clientlaunch.cfg and insert the following text: [Windows Clients handle this differently - see README]
    [jmxstat]    [jmxstat]
         #DISABLED         #DISABLED
Line 40: Line 46:
  
 6. Add this to TEST2RRD= in xymonserver.cfg 6. Add this to TEST2RRD= in xymonserver.cfg
-  Threads=ncv,JVMHeap=ncv,Classes=ncv,WebApp=ncv,ThreadPool=ncv,Service=ncv,GCInfo+  Threads=ncv,JVMHeap=ncv,Classes=ncv,WebApp=ncv,ThreadPool=ncv,Service=ncv,GCInfo,jmxstat
      
 7. Add this to GRAPHS= in xymonserver.cfg  7. Add this to GRAPHS= in xymonserver.cfg 
   Threads,Classes,Service,JVMHeap,GCInfo,WebApp,ThreadPool,jmxstat   Threads,Classes,Service,JVMHeap,GCInfo,WebApp,ThreadPool,jmxstat
      
-8. Add these 6 extra lines to xymonserver.cfg+8. Add these 7 extra lines to xymonserver.cfg
   NCV_Threads="LiveThreads:GAUGE,Peak:GAUGE,DaemonThreads:GAUGE,Total:DERIVE"   NCV_Threads="LiveThreads:GAUGE,Peak:GAUGE,DaemonThreads:GAUGE,Total:DERIVE"
   NCV_JVMHeap="HeapSize:GAUGE,Committed:GAUGE,MaxHeapSize:GAUGE"   NCV_JVMHeap="HeapSize:GAUGE,Committed:GAUGE,MaxHeapSize:GAUGE"
Line 52: Line 58:
   NCV_ThreadPool="currentThreadCount:GAUGE,currentThreadsBusy:GAUGE"   NCV_ThreadPool="currentThreadCount:GAUGE,currentThreadsBusy:GAUGE"
   NCV_Service="bytesReceived:DERIVE,bytesSent:DERIVE,errorCount:DERIVE,requestCount:DERIVE"   NCV_Service="bytesReceived:DERIVE,bytesSent:DERIVE,errorCount:DERIVE,requestCount:DERIVE"
 +  NCV_jmxstat="runtime:GAUGE"
      
 9. Add these 8 new sections to graphs.cfg 9. Add these 8 new sections to graphs.cfg
Line 172: Line 179:
         GPRINT:active:MAX: \: %5.1lf%s (max)         GPRINT:active:MAX: \: %5.1lf%s (max)
         GPRINT:active:AVERAGE: \: %5.1lf%s (avg)\n         GPRINT:active:AVERAGE: \: %5.1lf%s (avg)\n
-   [jmxstat]+  [jmxstat]
         TITLE jmxstat Run Time         TITLE jmxstat Run Time
         YAXIS Seconds         YAXIS Seconds
Line 250: Line 257:
 ===== Changelog ===== ===== Changelog =====
  
-  * **2011-03-23 v 0.1.0 ** +  * **2017-11-17 v 0.1.12 ** 
-    * Initial release +    * Support for WinPSClient in query_bb, send_bb and send_bb_data. 
-  * **2011-07-03 v 0.1.1 ** +    * Bug fix: uninitialized string in query_bb for BBWin. 
-    * dont report old gcinfo alerts. +    * Strategy for no-update (-n) no longer via /bin/echo or ECHO.EXE. 
-  * **2011-07-08 v 0.1.2 ** +    * Client Agent name added to jmxstat report. 
-    * deal with gc collectors that lie about number of collections. +    * Support for not performing a connectivity test for individual jvms. 
-    * Corrections for integer arithmetic in Heap sizes. +    * Automatically and portably derives XYMONHOME if not in environment. 
-  * **2011-11-11 v 0.1.3 ** +    * Implemented a built-in xymongrep for platforms without one. 
-    * Support for Xymon 4.3. +    * Generalized command (CMD) in query_bb, send_bb, send_bb_data. 
-    * better error checking around jmx_get. +    * Replaced quotation characters in MSG in send_bb and send_bb_data. 
-    * proper flow control around down/unresponsive hosts. +  * **2016-09-07 v 0.1.9 ** 
-  * **2012-09-15 v 0.1.4 ** +    * XYMONNETWORK removed for xymongrep 
-    * caught some uninitialiased variables. +  * **2015-02-28 v 0.1.8 ** 
-    * better debugging.+    * 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 **   * **2013-03-07 v 0.1.5 **
     * put \" wrapper around mbean args to jmx_get.     * put \" wrapper around mbean args to jmx_get.
     * cater for jvm not providing maxSpareThreads.     * cater for jvm not providing maxSpareThreads.
     * adapt to change in behaviour of xymongrep.     * adapt to change in behaviour of xymongrep.
-  * **2014-04-08 v 0.1.6 ** +  * **2012-09-15 v 0.1.4 ** 
-    * arithmetic in GCInfo sizes. +    * caught some uninitialized variables. 
-  * **2014-08-07 v 0.1.7 ** +    * better debugging. 
-    * pre and post exec options to allow writing your own tcl miniprograms+  * **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
  • monitors/jmxstat.1425187376.txt.gz
  • Last modified: 2015/03/01 05:22
  • by shadymint