(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.


-c threshold, --critical=threshold

Change the critical blocked connection count threshold to threshold, which should be an integer. The default is 8.

-H host, --hostname=host

The AFS file server whose connections check_afs_rxdebug should check. This option is required.

-h, --help

Print out this documentation (which is done simply by feeding the script to perldoc -t).

-t timeout, --timeout=timeout

Change the timeout for the rxdebug command. The default timeout is 60 seconds.

-V, --version

Print out the version of check_afs_rxdebug and quit.

-w threshold, --warning=threshold

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 <>.


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 <> 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.

Last spun 2014-08-10 from POD modified 2014-04-14