Skip to content

Latest commit

 

History

History
89 lines (71 loc) · 4.11 KB

README.md

File metadata and controls

89 lines (71 loc) · 4.11 KB
Raw

Google Cloud Billing Budget Module

This module allows creating a Cloud Billing budget for a set of services and projects.

To create billing budgets you need one of the following IAM roles on the target billing account:

  • Billing Account Administrator
  • Billing Account Costs Manager

Examples

Simple email notification

Send a notification to an email when a set of projects reach $100 of spend.

module "budget" {
  source          = "./fabric/modules/billing-budget"
  billing_account = var.billing_account_id
  name            = "$100 budget"
  amount          = 100
  thresholds = {
    current    = [0.5, 0.75, 1.0]
    forecasted = [1.0]
  }
  projects = [
    "projects/123456789000",
    "projects/123456789111"
  ]
  email_recipients = {
    project_id = "my-project"
    emails     = ["[email protected]"]
  }
}
# tftest modules=1 resources=2 inventory=email.yaml

Pubsub notification

Send a notification to a PubSub topic the total spend of a billing account reaches the previous month's spend.

module "budget" {
  source          = "./fabric/modules/billing-budget"
  billing_account = var.billing_account_id
  name            = "previous period budget"
  amount          = 0
  thresholds = {
    current    = [1.0]
    forecasted = []
  }
  pubsub_topic = module.pubsub.id
}

module "pubsub" {
  source     = "./fabric/modules/pubsub"
  project_id = var.project_id
  name       = "budget-topic"
}

# tftest modules=2 resources=2 inventory=pubsub.yaml

Variables

name description type required default
billing_account Billing account id. string ✓
name Budget name. string ✓
thresholds Thresholds percentages at which alerts are sent. Must be a value between 0 and 1. object({…}) ✓
amount Amount in the billing account's currency for the budget. Use 0 to set budget to 100% of last period's spend. number 0
credit_treatment How credits should be treated when determining spend for threshold calculations. Only INCLUDE_ALL_CREDITS or EXCLUDE_ALL_CREDITS are supported. string "INCLUDE_ALL_CREDITS"
email_recipients Emails where budget notifications will be sent. Setting this will create a notification channel for each email in the specified project. object({…}) null
notification_channels Monitoring notification channels where to send updates. list(string) null
notify_default_recipients Notify Billing Account Administrators and Billing Account Users IAM roles for the target account. bool false
projects List of projects of the form projects/{project_number}, specifying that usage from only this set of projects should be included in the budget. Set to null to include all projects linked to the billing account. list(string) null
pubsub_topic The ID of the Cloud Pub/Sub topic where budget related messages will be published. string null
services List of services of the form services/{service_id}, specifying that usage from only this set of services should be included in the budget. Set to null to include usage for all services. list(string) null

Outputs

name description sensitive
budget Budget resource.
id Fully qualified budget id.