Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chicks-net/check-s3-file-age

nagios check for AWS S3 file age
https://github.com/chicks-net/check-s3-file-age

aws-s3 file-modification-time nagios nagios-plugins perl

Last synced: 28 days ago
JSON representation

nagios check for AWS S3 file age

Host: GitHub
URL: https://github.com/chicks-net/check-s3-file-age
Owner: chicks-net
License: gpl-2.0
Created: 2015-05-01T21:13:42.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2024-06-17T13:47:04.000Z (6 months ago)
Last Synced: 2024-06-18T05:11:29.507Z (6 months ago)
Topics: aws-s3, file-modification-time, nagios, nagios-plugins, perl
Language: Perl
Size: 28.3 KB
Stars: 3
Watchers: 3
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # check-s3-file-age

[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/9121/badge)](https://www.bestpractices.dev/projects/9121)

[![GPLv2 license](https://img.shields.io/badge/License-GPLv2-blue.svg)](https://github.com/chicks-net/check-s3-file-age/blob/master/LICENSE)

[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://github.com/chicks-net/check-s3-file-age/graphs/commit-activity)

[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](code_of_conduct.md)

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 ] [-c ] [-W ] [-C ] [-i] [-k ] [-s ] -n  -f 

	  check_s3_file_age [-h | --help]

	  check_s3_file_age [-V | --version]

	  -i | --ignore-missing :  return OK if the file does not exist

	    File must be no more than this many seconds old (default: warn 240 secs, crit 600)

	    File must be at least this many bytes long (default: crit 0 bytes)

	   is optional if you have the environment variable AWS_ACCESS_KEY defined

	   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](https://metacpan.org/release/Net-Amazon-S3) (debian package`libnet-amazon-s3-perl`)

    * `utils.pm` from [nagios-plugins.org](https://github.com/nagios-plugins/nagios-plugins)

## acknowledgements

* [Matthew McMillan](http://matthewcmcmillan.blogspot.com/2013/05/monitor-s3-file-ages-with-nagios.html) wrote [check_s3_file_age.py](https://github.com/matt448/nagios-checks) but it does not check one specific file -- it looks at a directory of files.

* [Hari Sekhon's](http://exchange.nagios.org/directory/Plugins/Cloud/check_aws_s3_file-2Epl-%28Advanced-Nagios-Plugins-Collection%29/details) [check_aws_s3_file.pl](https://github.com/harisekhon/nagios-plugins/blob/master/check_aws_s3_file.pl) looks at one specific file, but it does not check file age.

* Opsview's [check_aws_s3](https://secure.opsview.com/svn/opsview/trunk/opsview-core/nagios-plugins/check_aws_s3) checks a bucket and not a file

## see also

* [check_read_only_fs](https://github.com/chicks-net/nagios-current/tree/master/plugins) - checks for readonly filesystems

* [nagios-current](https://github.com/chicks-net/nagios-current/) - automatically restart nagios when configs change

* [nagios-plugins.org](https://github.com/nagios-plugins/nagios-plugins)

* [exchange.icinga.com](https://exchange.icinga.com/chicks/check-s3-file-age) - this module registered