Interactive Console
Starting from version 2.0.3 JNRPE gives you a simple way to test plugins and commands through the use of the JNRPE interactive console.
To run JNRPE in console mode, use the –interactive parameter:
./jnrpe --conf ../etc/jnrpe.ini --interactive
Listening on 127.0.0.1:5666
JNRPE>
JNRPE is now ready to receive your commands at the JNRPE command prompt.
Getting Help
If you issue ‘help’ without any parameter, you sill get the list of available commands. An example output could be:
JNRPE> help
* command:check_test
* exit
* help
* plugin:CHECK_DISK
* plugin:CHECK_FILE
Now, if you need help about any of the listed command, you can run:
help [command_name]
where command_name can be any of the listed commands:
JNRPE> help plugin:check_disk
Command Line:
plugin:CHECK_DISK [-p <path> -w <range> -c <range> -T <arg>]
Usage:
-p|-w|-c|-T
-p (--path) path The path to check
-w (--warning) range The used space warning threshold (percent)
-c (--critical) range The used space critical threshold (percent)
-T (--th) arg Configure a threshold. Format :
metric={metric},ok={range},warn={range},crit={range
},unit={unit},prefix={SI prefix}
important
The console is case insensitive: plugin:check_disk is the same as PLUGIN:CHECK_DISK.
If you want to run the check_disk plugin to test some parameters, you can issue, for example:
JNRPE> plugin:check_disk -p /tmp -w 20 -c 10
CHECK_DISK : CRITICAL - Used: 246678 MB(89%) Free: 28967 MB(10%)|freepct=10.000000;20;10;0.000000;100.000000
The same can be done with the commands:
JNRPE> command:check_test HELLO
TEST : HELLO