{"id":13528176,"url":"https://github.com/jantman/awslimitchecker","last_synced_at":"2025-05-15T02:09:05.806Z","repository":{"id":33319567,"uuid":"36964309","full_name":"jantman/awslimitchecker","owner":"jantman","description":"A script and python package to check your AWS service limits and usage via boto3.","archived":false,"fork":false,"pushed_at":"2024-06-29T23:28:01.000Z","size":2584,"stargazers_count":515,"open_issues_count":30,"forks_count":190,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-05-12T13:48:47.041Z","etag":null,"topics":["aws","python"],"latest_commit_sha":null,"homepage":"http://awslimitchecker.readthedocs.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jantman.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGES.rst","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-06-06T02:22:09.000Z","updated_at":"2025-01-06T14:48:33.000Z","dependencies_parsed_at":"2024-01-13T22:23:10.283Z","dependency_job_id":"74fe6984-2356-4e4e-9e06-d4fe15c932f6","html_url":"https://github.com/jantman/awslimitchecker","commit_stats":{"total_commits":1146,"total_committers":54,"mean_commits":21.22222222222222,"dds":"0.16404886561954624","last_synced_commit":"411ad9e734ddb16d87720ff5b994f19f47b8b098"},"previous_names":[],"tags_count":58,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jantman%2Fawslimitchecker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jantman%2Fawslimitchecker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jantman%2Fawslimitchecker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jantman%2Fawslimitchecker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jantman","download_url":"https://codeload.github.com/jantman/awslimitchecker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254259384,"owners_count":22040820,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","python"],"created_at":"2024-08-01T06:02:16.379Z","updated_at":"2025-05-15T02:09:00.790Z","avatar_url":"https://github.com/jantman.png","language":"Python","funding_links":[],"categories":["Python","3rd-party Python"],"sub_categories":[],"readme":"awslimitchecker\n===============\n\n.. image:: https://img.shields.io/pypi/v/awslimitchecker.svg\n   :target: https://pypi.python.org/pypi/awslimitchecker\n   :alt: PyPi package version\n\n.. image:: http://jantman-personal-public.s3-website-us-east-1.amazonaws.com/pypi-stats/awslimitchecker/per-month.svg\n   :target: http://jantman-personal-public.s3-website-us-east-1.amazonaws.com/pypi-stats/awslimitchecker/index.html\n   :alt: PyPi downloads\n\n.. image:: https://img.shields.io/github/forks/jantman/awslimitchecker.svg\n   :alt: GitHub Forks\n   :target: https://github.com/jantman/awslimitchecker/network\n\n.. image:: https://img.shields.io/github/issues/jantman/awslimitchecker.svg\n   :alt: GitHub Open Issues\n   :target: https://github.com/jantman/awslimitchecker/issues\n\n.. image:: http://www.repostatus.org/badges/1.1.0/active.svg\n   :alt: Project Status: Active - The project has reached a stable, usable state and is being actively developed.\n   :target: http://www.repostatus.org/#active\n\n.. image:: http://badges.gitter.im/jantman/awslimitchecker.png\n   :alt: gitter.im chat\n   :target: https://gitter.im/awslimitchecker/Lobby\n\n.. image:: https://img.shields.io/conda/v/conda-forge/awslimitchecker\n   :alt: Conda\n   :target: https://anaconda.org/conda-forge/awslimitchecker\n\nMaster:\n\n.. image:: https://api.travis-ci.com/jantman/awslimitchecker.svg?branch=master\n   :target: http://travis-ci.com/jantman/awslimitchecker\n   :alt: travis-ci for master branch\n\n.. image:: https://codecov.io/github/jantman/awslimitchecker/coverage.svg?branch=master\n   :target: https://codecov.io/github/jantman/awslimitchecker?branch=master\n   :alt: coverage report for master branch\n\n.. image:: https://readthedocs.org/projects/awslimitchecker/badge/?version=latest\n   :target: https://readthedocs.org/projects/awslimitchecker/?badge=latest\n   :alt: sphinx documentation for latest release\n\nDevelop:\n\n.. image:: https://api.travis-ci.com/jantman/awslimitchecker.svg?branch=develop\n   :target: http://travis-ci.com/jantman/awslimitchecker\n   :alt: travis-ci for develop branch\n\n.. image:: https://codecov.io/github/jantman/awslimitchecker/coverage.svg?branch=develop\n   :target: https://codecov.io/github/jantman/awslimitchecker?branch=develop\n   :alt: coverage report for develop branch\n\n.. image:: https://readthedocs.org/projects/awslimitchecker/badge/?version=develop\n   :target: https://readthedocs.org/projects/awslimitchecker/?badge=develop\n   :alt: sphinx documentation for develop branch\n\nA script and python module to check your AWS service limits and usage, and warn when usage approaches limits.\n\nUsers building out scalable services in Amazon AWS often run into AWS' `service limits \u003chttp://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html\u003e`_ -\noften at the least convenient time (i.e. mid-deploy or when autoscaling fails). Amazon's `Trusted Advisor \u003chttps://aws.amazon.com/premiumsupport/trustedadvisor/\u003e`_\ncan help this, but even the version that comes with Business and Enterprise support only monitors a small subset of AWS limits\nand only alerts *weekly*. The new Service Quotas service can also help with this, but relies on CloudWatch alarms per-limit to notify\nyou when you approach your limits; this cannot easily scale to the hundreds of current service limits. awslimitchecker provides a command line\nscript and reusable Python package that queries your current usage of AWS resources and compares it to limits (hard-coded AWS defaults that you\ncan override, API-based limits where available, Service Quotas data where available, or data from Trusted Advisor where available), notifying\nyou when you are approaching or at your limits.\n\nFull project documentation for the latest release is available at `http://awslimitchecker.readthedocs.io/en/latest/ \u003chttp://awslimitchecker.readthedocs.io/en/latest/\u003e`_.\n\nStatus\n------\n\nawslimitchecker is mature software, with approximately 13,000 downloads per month and in daily use at numerous organizations.\n\nDevelopment status is being tracked on a board at waffle.io: https://waffle.io/jantman/awslimitchecker\n\nWhat It Does\n------------\n\n- Check current AWS resource usage against AWS Service Limits\n- Show and inspect current usage\n- Override default Service Limits (for accounts with increased limits)\n- Compare current usage to limits; return information about limits that\n  exceed thresholds, and (CLI wrapper) exit non-0 if thresholds are exceeded\n- Define custom thresholds per-limit\n- where possible, pull current limits from Trusted Advisor API\n- where possible, pull current limits from each service's API (for services that provide this information)\n- where possible, pull current limits from the Service Quotas service\n- Supports explicitly setting the AWS region\n- Supports using `STS \u003chttp://docs.aws.amazon.com/STS/latest/APIReference/Welcome.html\u003e`_ to assume roles in other accounts, including using ``external_id``.\n- Optionally refresh Trusted Advisor \"Service Limits\" check before polling\n  Trusted Advisor data, and optionally wait for the refresh to complete (up to\n  an optional maximum time limit). See\n  `Getting Started - Trusted Advisor \u003chttp://awslimitchecker.readthedocs.io/en/latest/getting_started.html#trusted-advisor\u003e`_\n  for more information.\n- Optionally send current usage and limit metrics to a metrics store, such as Datadog.\n- Optionally send warning/critical alerts to notification providers, such as PagerDuty.\n\nRequirements\n------------\n\n**Either Docker in order to run via the** `docker image \u003chttp://awslimitchecker.readthedocs.io/en/latest/docker.html\u003e`__, **or:**\n\n* Python 3.5 or newer.\n* Python `VirtualEnv \u003chttp://www.virtualenv.org/\u003e`_ and ``pip`` (recommended installation method; your OS/distribution should have packages for these)\n* `boto3 \u003chttp://boto3.readthedocs.org/\u003e`_ \u003e= 1.4.6 and its dependency `botocore \u003chttps://botocore.readthedocs.io/en/latest/\u003e`_ \u003e= 1.6.0.\n\nAlternatively, awslimitchecker may be installed through `conda \u003chttps://docs.conda.io/en/latest/\u003e`_ with ``conda install -c conda-forge awslimitchecker``. This will automatically install the required dependencies as well.\n\nInstallation and Usage\n-----------------------\n\nSee `Getting Started \u003chttp://awslimitchecker.readthedocs.io/en/latest/getting_started.html\u003e`_.\n\nCredentials\n-----------\n\nSee `Credentials \u003chttp://awslimitchecker.readthedocs.io/en/latest/getting_started.html#credentials\u003e`_.\n\nGetting Help and Asking Questions\n----------------------------------\n\nSee `Getting Help \u003chttp://awslimitchecker.readthedocs.io/en/latest/getting_help.html\u003e`_.\n\nFor paid support and development options, please see the\n`Enterprise Support Agreements and Contract Development \u003chttp://awslimitchecker.readthedocs.io/en/latest/getting_help.html#enterprise-support-agreements-and-contract-development\u003e`_\nsection of the documentation.\n\nThere is also a `gitter.im chat channel \u003chttps://gitter.im/awslimitchecker/Lobby\u003e`_ for support and discussion.\n\nChangelog\n---------\n\nSee `Changelog \u003chttp://awslimitchecker.readthedocs.io/en/latest/changes.html\u003e`_.\n\nContributions\n-------------\n\nPull requests are most definitely welcome. Please cut them against the **develop** branch. For more information, see\nthe `development documentation \u003chttp://awslimitchecker.readthedocs.org/en/latest/development.html#pull-requests\u003e`_. I'm\nalso happy to accept contributions in the form of bug reports, feature requests, testing, etc.\n\nLicense\n-------\n\nawslimitchecker is licensed under the `GNU Affero General Public License, version 3 or later \u003chttp://www.gnu.org/licenses/agpl.html\u003e`_.\nThis shouldn't be much of a concern to most people; see `Development / AGPL \u003chttp://awslimitchecker.readthedocs.io/en/latest/development.html#agpl-license\u003e`_ for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjantman%2Fawslimitchecker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjantman%2Fawslimitchecker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjantman%2Fawslimitchecker/lists"}