Skip to content
README.rst 1.95 KiB
Newer Older
nimrod's avatar
nimrod committed
check_s3_bucket
###############

nimrod's avatar
nimrod committed
.. image:: https://git.shore.co.il/nimrod/check_s3_bucket/badges/master/pipeline.svg
    :target: https://git.shore.co.il/nimrod/check_s3_bucket/-/commits/master
    :alt: pipeline status

nimrod's avatar
nimrod committed
Check that a filename matching the regex was added to the bucket in the given time window.

Usage
-----

.. code:: shell

    $ check_s3_bucket --help
    usage: check_s3_bucket [-h]
                           bucket [prefix] [age_warning_threshold]
                           [age_critical_threshold] [size_warning_threshold]
                           [size_critical_threshold]
nimrod's avatar
nimrod committed

    Check that a file was added to an S3 bucket in the given time window and is of
    a reasonable size.
nimrod's avatar
nimrod committed

    positional arguments:
      bucket                S3 bucket to check
      prefix                Filter files by this prefix
      age_warning_threshold
                            Warning threshold for the age of the latest file in
                            hours (defaults to 24)
      age_critical_threshold
                            Critical threshold for the age of the latest file in
                            hours (defaults to 48)
      size_warning_threshold
                            Warning threshold for the difference in size between
                            the latest 2 files in percents (default to 25)
      size_critical_threshold
                            Critical threshold for the difference in size between
                            the latest 2 files in percents (default to 50)
nimrod's avatar
nimrod committed

    optional arguments:
      -h, --help            show this help message and exit

nimrod's avatar
nimrod committed

License
-------

This software is licensed under the MIT license (see the :code:`LICENSE.txt`
file).

Author
------

Nimrod Adar, `contact me <nimrod@shore.co.il>`_ or visit my `website
<https://www.shore.co.il/>`_. Patches are welcome via `git send-email
<http://git-scm.com/book/en/v2/Git-Commands-Email>`_. The repository is located
nimrod's avatar
nimrod committed
at: https://git.shore.co.il/explore/.