Terraform

Example architecture to use Terraform to manage Datadog.

Folder architecture

• In modules/ all the standard monitors available OOTB.
• In company/ a folder per environment and team.

How does it work?

To create a new project for your team:

1. Create a new folder under the relevant environment folder (prod/ or dev/)
2. Create a folder with your team name
3. Create a file main.tf to initiate the relevant providers
4. Initiate the main variables for you team in variables.tf
5. Initiate the variables to connect to the providers in terraform.tfvars
6. Create your monitors using the modules in monitors_*.tf files

Get started

1. Create a terraform.tvars file: cp terraform.tvars.example terraform.tvars
2. Run terraform init
3. Run terraform plan
4. Run terraform apply

Tips: Import an asset from a remote resource

1. Datadog documentation: Importing Datadog Resources into Terraform.
2. Google Terraformer: Repo

Tips (old): Import an asset from a remote resource

A dashboard, monitor or any other resource is already available in Datadog and needs to be terraformed.

Example for a monitor:

1. Create empty ressource:

resource "datadog_monitor" "MONITOR_NAME" {
  # To fill
}

2. terraform import datadog_monitor.MONITOR_NAME MONITOR_ID
3. terraform state show 'datadog_monitor.MONITOR_NAME'
4. get output and add it in the # To fill
5. remove the id param and other params not supported

Other resources

• Terraform monitors from Claranet
• Want to translate a dashboard / monitor exported JSON to a terraform file, check this tool.