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 Git Syncbreadcrumb arrow Usage limitations
Enterprise Open source Grafana Cloud

Usage and performance limitations

Caution

Git Sync is available in public preview for Grafana Cloud, and is an experimental feature in Grafana v12 for open source and Enterprise editions. Documentation and support is available based on the different tiers but might be limited to enablement, configuration, and some troubleshooting. No SLAs are provided.

Git Sync is under development. Contact Grafana for support or to report any issues you encounter and help us improve this feature.

Performance considerations

When Git Sync is enabled, the database load might increase, especially if your Grafana instance has many folders and nested folders. Evaluate the performance impact, if any, in a non-production environment.

Compatible services and providers

At the moment Git Sync is available for GitHub only. Support for native Git and other providers, such as GitLab or Bitbucket, is on the roadmap.

Usage tiers

The following Git Sync per-tier limits apply:

TierCloud - FreeCloud - OtherOn-prem OSSOn-prem Enterprise
Amount of repositories1101010
Amount of synced resources per repository20Grafana limitNo limitNo limit

Authentication

You can authenticate in GitHub using a Personal Access Token token or GitHub App. Refer to Set up Git Sync for more details.

Known issues

Synced resources

  • You can only sync dashboards and folders. Refer to Supported resources for more information.
  • If you’re using Git Sync in Grafana OSS and Grafana Enterprise, some resources might be in an incompatible data format and won’t be synced.
  • Full-instance sync is not available in Grafana Cloud and is experimental in Grafana OSS and Grafana Enterprise.
  • When migrating to full instance sync, during the synchronization process your resources will be temporarily unavailable. No one will be able to create, edit, or delete resources during this process.
  • If you want to manage existing resources with Git Sync, you need to save them as JSON files and commit them to the synced repository. Use grafanactl or open a PR to import, copy, move, or save a dashboard. Refer to Export non-provisioned resources from Grafana for more details.
  • Restoring resources from the UI is currently not possible. As an alternative, you can restore dashboards directly in your GitHub repository by raising a PR, and they will be updated in Grafana.

Permission management

You cannot modify the permissions of a provisioned folder after you’ve synced it.

The default permissions are:

  • Admin = Admin
  • Editor = Editor
  • Viewer = Viewer.

Refer to Roles and permissions for more information.