A Nagios plugin to get memory statistics of a Java application using jstat.
The process selection is done either by:
- its pid (-p )
- its service name (-s ) (assuming there is a /var/run/.pid file holding its pid)
- its java name (-j ) where the java name depends ob how the java application has been launched (main class or jar/war in case of java -jar) (see jps).
It then call jstat -gc
and jstat -gccapacity
to catch current and
maximum heap and perm sizes.
What is called heap here is the edden + old generation space,
while perm represents the permanent generation space.
If specified (with -w and -c options) values can be checked with WARNING or CRITICAL thresholds (apply to both heap and perm regions).
This plugin also attach perfomance data to the output:
pid=<pid>
heap=<heap-size-used>;<heap-max-size>;<%ratio>;<warning-threshold-%ratio>;<critical-threshold-%ratio>
perm=<perm-size-used>;<perm-max-size>;<%ratio>;<warning-threshold-%ratio>;<critical-threshold-%ratio>
chech_jstat.sh -v
Print version and exit"
chech_jstat.sh -h
Print this help nd exit
chech_jstat.sh -p <pid> [-w <%ratio>] [-c <%ratio>]
chech_jstat.sh -s <service> [-w <%ratio>] [-c <%ratio>]
chech_jstat.sh -j <java-name> [-w <%ratio>] [-c <%ratio>]
-p <pid> the PID of process to monitor
-s <service> the service name of process to monitor
-j <java-name> the java app (see jps) process to monitor
if this name in blank (-j '') any java app is
looked for (as long there is only one)
-w <%> the warning threshold ratio current/max in %
-c <%> the critical threshold ratio current/max in %
This plugin may require to be run with sudo. In this case add a configuration in /etc/sudoers. For example if nagios is the user that run nagios (or NRPE deamon):
Defaults:nagios !requiretty
nagios ALL=(root) NOPASSWD: /opt/nagios/libexec/check_jstat.sh
AnotherNagios plugin count the number of open files descriptors of a given process.
The process selection is done either by:
- its pid (-p )
- its service name (-s ) (assuming there is a /var/run/.pid file holding its pid)
- its process name (-n ) (assuming that there is a single process that can be greped by its name using ps -e command).
Usage: ./check_of.sh -v
Print version and exit
Usage: ./check_of.sh -h
Print this help nd exit
Usage: ./check_of.sh -p <pid> [-w <%ratio>] [-c <%ratio>]
Usage: ./check_of.sh -s <service> [-w <%ratio>] [-c <%ratio>]
Usage: ./check_of.sh -n <name> [-w <%ratio>] [-c <%ratio>]
-p <pid> the PID of process to monitor
-s <service> the service name of process to monitor
-n <name> the process name to monitor
-w <%> the warning threshold ratio current/max in %
-c <%> the critical threshold ratio current/max in %