Build alerts & dashboards with Grafana Terraform provider

Configure the Grafana Terraform provider

For instructions on how to generate a Grafana Service Account Token and use it in the Grafana Terraform provider, see: Grafana Service Account Token.

Dashboard provisioning example

  • Create a directory for the terraform assets

    mkdir groundcover-tf-example && cd groundcover-tf-example
  • Create a main.tf file within the directory that contains the terraform provider configuration mentioned in step 2

  • Create the following dashboards.tf file, this example declares a new Golden Signals folder, and within it a Workload Golden Signals dashboard that will be created

resource "grafana_folder" "goldensignals" {
  title = "Golden Signals"
}

resource "grafana_dashboard" "workloadgoldensignals" {
  config_json = file("workloadgoldensignals.json")
  folder = grafana_folder.goldensignals.id
}
  • add the workloadgoldensignals.json file to the directory as well

  • Run terraform init to initialize terraform context

  • Run terraform plan , you should see a long output describing the assets that are going to be created last line should state Plan: 2 to add, 0 to change, 0 to destroy.

  • Run terraform apply to execute the changes, you should now see a new folder in your grafana dashboards screen with the newly created dashboard

  • Run terraform destroy to revert the changes

Here is a short video to demonstrate the process

You can read more about what you can achieve with the Grafana Terraform provider in the official docs

Last updated