{"id":13821380,"url":"https://github.com/trackit/aws-cost-report","last_synced_at":"2025-05-12T14:54:38.941Z","repository":{"id":40685912,"uuid":"121423565","full_name":"trackit/aws-cost-report","owner":"trackit","description":"Generate Sheets (Google, Excel and CSV) with useful information about your AWS spendings.","archived":false,"fork":false,"pushed_at":"2018-07-26T10:29:46.000Z","size":1663,"stargazers_count":112,"open_issues_count":4,"forks_count":36,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-31T23:30:05.347Z","etag":null,"topics":["aws","cost-optimization","governance"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trackit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-02-13T19:03:05.000Z","updated_at":"2025-01-23T13:47:43.000Z","dependencies_parsed_at":"2022-07-15T22:00:54.579Z","dependency_job_id":null,"html_url":"https://github.com/trackit/aws-cost-report","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trackit%2Faws-cost-report","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trackit%2Faws-cost-report/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trackit%2Faws-cost-report/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trackit%2Faws-cost-report/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trackit","download_url":"https://codeload.github.com/trackit/aws-cost-report/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253759495,"owners_count":21959774,"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","cost-optimization","governance"],"created_at":"2024-08-04T08:01:21.013Z","updated_at":"2025-05-12T14:54:38.918Z","avatar_url":"https://github.com/trackit.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"![](https://s3-us-west-2.amazonaws.com/trackit-public-artifacts/aws-cost-report/introduction.png)\n# Cost report generator\n\n## Requirements\n\n- Install [jq](https://stedolan.github.io/jq/download/)\n- Install the python3 dependencies: `sudo pip3 install -r requirements.txt`\n\n## Google Sheets API access\n\nFollow the instructions at\nhttps://developers.google.com/sheets/api/quickstart/python to setup credentials\nand API access.\n\n## How to run the tool on your machine\n\n```\n# Print help and usage informations\n$\u003e ./run.py --help\n\n# Run with one billing bucket and one EC2 profile\n$\u003e ./run.py --billing profile_name billing-bucket-name prefix --ec2 profile_name --xlsx-name filename\n\n# Run with multiple billing buckets and EC2 profiles\n$\u003e ./run.py --billing profile_name billing-bucket-name prefix --billing profile_name2 billing-bucket-name2 prefix2 --ec2 profile_name --ec2 profile_name2 --xlsx-name filename\n```\n\nThe tool is built to use AWS credentials stored in `~/.aws/credentials`.\nIf you set the profile to `env`, the tool will use environment variables you must supply instead.\n\n## How to run the tool with docker\n\nThe docker container do not export any data to google sheets.\nHowever it generates CSVs in the `out` directory, and a local spreadsheet generation will be added soon.\n\n### Use our prebuilt image\n\n```\n# Pull the msolution/aws-cost-report image\n$\u003e docker pull msolution/aws-cost-report\n```\n\n### Build your own image\n\n```\n# Build your own msolution/aws-cost-report image\n$\u003e docker build -t msolution/aws-cost-report .\n```\n\n### Use the docker container\n\n```\n# Run with one billing bucket and one EC2 profile, using env credentials\n$\u003e docker run -v /local/path/out:/root/aws-cost-report/out -e AWS_ACCESS_KEY_ID=accesskeyid -e AWS_SECRET_ACCESS_KEY=secretaccesskey -e AWS_DEFAULT_REGION=default-region -e AWS_SESSION_TOKEN=sessiontoken(optional) msolution/aws-cost-report --no-generate-sheet --billing env billing-bucket-name prefix --ec2 env --xlsx-name filename\n\n# Run with multiple billing buckets and EC2 profiles, using your local aws credentials\n$\u003e docker run -v /path/to/credentials:/root/.aws:ro -v /local/path/out:/root/aws-cost-report/out msolution/aws-cost-report --no-generate-sheet --billing profile_name billing-bucket-name prefix --billing profile_name2 billing-bucket-name2 prefix2 --ec2 profile_name --ec2 profile_name2 --xlsx-name filename\n```\n\n## Screenshots\n\nDownload the report example [here](https://s3-us-west-2.amazonaws.com/trackit-public-artifacts/aws-cost-report/report-example.xlsx).\n\n### Cost and variations tab\n\n![](https://s3-us-west-2.amazonaws.com/trackit-public-artifacts/aws-cost-report/cost-variations.png)\n\n\n### Reserved instance summary\n\n![](https://s3-us-west-2.amazonaws.com/trackit-public-artifacts/aws-cost-report/reserved-instance-summary.png)\n\n\n### Instance size recommendations\n\n![](https://s3-us-west-2.amazonaws.com/trackit-public-artifacts/aws-cost-report/instance-size-recommendations.png)\n\n\n### EC2 instances last month\n\n![](https://s3-us-west-2.amazonaws.com/trackit-public-artifacts/aws-cost-report/ec2-instances-last-month.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrackit%2Faws-cost-report","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrackit%2Faws-cost-report","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrackit%2Faws-cost-report/lists"}