Learn about the Terraform Provider Integration.

Wavefront Terraform Provider

The Wavefront Terraform Provider recently became a Wavefront integration.

This integration currently supports a comprehensive set of Wavefront resources including alerts, alert targets and dashboards.

Wavefront Terraform Provider Setup

This setup is an reiteration of terraform-provider-wavefront.

Step 1. Download and Customize the Plugin

You can download the plugin from this git repository. Latest releases include darwin and linux amd64 packages. If you need a different architecture or OS, you can build the plugin from source. Go to terraform-provider-wavefront for details.

Once you have the plugin, remove the _os_arch from the end of the file name and place it in ~/.terraform.d/plugins which is where terraform init looks for plugins. See provider configuration for syntax details.

Step 2. Create a Terraform Config File

Create a main.tf with the following configurations.

provider "wavefront" {
  address = "https://YOUR_CLUSTER.wavefront.com"
  token = "YOUR_API_TOKEN"
}

resource "wavefront_alert" "test_alert" {
  name = "Terraform Test Alert"
  target = "test@example.com"
  condition = "100 - ts(\"cpu.usage_idle\") > 80"
  display_expression = "100-ts(\"cpu.usage_idle\")"
  minutes = 5
  resolve_after_minutes = 5
  severity = "WARN"
  tags = [
    "terraform"
  ]
}

data "wavefront_alerts" "alerts" {
}

data "wavefront_alert" "alert" {
  id = "sample-alert-id"
}

In the provider block, provide your Wavefront address and the API token for your account.
- You can also export the address (WAVEFRONT_ADDRESS) and token (WAVEFRONT_TOKEN) as environment variables to avoid committing them to source control (We highly recommend you to do this for the token!).
In the resource block, each field corresponds to an alert object field. You use those alert object fields when creating alerts with the Wavefront API.

Step 3. Running the plugin

Verify that your Wavefront account has the Alerts permission.

Note: Before running terraform init, if you use terraform version 0.13 and later, run terraform 0.13upgrade.
Run terraform init to load your provider.
Run terraform plan to show the plan.
Run terraform apply to apply the test configuration and then check the results in Wavefront.
Update main.tf to change a value, the run plan and apply again to check that updates work.
Run terraform destroy to test deleting resources.