check-s3-file-age

nagios check for age of a specific file in AWS S3

usage

check_s3_file_age v0.5 (nagios-plugins 2.0.3)
The nagios plugins come with ABSOLUTELY NO WARRANTY. You may redistribute
copies of the plugins under the terms of the GNU General Public License.
For more information about these matters, see the file named COPYING.
Copyright (c) 2015 Christopher Hicks

Usage:
  check_s3_file_age [-w <secs>] [-c <secs>] [-W <size>] [-C <size>] [-i] [-k <access-key>] [-s <secret-key>] -n <bucket-name> -f <file>
  check_s3_file_age [-h | --help]
  check_s3_file_age [-V | --version]

  -i | --ignore-missing :  return OK if the file does not exist
  <secs>  File must be no more than this many seconds old (default: warn 240 secs, crit 600)
  <size>  File must be at least this many bytes long (default: crit 0 bytes)
  <access-key> is optional if you have the environment variable AWS_ACCESS_KEY defined
  <secret-key> is optional if you have the environment variable AWS_SECRET_KEY defined

examples

Look in s3bucket for a file named foo. Warn if the file is smaller than 100000 bytes and go critical if the file is less than 50.

check_s3_file_age.pl -n s3bucket -f foo -W 100000 -C 50

Look in s3bucket for a file named foo.
Go critical if the file is less than 50000000 bytes. Also warn if the file is older than 6 days and go critical if the file is older than 8 days.

check_s3_file_age.pl -n s3bucket -f foo -C 50000000 -w 6d -c 8d

requirements

• Perl modules
  • Net::Amazon::S3 (debian packagelibnet-amazon-s3-perl)
  • utils.pm from nagios-plugins.org

acknowledgements

• Matthew McMillan wrote check_s3_file_age.py but it does not check one specific file -- it looks at a directory of files.
• Hari Sekhon's check_aws_s3_file.pl looks at one specific file, but it does not check file age.
• Opsview's check_aws_s3 checks a bucket and not a file

see also

• check_read_only_fs - checks for readonly filesystems
• nagios-current - automatically restart nagios when configs change
• nagios-plugins - our collection of Perl and x86_64 nagios plugins
• nagios-plugins.org
• exchange.icinga.org - this module registered