Terraform module which deploys AWS Budgets alerts to your AWS account using the Terraform AWS Provider Budgets resource

This Terraform module deploys an AWS Budget alert to send a notification if the actual or forecasted cost has reached a certain limit within a AWS account. You can specify to choose to create an alert for the overall cost of the account or from one of the allowed services;

• Amazon Elastic Compute Cloud - Compute
• Amazon Redshift
• Amazon Relational Database Service
• Amazon ElastiCache
• Amazon Elasticsearch Service

AWS Budgets use the cost visualisation provided by Cost Explorer to show you the status of your budgets, to provide forecasts of your estimated costs, and to track your AWS usage, including your free tier usage.

To create an overall cost alert of the AWS account we need to specify the overall_budget_cost_alert_enabled variable as true to the module, this will create an AWS Budget alert that will alert when the specified budget limit amount is reached and send an email notification to the email addresses specified.

provider "aws" {
  region = "eu-west-2"

  #access_key = "add if not .aws/credentials or env variables"
  #secret_key = "add if not .aws/credentials or env variables"
}

module "budgets-alerts" {
  source  = "sculley/budgets-alerts/aws"
  version = "1.0.2"

  overall_budget_cost_alert_enabled = true
  budget_limit_amount               = "500"
  notification_type                 = "ACTUAL"
  notification_emails               = "[email protected]"
}

You can add a AWS Budget alert for a specific service (from one of the allowed services) by setting the service_budget_cost_alert_enabled variable to true such as RDS like so;

provider "aws" {
  region = "eu-west-2"

  #access_key = "fill if not .aws/credentials or env variables"
  #secret_key = "fill if not .aws/credentials or env variables"
}

module "budgets-alerts" {
  source  = "sculley/budgets-alerts/aws"
  version = "1.0.2"

  service_budget_cost_alert_enabled = true
  budget_limit_amount               = "500"
  budget_service_filter             = "Amazon Relational Database Service"
  notification_type                 = "ACTUAL"
  notification_emails               = "[email protected]"
}

Run terraform init

$ terraform init

Run terraform plan

$ terraform plan

Apply the Terraform configuration

$ terraform apply

No modules.

{
  "Amazon ElastiCache": "elasticache",
  "Amazon Elastic Compute Cloud - Compute": "ec2",
  "Amazon Elasticsearch Service": "elasticsearch",
  "Amazon Redshift": "redshift",
  "Amazon Relational Database Service": "rds"
}

No outputs.