This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow As codebreadcrumb arrow Observability as codebreadcrumb arrow Provision resourcesbreadcrumb arrow Add non-provisioned resources
Enterprise Open source Grafana Cloud

Export non-provisioned resources from Grafana

Caution

Git Sync is available in private preview for Grafana Cloud. Support and documentation is available but might be limited to enablement, configuration, and some troubleshooting. No SLAs are provided. You can sign up to the private preview using the Git Sync early access form.

Git Sync and local file provisioning are experimental features introduced in Grafana v12 for open source and Enterprise editions. Engineering and on-call support is not available. Documentation is either limited or not provided outside of code comments. No SLA is provided.

Git Sync is under development, and traditional operations like import, copy, move, or save to a provisioned folder are not yet supported for dashboards already existing in Grafana. To use Git Sync with existing dashboards you must export them to the repository first.

Currently, Git Sync doesn’t offer any built-in functionality to easily export resources from Grafana in bulk. However, the following options are available:

Caution

Refer to Known limitations before using Git Sync.

Add a dashboard with Grafana CLI

You can export an existing dashboard with the Grafana CLI and commit it to your Git repository.

Use grafanactl to download the resources you want to sync from Grafana, and then commit and push those files to the repository. Git Sync will then detect the commit, and synchronize with Grafana. To do so, follow these steps:

  1. Set up the grafanactl context to point to your instance as documented in Defining contexts.
  2. Pull the resources you want to sync from the instance to your local repository:
grafanactl resources pull dashboards --path <REPO_PATH>

Next, commit and push the resources to your Git repository:

git add <DASHBOARDS_PATH>
git commit -m "Add dashboards from Grafana"
git push

Where:

  • <GIT_REPO>: The path to the repository synced with Git Sync
  • <DASHBOARDS_PATH>: The path where the dashboards you want to export are located. The dashboards path must be under the repository

See more at Manage resources with Grafana CLI.

Add a dashboard via JSON export

To add an existing dashboard to Git Sync via JSON export, you need to:

  1. Export the dashboard as JSON
  2. Convert it to the Custom Resource Definition (CRD) format required by the Grafana App Platform
  3. Commit the converted file to your Git repository

Required JSON format

To export a dashboard as a JSON file it must follow this CRD structure:

YAML 
{
  'apiVersion': 'dashboard.grafana.app/v1beta1',
  'kind': 'Dashboard',
  'metadata': { 'name': 'dcf2lve9akj8xsd' },
  'spec': { /* Original dashboard JSON goes here */ },
}

The structure includes:

  • apiVersion: Specifies the API version (currently v1beta1)
  • kind: Identifies the resource type (Dashboard)
  • metadata: Contains the dashboard identifier uid. You can find the identifier in the dahsboard’s URL or in the exported JSON
  • spec: Wraps your original dashboard JSON

Edit Git-managed dashboards

After you’ve saved a dashboard in Git, it’ll be synchronized automatically, and you’ll be able to work with it as any other provisioned resource. Refer to Work with provisioned dashboards for more information.