Documentationbreadcrumb arrow Learning Pathsbreadcrumb arrow Use Git Sync to manage resourcesbreadcrumb arrow How Git Sync works
Use Git Sync to manage resources
10 min
Milestone 1
Value of Git Sync
1 min
Milestone 2
How Git Sync works
1 min
Milestone 3
Prerequisites
1 min
Milestone 4
Known limitations
2 min
Milestone 5
Navigate to Git Sync
1 min
Milestone 6
View synced dashboards
1 min
Milestone 7
Manage dashboard sync
1 min
Milestone 8
Destination reached!
1 min

How Git Sync works

Git Sync provides bidirectional synchronization between your Grafana Cloud instance and Git repositories. When you enable Git Sync, dashboards are stored as JSON files in your repository, allowing you to manage them using standard Git workflows including commits, branches, pull requests, and merges.

The synchronization mechanism monitors both Grafana and your Git repository for changes. When you modify a dashboard in Grafana, Git Sync can push those changes to your repository. When changes occur in your repository, Git Sync can pull those updates into Grafana. This bidirectional flow ensures your dashboards stay synchronized across both systems.

Sync states

Git Sync uses the following sync states to track dashboard status:

StateDescription
SyncedDashboard matches the version in Git with no differences
ModifiedDashboard has local changes in Grafana not yet committed to Git
Out of syncGit repository has a newer version than the dashboard in Grafana
ConflictBoth Grafana and Git have conflicting changes that require manual resolution

Understanding these states helps you identify which dashboards need attention and what actions to take. The sync state appears next to each dashboard in the Git Sync interface.

In the next milestone, you’ll review the prerequisites for using Git Sync.

Value of Git Sync
page 3 of 9
Prerequisites
page 3 of 9