Manage provisioned repositories with Git Sync
Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Observability as Codebreadcrumb arrow Provision resources and sync dashboardsbreadcrumb arrow Manage repositories
Enterprise Open source

Manage provisioned repositories with Git Sync

After you have set up Git Sync, you can synchronize dashboards and changes to existing dashboards to your configured GitHub repository. If you push a change in the repository, those changes are mirrored in your Grafana instance.

View current status of synchronization

Each repository synchronized with Git Sync has a dashboard that provides a summary of resources, health, pull status, webhook, sync jobs, resources, and files. Use the detailed information accessed in View to help troubleshoot and understand the health of your repository’s connection with Grafana.

To view the current status, follow these steps.

  1. Log in to your Grafana server with an account that has the Grafana Admin or Editor flag set.
  2. Select Administration in the left-side menu and then Provisioning.
  3. Locate the repository you are interested in.
  4. If you see a green Up-to-date label next to the repository name, then everything is syncing as expected.
  5. Select View to access detailed dashboards and reports about the synchronization history of your repository.

Synchronize changes

Synchronizing resources from provisioned repositories into your Grafana instance pulls the resources into the selected folder. Existing dashboards with the same uid are overwritten.

To sync changes from your dashboards with your Git repository:

  1. From the left menu, select Administration > Provisioning.
  2. Select Pull under the repository you want to sync.
  3. Wait for the synchronization process to complete.

Remove a repository

To delete a repository, follow these steps.

  1. Log in to your Grafana server with an account that has the Grafana Admin or Editor flag set.
  2. Select Administration in the left-side menu and then Provisioning.
  3. Locate the repository you are interested in.
  4. Select the trashcan icon in the right side to delete the chosen entry.
  5. Select Delete to confirm.

Refer to Work with provisioned dashboards for information on removing provisioned files.

Troubleshoot synchronization

Monitor the View status page for synchronization issues and status updates. Common events include:

  • Sync started
  • Sync completed
  • Sync failed (with error details)
  • Sync issues

Dashboard sync errors

  • If dashboards are not syncing, check if the repository URL is correct and accessible from the Grafana instance.
  • Ensure that the configured repository branch exists and is correctly referenced.
  • Check for conflicts in the repository that may prevent syncing.

Dashboard import errors

  • Validate the JSON format of the dashboard files before importing.
  • If the import fails, check Grafana logs for error messages and troubleshoot accordingly.