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

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