check_weblogic_heapfree

Project Notes

nagios plugin to check if a weblogic jvm heap is falling below nominal thresholds (current and delta free)
author: Sergei Haramundanis 03-Nov-2006

usage: check_weblogic_heapfree runtime_directory url userid password heapfree_percent_minimum_threshold heapfree_delta_percent_maximum_threshold

Description:

This plugin will check the heapfree size in a weblogic jvm at the url specified via the weblogic.Admin client

This plugin requires access to weblogic.jar to access the weblogic.Admin client (see definition of WEBLOGIC_LIB further on in this script, you may need to change it)

This plugin also creates a check_weblogic_heapfree.dat file in the runtime_directory specified which contains the previous reading of the jvm heapfree to determine the delta change between runs

Output:

During any run of the plugin, it will poll the JVMRuntime MBean of the weblogic application server specified in the url and make the following two checks:

1. compare the HeapFreeCurrent and HeapSizeCurrent to determine if the current heapfree is below the minimum threshold (in percent) as specified in the heapfree_percent_minimum_threshold parameter

2. compare the previous run's HeapFreeCurrent to the current run's HeapFreeCurrent to determine if the delta (previous_heapfree - current_heapfree) is above the maximum threshold (in percent) as specified in the heapfree_delta_percent_maximum_threshold parameter

if the current heapfree is above the minimum threshold and the delta heapfree is below the maximum threshold it will return an OK state with a message similar to the following example:

[OK] 84% heapfree above minimum threshold of 30%: 902816904 of 1063256064 free; [OK] -1% heapfree delta below maximum threshold of 30%: current 902816904 previous 885992368

if either the current heapfree is below the minimum threshold or the delta heapfree is above the maximum threshold it will return a CRITICAL state with a message similar to the following example:
[CRITICAL] 29% heapfree below minimum threshold of 30%: 308344240 of 1063256064 free; [CRITICAL] 31% heapfree delta above maximum threshold of 30%: current 611334755 previous 885992368

20-Jun-2007 version 2.1 update includes:
1. support for check_from_time and check_to_time to control monitor timeframe (if you don't want to use this specify values 0000 and 2359)
2. include port # in .dat filename to support monitoring multiple weblogic instances