{"id":18406867,"url":"https://github.com/tdmalone/aws-billing-alerts","last_synced_at":"2025-06-13T15:12:52.237Z","repository":{"id":96295323,"uuid":"120867267","full_name":"tdmalone/aws-billing-alerts","owner":"tdmalone","description":"A simple Lambda function that sends SNS alerts when your current month's bill changes.","archived":false,"fork":false,"pushed_at":"2018-02-10T03:33:08.000Z","size":60,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-07T08:36:28.467Z","etag":null,"topics":["aws","aws-billing","aws-lambda","aws-sns","javascript","js","lambda","node-js","nodejs","sns","tm-id-au"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/tdmalone.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-09T06:34:36.000Z","updated_at":"2022-07-04T19:36:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"91f6a373-4b92-4b05-9470-99f1e1067c02","html_url":"https://github.com/tdmalone/aws-billing-alerts","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/tdmalone/aws-billing-alerts","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdmalone%2Faws-billing-alerts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdmalone%2Faws-billing-alerts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdmalone%2Faws-billing-alerts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdmalone%2Faws-billing-alerts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tdmalone","download_url":"https://codeload.github.com/tdmalone/aws-billing-alerts/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tdmalone%2Faws-billing-alerts/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259668726,"owners_count":22893136,"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","aws-billing","aws-lambda","aws-sns","javascript","js","lambda","node-js","nodejs","sns","tm-id-au"],"created_at":"2024-11-06T03:11:09.786Z","updated_at":"2025-06-13T15:12:52.212Z","avatar_url":"https://github.com/tdmalone.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS Billing Alerts\n\nA simple [AWS Lambda](https://aws.amazon.com/lambda/) function that sends [SNS](https://aws.amazon.com/sns/) alerts when your current month's bill changes.\n\n## Setup\n\nInstructions coming soon, but briefly, you'll need to turn on billing alerts and set them to save to a bucket; create the Lambda function and build \u0026 upload or push the code; and create an SNS topic and set the topic ARN as the value for the environment variable `SNS_TOPIC` in your Lambda function config.\n\nYour Lambda function role will need access to the S3 bucket your billing alerts are being saved to, and you'll need to set up an S3 trigger in the Lambda console to run your function on 'Object Created (All)' events in your bucket. If you're using the bucket for other things as well, set the prefix to `YOUR_AWS_ACCOUNT_ID-aws-billing-csv-` to avoid triggering the Lambda function needlessly.\n\nMore detailed instructions - or perhaps even a CloudFormation template or a shell script to set it all up - will be coming at some stage!\n\n## Tests\n\nTo run all tests at once:\n\n    yarn test\n\n### Unit Tests\n\nTo run:\n\n    yarn unit-tests\n\nUnit tests are yet to be written, and will currently just pass.\n\n### Integration Tests\n\nTo run:\n\n    yarn docker-tests\n\nIntegration tests require [Docker](https://docs.docker.com/install/). They run in `lambci/lambda:nodejs6.10` ([GitHub](https://github.com/lambci/docker-lambda) | [Docker Hub](https://hub.docker.com/r/lambci/lambda/)).\n\nThe following environment variables must be defined on your system:\n\n* `SNS_TOPIC`\n* `BUCKET_NAME`\n* `AWS_ACCESS_KEY_ID`\n* `AWS_SECRET_ACCESS_KEY`\n* `AWS_DEFAULT_REGION`\n\n## TODO\n\n* Add full setup instructions\n* Exclude bill events that are not for the current month\n* Save reports and check if the price has changed since the last check\n* Report exactly which line items changed\n* Add a CloudFormation script - or a shell script running AWS CLI commands - to automate initial setup\n* Move to a more scalable way of using [csv-parse](https://www.npmjs.com/package/csv-parse) - i.e. buffer the stream so the entire CSV doesn't sit in memory\n* Write unit tests\n\n## License\n\n[MIT](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftdmalone%2Faws-billing-alerts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftdmalone%2Faws-billing-alerts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftdmalone%2Faws-billing-alerts/lists"}