Skip to main content

A script and python module to check your AWS service limits and usage using boto.

Project description

PyPi package version PyPi downloads Code Health travis-ci for master branch coverage report for master branch sphinx documentation for latest release sphinx documentation for develop branch GitHub latest release version GitHub Forks GitHub Stars GitHub Open Issues Project Status: Active - The project has reached a stable, usable state and is being actively developed.

A script and python module to check your AWS service limits and usage using boto.

Users building out scalable services in Amazon AWS often run into AWS’ service limits - often at the least convenient time (i.e. mid-deploy or when autoscaling fails). Amazon’s Trusted Advisor can help this, but even the version that comes with Business and Enterprise support only monitors a small subset of AWS limits and only alerts weekly. awslimitchecker provides a command line script and reusable package that queries your current usage of AWS resources and compares it to limits (hard-coded AWS defaults that you can override, or data from Trusted Advisor where available), notifying you when you are approaching or at your limits.

Full project documentation is available at http://awslimitchecker.readthedocs.org.

Status

This project is currently in very early development. At this time please consider it alpha code and not reliable; furthermore its API may be changing rapidly. I hope to have this stabilized soon. I wouldn’t call it ready for use, but contributions are certainly welcome.

What It Does

  • Check current AWS resource usage against AWS Service Limits

  • Show and inspect current usage

  • Override default Service Limits (for accounts with increased limits)

  • Compare current usage to limits; return information about limits that exceed thresholds, and (CLI wrapper) exit non-0 if thresholds are exceeded

  • Define custom thresholds per-limit

  • where possible, pull current limits from Trusted Advisor API

Requirements

  • Python 2.6 through 3.4. Python 2.x is recommended, as boto (the AWS client library) currently has incomplete Python3 support. See the boto documentation for a list of AWS services that are Python3-compatible.

  • Python VirtualEnv and pip (recommended installation method; your OS/distribution should have packages for these)

  • boto >= 2.32.0

Installation

It’s recommended that you install into a virtual environment (virtualenv / venv). See the virtualenv usage documentation for information on how to create a venv. If you really want to install system-wide, you can (using sudo).

pip install awslimitchecker

Credentials

awslimitchecker does nothing with AWS credentials, it leaves that to boto itself. You must either have your credentials configured in one of boto’s supported config files, or set as environment variables. See boto config and this project’s documentation for further information.

Usage

For basic usage, see:

awslimitchecker --help

See the project documentation for further information.

Bugs, Feature Requests

Questions, comments, Bug reports and feature requests are happily accepted via the GitHub Issue Tracker. Pull requests are always welcome.

Please see the [Development](http://awslimitchecker.readthedocs.org/en/latest/development.html) and [Getting Help](http://awslimitchecker.readthedocs.org/en/latest/getting_help.html) documentation for more information.

Changelog

See https://github.com/jantman/awslimitchecker/blob/develop/CHANGES.rst.

Contributions

Pull requests are most definitely welcome. Please cut them against the develop branch. For more information, see the [development documentation](http://awslimitchecker.readthedocs.org/en/latest/development.html#pull-requests). I’m also happy to accept contributions in the form of bug reports, feature requests, testing, etc.

License

awslimitchecker is licensed under the GNU Affero General Public License, version 3 or later. This shouldn’t be much of a concern to most people.

If you’re simply running awslimitchecker, all you must do is provide a notice on where to get the source code in your output; this is already handled via a warning-level log message in the package. If you modify awslimitchecker’s code, you must update this URL to reflect your modifications (see awslimitchecker/version.py).

If you’re distributing awslimitchecker with modifications or as part of your own software (as opposed to simply a requirement that gets installed with pip), please read the license and ensure that you comply with its terms.

If you are running awslimitchecker as part of a hosted service that users somehow interact with, please ensure that the source code URL is visible in the output given to users.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

awslimitchecker-0.1.2.tar.gz (73.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page