111 lines
3.4 KiB
Plaintext
111 lines
3.4 KiB
Plaintext
README.SUSE for monitoring-plugins-dhcp
|
|
|
|
== check_cups ==
|
|
|
|
Plugin for checking cups service
|
|
|
|
This plug-in will check the status of a remote CUPS print service for the printer status,
|
|
It is able to check all available printers configured on the cups daemon, or just one of them.
|
|
It can also check only the queue status. It will provide the size of the queue and
|
|
optionally the age of the queue.
|
|
|
|
Generally we sugesst to create separate checks for each printer and one additional check for
|
|
the queue itself.
|
|
|
|
Usage: check_cups -H <hostname> -P -p<The CUPS printer name> | -Q <s|b> -w <size warning level> -c <size critical level> -a <max age>
|
|
|
|
Notes:
|
|
-H: Hostname - Can be a hostname or IP address.
|
|
-P: Check only the printers status.
|
|
-p: It will check only one specific printer.
|
|
-Q: Type of check - Can be queue size (s) or both queu size and queue age (b)
|
|
-w: WARNING level for queue size
|
|
-c: CRITICAL level for queue size
|
|
-a: Max age of queue. Returns CRITICAL if jobs exists older than <max age> days
|
|
|
|
Example of test run usage:
|
|
----------------
|
|
Test all available printers and the queue.
|
|
(queue size warning is 3, critical 10 and max age 3 days):
|
|
|
|
nagios@nagios:~> /usr/lib/nagios/plugins/check_cups -H cups.server.org -P -Q s -w 3 -c 10 -a 3
|
|
|
|
Checking all printers...
|
|
OK - CUPS printer is idle.
|
|
Testing queue on the CUPS...
|
|
OK: CUPS queue size - 0| print_jobs=0;3;10;0
|
|
|
|
Test one printer only :
|
|
nagios@nagios:~> /usr/lib/nagios/plugins/check_cups -H cups.suse.cz -P -p myprinter
|
|
|
|
Checking only the printer myprinter.
|
|
OK - CUPS printer myprinter is idle.
|
|
|
|
Test only the queue, do not test any printer
|
|
(queue size warning is 3, critical 5 and max age 2 days):
|
|
|
|
nagios@nagios:~> /usr/lib/nagios/plugins/check_cups -H cups.suse.cz -Q b -w 3 -c 5 -a 2
|
|
No printer check is require. Checking the queue ...
|
|
Testing queue on the CUPS...
|
|
|
|
OK: CUPS queue size - 0| print_jobs=0;3;5;0
|
|
|
|
Example of Nagios/Icinga command settings:
|
|
----------------------------------
|
|
|
|
Example commands/check_cups.cfg:
|
|
|
|
# Check all printers in cups and queue size and queue age
|
|
define command{
|
|
command_name check_cups_all_queue
|
|
command_line $USER1$/check_cups -H $ARG1$ -P -Q b -w $ARG2$ -c $ARG3$ -a $ARG4$
|
|
}
|
|
|
|
# Check one printer in cups and queue size and queue age
|
|
define command{
|
|
command_name check_cups_one_queue
|
|
command_line $USER1$/check_cups -H $ARG1$ -P -p $ARG2$ -Q b -w $ARG3$ -c $ARG4$ -a $ARG5$
|
|
}
|
|
|
|
# Check all printers in cups and queue size and queue age
|
|
define command{
|
|
command_name check_cups_all
|
|
command_line $USER1$/check_cups -H $ARG1$ -P
|
|
}
|
|
|
|
# Check one printer in cups.
|
|
define command{
|
|
command_name check_cups_one
|
|
command_line $USER1$/check_cups -H $ARG1$ -P -p $ARG2$
|
|
}
|
|
|
|
# Check only the queue
|
|
define command{
|
|
command_name check_cups_queue
|
|
command_line $USER1$/check_cups -H $ARG1$ -Q b -w $ARG2$ -c $ARG3$ -a $ARG4$
|
|
}
|
|
|
|
|
|
Security:
|
|
---------
|
|
In the version 0.2 I added an Apparmor profile for the script usr.lib.nagios.plugins.check_cups
|
|
into /etc/apparmor.d
|
|
|
|
|
|
Autor notes:
|
|
------------
|
|
I`d like to thank to John E. Vincent (nagios-plugs@lusis.org)
|
|
I learn a lof from his check CUPS print queue plugin.
|
|
Then I`d like to thank to Mark Shirley for his check_cups_printer.sh
|
|
script, which was also inspiration for me.
|
|
Both of them you can find on http://exchange.nagios.org/ web site.
|
|
Martin Caj 31/01/2013 <mcaj@suse.cz>
|
|
|
|
|
|
Bugs:
|
|
------
|
|
Please report bugs to me mcaj@suse.cz
|
|
|
|
Thanks and have lot printers online ;-)
|
|
Martin
|