Skip to content

Create a Grafana workspace

This guide shows you how to create a Amazon Managed Service for Grafana workspace.

Reference implementation

Here's how Grafana is set up in pirates-iac.

Supported regions

For Europe, Amazon Managed Grafana is not available for eu-north-1 (Stockholm). Source: Supported regions.

Contact us for solutions for non-supported regions.

Step 1: Create a stack for observability (if you haven't already)

ok scaffold observability
cd observability

Step 2: Set up the module

Download the module templates:

ok get-template _variables_grafana.tf
ok get-template _config_grafana.auto.tfvars.json
ok get-template _dependencies_grafana.tf
ok get-template grafana.tf

Step 3: Configure the module

Open _config_grafana.auto.tfvars.json and fill in the variables.

You can find the SSO group names here. Go to <your team name>/main.tf, and look for a string similar to the one in this Grafana configuration file.

Step 4: Apply the configuration

Initialize Terraform and apply the configuration:

terraform init
terraform apply

Step 5: Configure an API key

Download the module template:

ok get-template grafana_api_keys.tf

API key pricing 💵

Every active API key is billed at $9/month, so if you create 3 API keys, you get billed $9/month * 3 = $27/month.

For more details, see Amazon Managed Grafana pricing and Automatic API Key rotation for Amazon Managed Grafana.

Step 6: Apply the final configuration

Initialize Terraform and apply the configuration:

terraform init
terraform apply

You now have an API key valid for a limited amount of time (see how long in grafana_api_keys.tf). It's added to SSM Parameter Store and is used when you configure Grafana with Terraform.

What happens when the API key expires?

The key becomes invalid.

Regenerate it by reapplying the Terraform configuration.

Next steps