Save a dashboard to Git

Saving a new dashboard to a Git Sync provisioned folder triggers the Git workflow options. You must choose a provisioned folder, specify the file path in the repository, and select whether to commit directly to the main branch or create a pull request for review.

To save a dashboard to Git, complete the following steps:

  1. Click Save dashboard in the dashboard toolbar.

  2. In the Title field, enter a descriptive name for the dashboard.

    For example, enter HTTP Request Monitoring.

  3. In the Description field, enter a brief explanation of the dashboard’s purpose.

    For example, enter Monitors HTTP request rates and error rates for web services.

  4. In the Folder drop-down, select a Git Sync provisioned folder. Provisioned folders display a Provisioned label.

    For example, select grafana-dashboards.

  5. In the Path field, enter the file path where the dashboard JSON will be saved in the repository.

    For example, enter dashboards/http-monitoring.json.

  6. For Workflow, select Push to main to commit directly to the main branch. This creates a direct commit without a pull request. In later milestones, you’ll learn about the pull request workflow.

  7. In the Comment field, enter a commit message describing the new dashboard.

    For example, enter Add HTTP request monitoring dashboard.

  8. Click Save.

The dashboard is saved to the Git Sync provisioned folder and committed to the GitHub repository. Git Sync creates a commit with your message and pushes it to the main branch. The dashboard is now version controlled and synced with GitHub.

In the next milestone, you’ll learn how to edit an existing synced dashboard.


page 4 of 9