| < check_afs_quotas | Russ Allbery > Software > Orphaned Software > afs-monitor | check_afs_space > |
(Check AFS servers for blocked connections in Nagios)
check_afs_rxdebug [-hV] [-c threshold] [-w threshold] [-t timeout] -H host
check_afs_rxdebug is a Nagios plugin for checking AFS file servers to see if there are client connections waiting for a free thread. If there are more than a few of these, AFS performance tends to be very slow; this is a fairly reliable way to catch overloaded file servers. By default, check_afs_rxdebug returns a critical error if there are more than eight connections waiting for a free thread and a warning if there are more than two. These thresholds can be changed with the -c and -w options.
check_afs_rxdebug will always print out a single line of output including the number of blocked connections, displaying whether this is critical, a warning, or okay.
Change the critical blocked connection count threshold to threshold, which should be an integer. The default is 8.
The AFS file server whose connections check_afs_rxdebug should check. This option is required.
Print out this documentation (which is done simply by feeding the script
to perldoc -t).
Change the timeout for the rxdebug command. The default timeout is 60 seconds.
Print out the version of check_afs_rxdebug and quit.
Change the warning blocked connection threshold to threshold, which should be an integer. The default is 2.
check_afs_rxdebug follows the standard Nagios exit status requirements. This means that it will exit with status 0 if there are no problems, with status 1 if there is a warning, and with status 2 if there is a critical problem. For other errors, such as invalid syntax, check_afs_rxdebug will exit with status 3.
The standard -v verbose Nagios plugin option is not supported, although it's not entirely clear what it would add.
The usage message for invalid options and for the -h option doesn't conform to Nagios standards.
This script does not use the Nagios util library or any of the defaults that it provides, which makes it somewhat deficient as a Nagios plugin. This is intentional, though, since this script can be used with other monitoring systems as well. It's not clear what a good solution to this would be.
This script is part of the afs-monitor package, which includes various AFS monitoring plugins for Nagios. It is available from the AFS monitoring tools page at <http://www.eyrie.org/~eagle/software/afs-monitor/>.
The original idea behind this script was from Neil Crellin. It was updated by Quanah Gibson-Mount to work with Nagios, and then further updated by Russ Allbery <eagle@eyrie.org> to support more standard options and to use a more uniform coding style.
Copyright 2003, 2004, 2005, 2010, 2013 The Board of Trustees of the Leland Stanford Junior University
This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.
| < check_afs_quotas | Russ Allbery > Software > Orphaned Software > afs-monitor | check_afs_space > |