Principles to remember
- Dashboards deserve the same rigor as application code. Version control, review, and automation reduce drift and make changes auditable.
- The Foundation SDK generates dashboard JSON. Strong typing catches many configuration mistakes before those files reach Git or Grafana.
- Git Sync keeps Grafana aligned with the content you store in Git. The SDK does not deploy by itself; provisioned dashboards come from the synced repository path.
- Stable UIDs make updates predictable. The same UID updates one dashboard instead of creating duplicates when Git Sync pulls new JSON.
- CI reviews the generated files; Git Sync applies what is in Git. A pull-request check keeps committed JSON honest. After merge, sync updates Grafana from the repository.