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.