NAME

Nagios::Plugin::Beanstalk - Nagios plugin to observe Beanstalkd queue server.

SYNOPSIS

use Nagios::Plugin::Beanstalk;

my $np = Nagios::Plugin::Beanstalk->new;
$np->run;

DESCRIPTION

Please setup your nagios config.

### check response time(msec) for Beanstalk
define command {
  command_name    check_beanstalkd
  command_line    /usr/bin/check_beanstalkd -H $HOSTADDRESS$ -w 15 -c 60
}

This plugin can execute with all threshold options together.

Command Line Options

Usage: check_beanstalkd -H <host> [-p <port>] [-t <tube>] [-w <warn_time>] [-c <crit_time>]

Options:
 -h, --help
    Print detailed help screen
 -V, --version
    Print version information
 -H, --hostname=ADDRESS
    Host name, IP Address, or unix socket (must be an absolute path)
 -p, --port=INTEGER
    Port number (default: 389)
 -a [--active]
    Check active worker count instead of job age
 -t [--tube]
    Tube name to watch, can be multiple. 
 -w, --warning=DOUBLE
    Response time to result in warning status (seconds), or min worker count
 -c, --critical=DOUBLE
    Response time to result in critical status (seconds), or min worker count
 -v, --verbose
    Show details for command-line debugging (Nagios may truncate output)

METHODS

new()

create instance.

run()

run checks.

TUBE SELECTION

The argument passed to --tube may be a tube name or a tube pattern if prefixed with ~. Patterns are applied to the list of tubes that currently exist on the server

Matching tubes are removed from the list if the argument is prefixed with !

--tube parameters are processed in order. If the first --tube parameter starts with ! then the initial list of tubes to check is all the tubes that currently exist on the server. If the first --tube parameter does not start with ! then the initial list is empty.

If no --tube parameters are given then all existing tubes are checked

Examples

--tube foo

Only check tube foo

--tube !foo

Check all tubes except the tube foo

--tube ~foo

Check all tubes that match the pattern /foo/

--tube !~foo

Check all tubes except those that match the pattern /foo/

--tube ~foo --tube !foobar

Check all tubes that match the pattern /foo/, except foobar

--tube !~foo --tube foobar

Check all tubes except those that match the pattern /foo/, but also check foobar

AUTHOR

Graham Barr <gbarr@pobox.com>

COPYRIGHT & LICENSE

Copyright 2008 Graham Barr

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.