Amazon SQS queue length monitor. Works stand-alone or as a Nagios plugin
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Nagios plugin for checking the length of an Amazon SQS queue.  This can also be run as a 
stand-alone monitoring script and email recipients directly.

-boto, a Python interface for Amazon Web Services (
-AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY, read in from same-named environment 
variables, from boto.cfg (see boto manual), or from a specified config file (see README)

Created by Mike Babineau <>.
Copyright (c) 2009 ShareThis. All rights reserved.

Usage: -q <queue name> [-w <warning threshold>] -c <critical threshold> [-n <recipient(s)>] [-f <config file] [-h]

  -h, --help            show this help message and exit
  -f FILE, --config=FILE
                        configuration file
  -q QUEUE, --queue=QUEUE
                        Amazon SQS queue name (name only, not the URL)
  -w WARN, --warning=WARN
                        warning threshold
  -c CRIT, --critical=CRIT
                        critical threshold
  -n RECIPIENT(s), --notify=RECIPIENT(s)
                        comma-separated list of email addresses to notify

Configuration file example:
aws_access_key_id = 123456790ABCDEFGHIJ
aws_secret_access_key = 0987654321ZXYWVUTSRQPO123456789

smtp_server =
smtp_port = 587
smtp_user =
smtp_password = cleverpassword