https://blog.tomokon.net/tags/grafana/ Recent content in Grafana on Tomofumi Kondo Hugo -- gohugo.io ja-jp Sat, 18 Apr 2026 15:21:46 +0900 https://blog.tomokon.net/posts/grafana-git-sync/ Sat, 18 Apr 2026 15:21:46 +0900 https://blog.tomokon.net/posts/grafana-git-sync/ <h2 id="1-はじめに">1. はじめに</h2> <p>みなさん、Grafana のダッシュボード管理どうしてますか？</p> <p>私は自宅の Kubernetes クラスターで Grafana を動かしており、ダッシュボードを Web UI でポチポチ作ったり、mcp-grafana を使って Claude Code や kagent から作ったりしていました。</p> <p>しかし、それではダッシュボードのデータが Grafana 内部のデータベースにしか残らず、PVC を使っていたとしても Kubernetes クラスター自体を作り直した際などには消えてしまいますし、バージョン管理もできないため履歴を追うことも難しいです。 実際に今まで何回も Kubernetes クラスター自体が壊れて作り直しており、その度に同じようなダッシュボードを都度都度作成していました、、、</p> <p>そんな中、Grafana v12.4 から <strong>Git Sync</strong> という機能が使えるようになっていることを知りました。 ダッシュボード設定の JSON を GitHub リポジトリと双方向に同期してくれる機能で、まさに求めていたものです。</p> <p>今回は、自宅サーバーの Grafana に Git Sync を導入して、ダッシュボードを GitOps で管理できるようにするまでの手順を紹介します。</p> <h2 id="2-git-sync-とは">2. Git Sync とは</h2> <p><a href="https://grafana.com/docs/grafana/latest/as-code/observability-as-code/git-sync/key-concepts/">Git Sync</a> は、Grafana インスタンスと Git リポジトリの間でダッシュボードを<strong>双方向に同期</strong>する機能です。 Grafana Cloud だけでなく、OSS 版や Enterprise 版でも利用できます。</p> <p>主な特徴はこんな感じです。</p> <ul> <li><strong>双方向同期</strong>: Web UI での変更は Git にコミットされ、Git への変更は Grafana に反映される <ul> <li><strong>PR ワークフロー</strong>: Web UI での変更をブランチにコミットして PR を作成できる（<code>branch</code> ワークフロー）</li> <li><strong>直接コミット</strong>: Web UI での変更を直接メインブランチにコミットもできる（<code>write</code> ワークフロー）</li> </ul> </li> <li><strong>定期同期</strong>: 設定した間隔（例: 60秒）で自動的に同期される</li> </ul> <p>従来のプロビジョニング（<code>provisioning/dashboards/</code> にファイルを配置する方法）との大きな違いは、Git → Grafana の一方向ではなく、<strong>Grafana → Git の方向も同期される</strong>点です。 Web UI で気軽にダッシュボードを編集しつつ、その変更が自動的に Git に記録されるのはとても便利です。</p>