Save changes with a pull request

Saving dashboard changes with a pull request creates a new branch and opens a PR for team review. This workflow enables collaboration, ensures dashboard quality through code review, and maintains approval processes before changes reach production.

To save changes with a pull request, complete the following steps:

1. Make changes to a provisioned dashboard and click Save dashboard.

2. In the Provisioned dashboard panel, configure the save options.

3. In the Path field, confirm the file path in the repository.

   For example, dashboards/http-monitoring.json.

4. For Workflow, select Push to a new branch. This creates a new branch and prepares a pull request instead of committing directly to main.

5. In the Branch field, enter a descriptive branch name.

   For example, enter add-latency-metrics or update-error-visualization.

6. In the Comment field, enter a commit message describing your changes.

   For example, enter Add p95 and p99 latency visualizations for better performance monitoring.

7. Optionally, click the Changes tab to review the differences between your updates and the original dashboard.The diff view shows the JSON modifications you made to the dashboard.

8. Click Save.

9. In the confirmation dialog, click Open a pull request in GitHub.

Git Sync creates a new branch, commits your changes, and opens GitHub in a new browser tab with a pre-filled pull request. The PR includes your commit message and the dashboard changes.

In the next milestone, you’ll view and merge the pull request in GitHub.