{"id":13505593,"url":"https://github.com/alvyn279/aws-cdk-billing-alarm","last_synced_at":"2026-04-10T10:03:47.386Z","repository":{"id":42678002,"uuid":"321767297","full_name":"alvyn279/aws-cdk-billing-alarm","owner":"alvyn279","description":"CDK construct that sets up email alerts for AWS monthly bill","archived":false,"fork":false,"pushed_at":"2023-03-05T17:53:20.000Z","size":669,"stargazers_count":26,"open_issues_count":6,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-12T13:03:01.030Z","etag":null,"topics":["aws-billing","aws-cdk","aws-cloudwatch","aws-sns","cdk-construct"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/alvyn279.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}},"created_at":"2020-12-15T19:21:37.000Z","updated_at":"2024-08-09T16:38:55.000Z","dependencies_parsed_at":"2024-01-06T10:10:17.215Z","dependency_job_id":"5d105891-b5f5-4820-ac1f-86537214e41d","html_url":"https://github.com/alvyn279/aws-cdk-billing-alarm","commit_stats":{"total_commits":37,"total_committers":2,"mean_commits":18.5,"dds":"0.16216216216216217","last_synced_commit":"36626af1cd02f8d0268502c4da6b3485b560e50f"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvyn279%2Faws-cdk-billing-alarm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvyn279%2Faws-cdk-billing-alarm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvyn279%2Faws-cdk-billing-alarm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvyn279%2Faws-cdk-billing-alarm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alvyn279","download_url":"https://codeload.github.com/alvyn279/aws-cdk-billing-alarm/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246262490,"owners_count":20749170,"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-billing","aws-cdk","aws-cloudwatch","aws-sns","cdk-construct"],"created_at":"2024-08-01T00:01:10.352Z","updated_at":"2025-12-15T16:32:24.078Z","avatar_url":"https://github.com/alvyn279.png","language":"TypeScript","funding_links":[],"categories":["Construct Libraries"],"sub_categories":["Monitoring"],"readme":"# aws-cdk-billing-alarm\n[![Build status](https://github.com/alvyn279/aws-cdk-billing-alarm/workflows/build/badge.svg)](https://github.com/alvyn279/aws-cdk-billing-alarm/actions/)\n[![NPM version](https://badge.fury.io/js/aws-cdk-billing-alarm.svg)](https://www.npmjs.com/package/aws-cdk-billing-alarm)\n[![PyPI version](https://badge.fury.io/py/aws-cdk-billing-alarm.svg)](https://pypi.org/project/aws-cdk-billing-alarm/)\n[![Mentioned in Awesome CDK](https://awesome.re/mentioned-badge.svg)](https://github.com/kolomied/awesome-cdk)\n\nA CDK construct that sets up email notification for when you exceed a given AWS estimated charges amount.\n\nCreate this construct in any stack you find appropriate **with only a few lines**. This construct is an implementation of the manual\nsetup described on [AWS Estimated Charges Monitoring](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/gs_monitor_estimated_charges_with_cloudwatch.html).\n\n## Get Started\n\n### Pre-Requisites\n \n\u003e **IMPORTANT!** Only complete **_Step 1: Enable Billing Alerts_** of the following documentation link. This construct will take\ncare of creating the rest of the resources for you.\n\nYou must first enable billing alerts from the AWS Console as per [documentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/gs_monitor_estimated_charges_with_cloudwatch.html#gs_turning_on_billing_metrics).\n\nBilling alerts will allow your AWS account to start collecting billing metrics (`EstimatedCharges`) on a periodic 6-hour basis.\n\n### Installation\n\n#### [Node documentation](https://www.npmjs.com/package/aws-cdk-billing-alarm)\n```shell\nnpm install --save aws-cdk-billing-alarm\n```\n\n#### [Python documentation](https://pypi.org/project/aws-cdk-billing-alarm/)\n```shell\npip install aws-cdk-billing-alarm\n```\n\n### Usage\n```typescript\nimport { Stack, StackProps } from 'aws-cdk-lib';\nimport { Construct } from 'constructs';\nimport { BillingAlarm } from 'aws-cdk-billing-alarm';\n\nclass CdkStack extends Stack {\n  constructor(scope: Construct, id: string, props?: StackProps) {\n    super(scope, id, props);\n\n    // Create an alarm that emails `admin@example.com`\n    // if estimated charges exceed 50 USD\n    new BillingAlarm(this, 'AWSAccountBillingAlarm', {\n      monthlyThreshold: 50,\n      emails: ['admin@example.com'],\n    });\n  }\n}\n```\n\n### Post-Deployment\n\nConfirm the subscription to the newly created topic for the emails you specified as endpoints in `BillingAlarmProps`.\nYou can do so by clicking on the `SubscribeURL` of the JSON email you received.\n\u003e **Note**: If you did not receive the email, you can fire a **Request confirmation** for the subscription from the AWS SNS Console.\n   \n\n## Limitations\n\n- [USD currency](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html#creating_billing_alarm_with_wizard)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falvyn279%2Faws-cdk-billing-alarm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falvyn279%2Faws-cdk-billing-alarm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falvyn279%2Faws-cdk-billing-alarm/lists"}