Setup integration: AWS Budget Notification

You need to setup an AWS SNS HTTPS endpoint for this integration!

This integration requires marbot  plus

With AWS Budgets you can plan your usage and your costs, and track how close your usage and costs are to exceeding your budgeted amount.

Monitoring your actual and projected AWS costs

Before you can start to set up the budget, you have to make one change to the SNS topic endpoint that is required for this integration. You have to allow AWS Budget to send messages to your topic.

Allowing AWS to send messages to your topic

  1. Visit https://console.aws.amazon.com/sns/?region=us-east-1
  2. Click on the Topics link on the left
  3. Select the topic that you created for marbot
  4. Click on the Actions button, where you click on the Edit topic policy link.
    Edit SNS topic policy
  5. Select the Advanced view tab

If this is the first time you edit the SNS topic policy, you should see a default entry like this:

{
"Version": "2008-10-17",
"Id": "__default_policy_ID",
"Statement": [
{
"Sid": "__default_statement_ID",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
[...TRUNCATED...]
}
]
}

You have to add an entry to the Statement array:

{
"Sid": "AWSBudgets",
"Effect": "Allow",
"Principal": {
"Service": "budgets.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "ARN"
}
  1. Replace ARN with your SNS topic ARN that you created for marbot.
  2. Click on the Update policy button to save the policy.

Save SNS topic policy

Now, AWS is allowed to send messages to your topic.

Creating a budget

  1. Visit https://console.aws.amazon.com/billing/home?region=us-east-1#/budgets
  2. Click on the Create budget button
  3. In the Budget details section, provide a Name and set the Budgeted Amount. The other fields can stay as they are.
    Budget details
  4. In the Refine your budget section, stay with the defaults to include the total costs of the AWS account.
    Refine your budget
  5. In the Notifications section
    1. Set Notify me when actual costs are greater than 100% of budgeted amount
    2. Leave Email contacts empty
    3. Set SNS topic ARN to your SNS topic ARN that you created for marbot
    4. Click on the Verify button next to the SNS topic ARN
    5. Click on the Add new notification button
    6. Set Notify me when forecasted costs are greater than 100% of budgeted amount
    7. Leave Email contacts empty
    8. Set SNS topic ARN to your SNS topic ARN that you created for marbot
    9. Click on the Verify button next to the SNS topic ARN
  6. Save by clicking the Create button.
    Notifications

Sample Alert

When your actual costs for the current month are greater than your budgeted value, or the forecasted costs for the current month are greater than your budgeted value, you should receive an alert in Slack:

Budget Alert