How to provision Datadog dashboards and monitors using the Datadog Terraform provider.

1. Provisioning Datadog with Terraform
Matt Spurlin
Software Engineer @ Datadog
matt.spurlin@datadoghq.com

2. Datadog
Modern monitoring and analytics tool designed to give you a single pane of glass view
into your infrastructure and applications.

3. Terraform
“Use Infrastructure as Code to provision and manage any cloud, infrastructure, or
service”

4. Why Use Datadog and Terraform together?
● Maintaining a core set of dashboards
● Manage your alerts and your on call in one place
● Bootstrapping new services

5. Installing Terraform
1) Grab the binary (https://www.terraform.io/downloads.html)
2) Put it on your $PATH
3) That’s it.

6. Terraform Providers
provider "<provider name>" {
<configuration argument> = "<configuration value>"
}

7. Datadog Provider
provider "datadog" {
api_key = "${var.datadog_api_key}"
app_key = "${var.datadog_app_key}"
}

8. terraform init

9. Template Variables
variable "<variable name>" {
<argument name> = <argument value>
}

10. Template Variable Example
variable "datadog_api_key" {
type = string
default = "<YOUR_API_KEY>"
}
variable "datadog_app_key" {
type = string
default = "<YOUR_APP_KEY>"
}

11. Terraform Resources
resource "<provider>_<type>" "<name>" {
<configuration argument> = "<configuration value>"
}

12. Dashboards

13. Minimal Dashboard
resource "datadog_dashboard" "ordered_dashboard" {
title = "Ordered Layout Dashboard"
layout_type = "ordered"
widget {
timeseries_definition {
request {
q = "avg:system.load.1{*}"
}
}
}
}

14. How To Get Widget Values

15. JSON -> HCL
{
"viz": "timeseries",
"requests": [
{
"q": "avg:system.load.1{*}",
"type": "line",
"style": {
"palette": "dog_classic",
"type": "solid",
"width": "normal"
}
}
]
}
widget {
timeseries_definition {
request {
q = "avg:system.load.1{*}"
display_type = "line"
style {
palete = "dog_classic"
line_type = "solid"
line_width = "normal"
}
}
}
}

16. terraform plan

17. terraform apply

18. Monitors

19. Minimal Monitor
resource "datadog_monitor" "simple_monitor" {
name = "Simple monitor"
type = "metric alert"
message = "Monitor triggered."
query = "avg(last_1h):avg:system.load.1{*} > 1.5"
}

20. terraform plan

21. terraform apply

22. For more information:
https://dtdg.co/terraform

23. Find these slides at:
https://github.com/mattsp1290

24. Questions?