awslimitchecker¶
Master:
Develop:
A script and python module to check your AWS service limits and usage, and warn when usage approaches limits.
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, API-based limits where available, or data from Trusted Advisor where available), notifying you when you are approaching or at your limits.
Status¶
This project has just undergone a relatively major refactor to migrate from boto to boto3, along with a refactor of much of the connection and usage gathering code. Until it’s been running in production for a while, please consider this to be “beta” and make every effort to manually confirm the results for your environment.
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
- where possible, pull current limits from each service’s API (for services that provide this information)
- Supports explicitly setting the AWS region
- Supports using STS to assume roles in other accounts, including using
external_id
.
Requirements¶
- Python 2.6 through 3.5 (it should work, but is no longer tested, with PyPy and PyPy3).
- Python VirtualEnv and
pip
(recommended installation method; your OS/distribution should have packages for these) - boto3 >= 1.2.3
Installation and Usage¶
See Getting Started.
Getting Help and Asking Questions¶
See Getting Help.
For paid support and development options, please see the Enterprise Support Agreements and Contract Development section of the documentation.
Contents¶
- Getting Started
- Command Line Usage
- Python Usage
- Required IAM Permissions
- Supported Limits
- Getting Help
- Development
- Internals
- API
- Changelog
- Pre-release (develop branch)
- 0.4.4 (2016-06-27)
- 0.4.3 (2016-05-08)
- 0.4.2 (2016-04-27)
- 0.4.1 (2016-03-15)
- 0.4.0 (2016-03-14)
- 0.3.2 (2016-03-11)
- 0.3.1 (2016-03-04)
- 0.3.0 (2016-02-18)
- 0.2.3 (2015-12-16)
- 0.2.2 (2015-12-02)
- 0.2.1 (2015-12-01)
- 0.2.0 (2015-11-29)
- 0.1.3 (2015-10-04)
- 0.1.2 (2015-08-13)
- 0.1.1 (2015-08-13)
- 0.1.0 (2015-07-25)
Indices and tables¶
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; see Development / AGPL for more information.