Comment on page
Build alerts & dashboards with Grafana Terraform provider
groundcover version
- Generate service account token
groundcover auth generate-service-account-token
Service Account Token are only accessible once, so make sure you keep them somewhere safe, running the command again will generate a new service account token
Only groundcover tenant admins can generate Service Account Tokens
terraform {
required_providers {
grafana = {
source = "grafana/grafana"
}
}
}
provider "grafana" {
url = "https://app.groundcover.com/grafana"
auth = "{service account token}"
}
- Create a directory for the terraform assetsmkdir 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 newGolden Signals
folder, and within it aWorkload 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
workloadgoldensignals.json
30KB
Code
- 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 statePlan: 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 modified 8d ago