Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spacecomx/cdk-billing-alarm
Customizable CDK construct to monitor estimated billing charges with alerts and notifications. It sets up an estimated monthly billing alarm associated with an email address endpoint. It then subscribes an email endpoint to an SNS Topic or an existing SNS Topic Arn.
https://github.com/spacecomx/cdk-billing-alarm
aws aws-billing aws-cloudwatch aws-constructs aws-organizations billing billing-alarm cdk cloudwatch cloudwatch-alarms constructs sns spacecomx
Last synced: about 2 months ago
JSON representation
Customizable CDK construct to monitor estimated billing charges with alerts and notifications. It sets up an estimated monthly billing alarm associated with an email address endpoint. It then subscribes an email endpoint to an SNS Topic or an existing SNS Topic Arn.
- Host: GitHub
- URL: https://github.com/spacecomx/cdk-billing-alarm
- Owner: spacecomx
- License: mit
- Created: 2021-07-29T18:56:45.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-04-25T01:27:30.000Z (over 2 years ago)
- Last Synced: 2024-07-05T12:34:19.837Z (3 months ago)
- Topics: aws, aws-billing, aws-cloudwatch, aws-constructs, aws-organizations, billing, billing-alarm, cdk, cloudwatch, cloudwatch-alarms, constructs, sns, spacecomx
- Language: TypeScript
- Homepage:
- Size: 313 KB
- Stars: 5
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# @spacecomx/cdk-billing-alarm
A CDK construct to monitor estimated billing charges with alerts and notifications. It sets up an estimated monthly billing alarm associated with an email address endpoint. It then subscribes an email endpoint to an SNS Topic or an existing SNS Topic Arn.
The construct can be used to implement multiple customizable billing alarms for master/payer accounts e.g (AWS Organization). For customizable multi-account billing alarm requirements, see [@spacecomx/cdk-organization-billing-alarm](https://github.com/spacecomx/cdk-organization-billing-alarm)
## Features
Some features built-in:
- consolidated charge estimates of all AWS services in your AWS account.
- associate the billing alarm with an existing SNS topic Arn in your AWS account.
- consolidated charges for a specific AWS service used by your AWS account e.g. Amazon DynamoDB.
- consolidated charges for all linked accounts within the master/payer account e.g. AWS Organization.
- consolidated charges for linked account within a master/payer account.
- consolidated charges for linked account and AWS service within the master/payer account.
## Prerequisites
> :warning: Before you can create a billing alarm, you must enable billing alerts in your account, or the master/payer account if you are using consolidated billing. For more information, see [Enabling Billing Alerts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html#turning_on_billing_metrics).
## Installation
TypeScript/JavaScript:
```bash
npm i @spacecomx/cdk-billing-alarm
```
or:
```bash
yarn add @spacecomx/cdk-billing-alarm
```
Python:
```bash
pip install spacecomx.cdk-billing-alarm
```
## Example: Create a billing alarm in your AWS account
This type of billing alarm configuration will provide estimated charges for every AWS Service that you use, in addition to the estimated overall total of your AWS charges within your AWS account. For more advanced examples and custom implementations, see [**documentation**](https://github.com/spacecomx/cdk-billing-alarm/blob/main/docs/DOCUMENTATION.md).
> :small_orange_diamond: The `emailAddress` is an endpoint that subscribes to a SNS topic. The `thresholdAmount` is the amount in USD, that will trigger the alarm when AWS charges exceed the threshold.
```typescript
import { Stack, StackProps } from '@aws-cdk/core';
import { BillingAlarm, BillingAlarmProps } from '@spacecomx/cdk-billing-alarm';
export class BillingAlarmStack extends Stack {
constructor(scope: Construct, id: string, props: StackProps) {
super(scope, id, props);
const options: BillingAlarmProps = {
topicConfiguration: {
emailAddress: ['[email protected]'], // required
},
alarmConfiguration: {
alarmDescription: 'Consolidated Billing Alarm - All AWS Services',
thresholdAmount: 150, // required
},
};
new BillingAlarm(this, 'BillingAlarm', options);
}
}
```
## Documentation
For more advanced examples and custom implementations, see [documentation](https://github.com/spacecomx/cdk-billing-alarm/blob/main/docs/DOCUMENTATION.md)
## API Documentation
For more detail, see [API documentation](https://github.com/spacecomx/cdk-billing-alarm/blob/main/API.md)
## Contributions
Contributions of all kinds are welcome! Check out our [contributor's guide](https://github.com/spacecomx/cdk-billing-alarm/blob/main/CONTRIBUTING.md) and our [code of conduct](https://github.com/spacecomx/cdk-billing-alarm/blob/main/CODE_OF_CONDUCT.md)
## Credits
- [Wayne Gibson](https://github.com/waynegibson)
## Alternatives
- [@spacecomx/cdk-organization-billing-alarm](https://github.com/spacecomx/cdk-organization-billing-alarm#readme) - used for multi-account AWS Organization billing alarm requirements.
- [aws-cdk-billing-alarm](https://github.com/alvyn279/aws-cdk-billing-alarm)
## License
@spacecomx/cdk-billing-alarm is distributed under the [MIT](https://github.com/spacecomx/cdk-billing-alarm/blob/main/LICENSE) license.