Import Grafana dashboards

You can export dashboards from Grafana as JSON, then import them into Chronosphere as classic dashboards. For steps on exporting a dashboard from Grafana, see its documentation.

Chronosphere supports dashboards exported from Grafana versions up to 7.5. Dashboards exported from newer versions of Grafana might not be importable without modification.

Web

To import a Grafana dashboard in the Observability Platform interface, see import a dashboard.

Chronoctl

The chronoctl convert command is a feature available only in the deprecated v0.x.x versions of Chronoctl, which are maintained separately from the supported v1.x versions of Chronoctl. To install a v0.x.x version, see Download and install a v0.x.x version.

To convert exported Grafana dashboards in JSON format to Chronoctl YAML, use the convert grafana command:

chronoctl convert grafana -D <DIRECTORY> > <DASHBOARDS FILE.YML>

Replace the following:

• DIRECTORY: A path containing Grafana dashboard JSON files.
• DASHBOARDS FILE.YML: A filename into which Chronoctl saves the resulting YAML.

To convert Grafana dashboards that use a Graphite data source, add the --graphite-datasource option.

To import the converted dashboard, use the apply command:

chronoctl apply -f DASHBOARDS FILE.YML

Terraform

To import a Grafana dashboard using Terraform:

1. Declare a chronosphere_classic_dashboard resource in a Terraform file and provide a resource name.

   For example, the following code creates a dashboard that Terraform refers to as kubelet and Chronosphere associates with a specific collection:

   resource "chronosphere_classic_dashboard" "kubelet" {
     # Reference to the collection to which the alert belongs
     collection_id = chronosphere_bucket.service.id
   
     # Inlined Grafana dashboard JSON. Note the inlined service_name variable in the definition
     dashboard_json = <<EOF
   {
     "title": "${var.service_name} Overview",
     // ...
   }
   EOF
   }
   

2. Add the Grafana dashboard JSON inline as the content of the dashboard_json field. If the Grafana dashboard sets the uid field, the Terraform provider ignores it and assigns a unique identifier.

3. Use terraform apply to apply the Terraform file and create the resource.