Menu
Enterprise Open source

Manage provisioned repositories with Git Sync

After you have set up Git Sync, you can synchronize dasards and changes to existing dasards to your configured 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 dasard 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 dasards 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 dasards with the same uid are overwritten.

To sync changes from your dasards 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 dasards 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

Dasard sync errors

  • If dasards 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.

Dasard import errors

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