cost-monitoring-construct/docs/python.md

A CDK construct that helps track applications' costs separately and receive alerts in case of unpredicted resource usage

# Introduction

The Python version of Cost Monitoring Construct derives from the Typescript version, hence refer to [its docs](./typescript.md) for extra details.

To install the Cost Monitoring Construct package, run the following command to download it from PyPI:

```bash
pip install cost-monitoring-construct
```

## Usage

Getting started is very simple: just add the following snippet to your code and adapt it to the situation.

> [!WARNING] ApplicationCostMonitoring uses AWS Tags to track resources' usages. You must [activate](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activating-tags.html) your chosen tag key (`cm:application` by default) under Cost Allocation Tags. The tag key will appear in the AWS console up to 24 hours after at least one AWS resource has been created with that tag.

```python
import aws_cdk as cdk
from cost_monitoring_construct import (
    ApplicationCostMonitoring,
    ApplicationCostMonitoringProps,
)

app = cdk.App()
monitoring_stack = MonitoringStack(app, "MyMonitoringStack")
first_stack = FirstStack(app, "FirstStack")

cost_monitoring = ApplicationCostMonitoring(
    applications_stack,
    props=ApplicationCostMonitoringProps(
        application_name="my-application",
        monthly_limit_in_dollars=200,
        other_stacks_included_in_budget=[first_stack],
        subscribers=["alert@example.com"],
        cost_allocation_tag="MyTag"
    )
)
cost_monitoring.monitor()
```