# AWS Budgets Integration

[AWS Budgets](https://aws.amazon.com/aws-cost-management/aws-budgets/) allows you to set custom budgets to track your cost and usage from the simplest to the most complex use cases.

With ilert AWS Budgets Integration, you can receive AWS Budgets alert through ilert and easily extend AWS Budgets functionality with SMS, push, voice, and ilert on-call schedules.

## In ilert: Create an AWS Budgets alert source <a href="#in-ilert" id="in-ilert"></a>

1. Go to **Alert sources** -> **Alert sources** and click on **Create new alert source.**

   <figure><img src="https://4017197022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjX0cS4q7woTXKajZmc1W%2FScreenshot%202023-08-28%20at%2010.21.10.png?alt=media&#x26;token=8ef3666b-84eb-4b51-abee-f07303313941" alt=""><figcaption></figcaption></figure>
2. Search for **AWS Budgets** in the search field, click on the AWS Budgets tile and click on **Next**.

   <figure><img src="https://4017197022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FlXzQlJpaTFSR49AZk0xA%2FScreenshot%202023-08-28%20at%2010.24.23.png?alt=media&#x26;token=cffeacb4-57b9-47d4-827d-b0f6b1afd914" alt=""><figcaption></figcaption></figure>
3. Give your alert source a name, optionally assign teams and click **Next**.
4. Select an **escalation policy** by creating a new one or assigning an existing one.

   <figure><img src="https://4017197022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNnuZqONaIhbOf6fn4OkZ%2FScreenshot%202023-08-28%20at%2011.37.47.png?alt=media&#x26;token=8a74f7b5-5bd2-4eea-97fa-1c1dbb041333" alt=""><figcaption></figcaption></figure>
5. Select you [Alert grouping](https://docs.ilert.com/alerting/alert-sources#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.

   <figure><img src="https://4017197022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FueugN4JgHn1c90ggFA6u%2FScreenshot%202023-08-28%20at%2011.38.24.png?alt=media&#x26;token=b8009daf-3ca8-4264-a6fa-e42ef7333205" alt=""><figcaption></figcaption></figure>
6. The next page show additional settings such as customer alert templates or notification priority. Click on **Finish setup** for now.
7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.​

   <figure><img src="https://4017197022-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fi3TIOBvNYBQfDtNpmm0A%2FScreenshot%202023-08-28%20at%2011.47.34.png?alt=media&#x26;token=6cae965a-e448-4443-8c20-37cf501c43b2" alt=""><figcaption></figcaption></figure>

## In AWS: Create a SNS topic

> If you have already created an SNS topic for your AWS Budget, that you want to reuse, you can proceed to step 3.

1. On the SNS Dashboard click on **Create topic.**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-M9ZwxCuxm53cIaDmZGz%2F-M9_-haOGynLkglQHp0u%2Fawsphd0.png?alt=media\&token=8cf83985-07cd-4ef7-ac07-f4478b091010)

2. Give the topic a name and click on **Create topic.**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MKH4q3gzSQ8iejKWU0c%2F-MKH7t9E8HdV6YmpDrQy%2FSimple_Notification_Service.png?alt=media\&token=f6a93646-98c3-4cd6-a086-72b6b8f2c184)

3. Click on **Create subscription** on the Topic Detail page.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MKH4q3gzSQ8iejKWU0c%2F-MKH9KWzQHMZwdAaia8o%2FSimple_Notification_Service.png?alt=media\&token=75a311ad-2527-490f-a082-c4be4ca2dbba)

4. In the **Topic ARN** section, ensure that the **SNS Topic** that you generated is selected.
5. In the **Protocol** section, choose the **HTTPS** protocol.
6. In the **Endpoint** section, paste the **Webhook URL** that you generated in ilert.
7. In the **Enable raw message delivery** section, ensure that the checkbox is unchecked.
8. Click on **Create subscription.**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MKH4q3gzSQ8iejKWU0c%2F-MKHDidMfujCkYrQN96W%2FSimple_Notification_Service.png?alt=media\&token=a6d9f946-1a0c-449a-9a54-22b7bd9ad11b)

9. The subscription is **automatically confirmed by ilert** when it is created. After updating the overview, the status "PendingConfirmation" should disappear, and the ID should be displayed.

### Billing Dashboard: Create budget and link to topic <a href="#create-phd-rule" id="create-phd-rule"></a>

You can now link any AWS Budgets to the topic you have created. The following section describes how to create a budget and make the link.

1. In AWS, click on the **Profile Menu** icon and select **My Billing Dashboard.**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MKH4q3gzSQ8iejKWU0c%2F-MKHEHnpopMb-Vi7u7nU%2FSimple_Notification_Service.png?alt=media\&token=a4be1c6a-10b5-4d09-9580-8ead3d6fd866)

2. In the AWS Billing Dashboard click on **Budgets** and then click on **Create budget** to add a budget.

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MKH4q3gzSQ8iejKWU0c%2F-MKHFf0TJDkm96ovv878%2FBilling_Management_Console.png?alt=media\&token=c0515da6-5ca8-4708-bcfb-bfdc9507d5bb)

3. On the **Select budget type** page, choose a budget type that interests you and click on **Set your budget**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MKH4q3gzSQ8iejKWU0c%2F-MKHG-oZIHhfqRPVpnOk%2FBilling_Management_Console.png?alt=media\&token=95bcf47c-5ba0-4d89-bc14-5404e974be0c)

4. On the **Set your budget** page, choose the settings according to your liking and click on **Configure thresholds.**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MKH4q3gzSQ8iejKWU0c%2F-MKHHNqdeBArig9PwPnS%2FBilling_Management_Console.png?alt=media\&token=f36739f2-de0f-4870-8cbc-b2e2e16ef03a)

5. On the **Configure thresholds** page, in the **Amazon SNS** section, paste the **SNS ARN** that you generated before and make sure that you configured the right topic permissions (you should see ✅ sign), then click on **Confirm budget.**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MKH4q3gzSQ8iejKWU0c%2F-MKHJdGo08NJzxOiRPbD%2FBilling_Management_Console.png?alt=media\&token=5ae99b07-4ec4-446c-ad14-6da00b0ec7ba)

6. On the **Config budget** page click on **Create.**

![](https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M76ygPnS4HUcFSX8ulm%2F-MKHJuyBETltUont75v2%2F-MKHKWhBRJNtyjaYSEir%2FBilling_Management_Console.png?alt=media\&token=108ea243-818b-49bd-b597-257bf9438941)

## FAQ <a href="#faq" id="faq"></a>

**Will alerts in ilert be resolved automatically?**

No.

**Can I link AWS Budgets to multiple alert sources in ilert?**

Yes, create an SNS topic subscription in AWS for each alert source.
