Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Amazon SQS queue length monitor. Works stand-alone or as a Nagios plugin
branch: master
Failed to load latest commit information.
README Minor cleanup
check_sqs_queue.conf AWS-Region option added AWS-Region option added


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
Something went wrong with that request. Please try again.