--- title: "Grafana 12とは？最新版13との違い・サポート期限・v11からの変更点とバージョン確認方法" url: "https://www.issoh.co.jp/tech/details/8395/" published: 2025-08-25 updated: 2026-10-19 categories: ["監視・オブザーバビリティ"] publisher: "株式会社一創" --- # Grafana 12とは？最新版13との違い・サポート期限・v11からの変更点とバージョン確認方法 Grafana 12は2025年5月5日にGAとなったメジャーバージョンです。Git SyncやDynamic Dashboardsが初めて載った版ですが、2026年10月19日時点の最新版はGrafana 13.2.4（2026年10月13日）で、12系で修正が届くのは12.4系だけになりました。この記事では、Grafana 12で何が入り、v11から何が壊れ、13へいつ・どう上げるべきかを、公式のサポート表・アップグレードガイドと、12.3→12.4→13.2を実際に上げ下げした結果をもとに整理します。手元のバージョンを確かめる方法も3通り載せています。 ## まとめ：Grafana 12の位置づけと最新版13への移行判断 - **最新版**：13.2.4（2026年10月13日）。13.3は公式スケジュールで2026年10月20日の予定です。 - **12系のサポート**：残っているのは12.4系（期限2027年5月24日）だけです。12.0〜12.3はすでに修正が止まっています。 - **v11→v12の壊れる箇所**：Angularプラグインの完全削除、データソースUIDの形式チェック、annotationテーブルの全面書き換え、APIキー用エンドポイントの削除（12.1）の4つです。 - **ロールバックの境目**：小規模インスタンスでは、13ではなく12.4への更新時点でダッシュボードとフォルダがUnified Storageへ移ります。12.4以降で作ったダッシュボードは、12.3以前に戻すと見えなくなります。 - **判断**：12.0〜12.3に留まっている環境は、まず12.4へ。Git管理や動的レイアウトを使いたいなら13.2以降へ。上げる先に13.0.0は選べません（配布停止済み）。 ## Grafanaの最新バージョンとサポート期限（2026年10月19日時点） Grafanaはマイナー版を2か月ごとに出し、サポート中の全マイナー版へパッチ版を少なくとも月1回出します。2026年10月13日にも13.2.4・13.1.8・13.0.11・12.4.13の4本が同時に公開されました。[公式のアップグレード時期ガイド](https://grafana.com/docs/grafana/latest/upgrade-guide/when-to-upgrade/)にあるサポート表と、[GitHubのリリース一覧](https://github.com/grafana/grafana/releases)を突き合わせた現状は次のとおりです。 | 系列 | 初版（公式表） | サポート期限 | 最新パッチ | 状態 | | ---- | ------------ | ---------- | ------- | ---------- | | 13.3 | 2026-10-20予定 | 2027-07-20 | 未公開 | 公開予定 | | 13.2 | 2026-08-18 | 2027-05-18 | 13.2.4 | 最新 | | 13.1 | 2026-06-23 | 2027-03-20 | 13.1.8 | パッチ提供中 | | 13.0 | 2026-04-14 | 2027-01-09 | 13.0.11 | パッチ提供中 | | 12.4 | 2026-02-24 | 2027-05-24 | 12.4.13 | 12系で唯一の提供中 | | 12.3 | 2025-11-19 | 2026-08-19 | 12.3.11 | 終了 | | 12.2 | 2025-09-23 | 2026-06-23 | 12.2.10 | 終了 | | 12.1 | 2025-07-22 | 2026-04-22 | 12.1.10 | 終了 | | 12.0 | 2025-05-05 | 2026-02-05 | 12.0.10 | 終了 | | 11.6 | 2025-03-25 | 2026-06-25 | 11.6.16 | 終了 | 公式表の日付とGitHubの公開日はずれることがあります。13.1は表が6月23日、GitHubの13.1.0公開は7月1日でした。13.0.0は後述の不具合で配布停止となり、GitHubで入手できる13系の初版は13.0.1（2026年4月17日）です。 ### サポート期限の決まり方（9か月・最終マイナーは15か月） セルフマネージド版（OSS・Enterprise）は、各マイナー版をリリース日から9か月サポートし、メジャー版の最終マイナーだけ15か月に延長します。12.4が13.0より長い2027年5月24日まで残るのはこのためです。11系の最終マイナー11.6も15か月の延長を受けましたが、2026年6月25日で終わりました。11系に残っている環境には、もう修正が届きません。 公式表に載っていない先の版も、この式で寿命を見積もれます。とはいえ表の期限は式から数日ずれることがあるので（13.1は初版6月23日に対し期限3月20日）、確定値は公式表で確かめてください。 ## Grafanaのバージョンを確認する3つの方法 稼働中のバージョンを確認し、前述のサポート表と照合してください。画面・HTTP API・コマンドの3通りで確かめられます。 ### ヘルプメニューでのバージョン確認 サインイン後、画面右上の「?」（ヘルプ）アイコンをクリックすると、メニュー内にバージョン番号が表示されます。[公式のKubernetesインストール手順](https://grafana.com/docs/grafana/latest/setup-grafana/installation/kubernetes/)も、導入後の確認方法としてこの操作を案内しています。 ### HTTP API /api/health によるバージョン確認 監視やCIから複数台を棚卸しするなら `GET /api/health` が向いています。認証なしで `database`・`version`・`commit` を返します。12.4.13で叩いた実際の応答は次のとおりです。 ``` $ curl -s http://127.0.0.1:3000/api/health { "database": "ok", "version": "12.4.13", "commit": "6367d911d57309d1da370872b8fd76237b5a0ffa" } ``` ### grafana server -v によるバージョン確認と13での旧コマンド削除 サーバー上では `grafana server -v` を使います。12.4.13の配布物には `grafana`・`grafana-cli`・`grafana-server` の3つが入っていますが、13.2.4の `bin` は `grafana` だけでした。12.4で旧コマンドを使うと、非推奨の警告が出ます。 ``` $ ./bin/grafana server -v Version 12.4.13 (commit: 6367d911d57309d1da370872b8fd76237b5a0ffa, branch: release-12.4.13#patched) $ ./bin/grafana-server -v Deprecation warning: The standalone 'grafana-server' program is deprecated and will be removed in the future. Please update all uses of 'grafana-server' to 'grafana server' Version 12.4.13 (commit: ...) ``` systemdのユニット、Dockerfile、起動スクリプトに `grafana-server` や `grafana-cli` を書いている環境は、13に上げた時点で起動に失敗します。12系のうちに `grafana server`・`grafana cli` へ書き換えておくべき箇所です。 ## Grafana 12の主要機能と成熟度（12.0時点と12.4時点） Grafana 12.0.0は2025年5月5日にGAとなり、GrafanaCON 2025（シアトル）で発表されました。Grafana 12のリリースノートには多くの新機能がありますが、12.0の時点でGAだったのはDrilldown（Metrics・Logs・Traces）やGrafana管理のアラート・記録ルールなどで、目玉のObservability as Code系はexperimentalでした。セルフマネージドOSS版での成熟度は版を追って次のように変わっています（[v12.0のWhat’s new](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-0/)・[v12.4のWhat’s new](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-4/)のラベルによる）。 | 機能 | 12.0 | 12.4 | 13.0 | | ------------------ | ---------------------- | -------------- | ---- | | Git Sync | experimental（GitHubのみ） | experimental | GA | | Dynamic Dashboards | experimental | public preview | GA | | SQL Expressions | private preview | – | – | | Grafana Drilldown | GA | GA | GA | 12.4でGit Syncが「public preview」と紹介されていますが、それはGrafana Cloudの話で、OSSとEnterpriseではexperimentalのままです。セルフマネージドでGit Syncを本番に載せたいなら、12系に選択肢はありません。12で安心して使える新機能はDrilldownで、ログ側を掘るなら[Grafana LokiとAlloyでログ基盤を組む手順](/tech/details/9570/)、トレース側なら[Grafana Tempoの仕組みとTraceQLの書き方](/tech/details/15584/)を合わせて整えると、同じ画面でメトリクス・ログ・トレースを行き来できます。 experimentalの機能は、設定ファイルの `[feature_toggles]` で個別に有効にします。12.0の公式案内では、Git Syncを試すには `provisioning` と `kubernetesDashboards` の両方を有効にします。新レイアウトのトグル名は `dashboardNewLayouts` です。トグルの組み合わせはマイナー版ごとに変わるので、使う版の導入手順で確かめてください。コンテナなら環境変数 `GF_FEATURE_TOGGLES_ENABLE` に同じ値を渡します。 ``` ; Grafana 12.0の検証環境用 [feature_toggles] enable = provisioning kubernetesDashboards dashboardNewLayouts ``` 12系のGit Syncはexperimentalなので、本番の12系ではこのトグルを開けないでください。後述のデータ喪失不具合は、該当フラグを有効にした12.xから13.0.0へ更新した場合に発生し、13.0.1で修正済みです。 ## Grafana 11から12への変更点（壊れる4箇所） Grafana 11から12への更新では、新機能より先に既存環境へ影響する破壊的変更を確認してください。[v12.0のアップグレードガイド](https://grafana.com/docs/grafana/latest/upgrade-guide/upgrade-v12.0/)とCHANGELOGが挙げる影響の大きい変更は次の4つです。 ### Angularプラグインの完全削除 Angularはv9で非推奨、v11で既定無効となり、v12で削除されました。v11までは `angular_support_enabled` を戻せば動いたAngularベースのプラグインも、v12では有効化する手段がありません。古いコミュニティプラグインを使っている環境は、上げる前にReactベースの後継があるか確かめる必要があります。 ### データソースUIDの形式チェック（不正なUIDは400） v12.0で機能フラグ `failWrongDSUID` が既定で有効になり、REST APIやプロビジョニングで不正な形式のUIDを持つデータソースを作成・更新できなくなりました。UIDには半角英数字・ハイフン・アンダースコアを使用でき、長さの上限は40文字です。12.4.13でドットを含むUIDを送ると、次のように拒否されます。 ``` $ curl -s -X POST -H 'Content-Type: application/json' http://admin:admin@127.0.0.1:3000/api/datasources \ -d '{"name":"bad","type":"prometheus","url":"http://localhost:9090","access":"proxy","uid":"prom.main"}' {"statusCode":400,"messageId":"datasource.uidInvalid","message":"Invalid datasource UID."} ``` 同じ内容でUIDを `prom-main` にすると作成できました。Terraformやプロビジョニングファイルで独自のUIDを振っている環境は、上げる前に `/api/datasources` で既存UIDを洗い出してください。不正なUIDは直せないので、正しいUIDで作り直し、ダッシュボードとアラートルールの参照を付け替えることになります。 ### annotationテーブルの全面書き換え v11.xからv12.xへの移行では、annotationテーブルに `dashboard_uid` 列を埋めるため、テーブル全体の書き換えとインデックスの再構築が走ります。公式は、注釈が大量にある環境で一時的にディスク使用量が急増し、「No space left on device」での移行失敗や起動失敗につながると警告しています。公式の目安は、データベースの保存先にannotationテーブルサイズの少なくとも2〜3倍の空き容量です。更新前にテーブルサイズと空き容量を確認してください。 ### APIキー用エンドポイントの削除（12.1） APIキーは11.6で完全に非推奨となり、既存キーはサービスアカウントへ自動移行されました。そのうえで[CHANGELOG](https://github.com/grafana/grafana/blob/main/CHANGELOG.md)の12.1.0に「Remove api key endpoints」が記録されています。12.4.13で `POST /api/auth/keys` を送ると404（Not found）が返りました。APIキーを発行する自動化スクリプトが残っているなら、サービスアカウントのトークン発行へ書き換えます。 ## Grafana 12と13の違い：GA化した機能と破壊的変更 13は、12でexperimentalだったものを仕上げた版です。13.0でDynamic DashboardsとGit SyncがGAになり、13.1ではGit Syncに署名付きコミット・UIからのインポート・ルート直下の同期が加わり、テンプレート変数を作らずに使えるクイックフィルターとグルーピングがGAになりました。13.2ではGrafana CloudとGrafana EnterpriseのGit SyncがGitHub Enterpriseに対応し、ビューパネルのサイドバーがpublic previewで入っています。 13への更新では、機能のGA化とは別に破壊的変更への対応が必要です。[v13.0のアップグレードガイド](https://grafana.com/docs/grafana/latest/upgrade-guide/upgrade-v13.0/)が挙げる変更は次のとおりです。 | 変更 | 影響と対応 | | -------------------------- | ------------------------------------------ | | Image Rendererプラグイン | プラグイン形式を廃止／別サービスで立てる | | レンダラーの認証 | JWTが既定／renderer\_tokenの設定が必要 | | Unified Storage | フォルダ・ダッシュボードを自動移行 | | 数値IDのデータソースAPI | 既定で無効（datasourceLegacyIdApiで一時復帰） | | grafana-server／grafana-cli | 削除 | | Alertmanagerの旧設定API | 一部削除・管理者限定に | | Alertmanagerのstatus API | 新権限 alert.notifications.system-status:read | | カスタムロールのRBAC | 非推奨権限を含むロールの更新が失敗 | | 旧 /api パス | 非推奨（当面は無効化されない） | | React 19 | 先に最新パッチ・全プラグインを更新 | 数値IDのデータソースAPIは、実際に挙動が変わりました。12.4.13では `GET /api/datasources/1` がデータソースを返しましたが、同じデータベースのまま13.2.4で起動すると404になり、`/api/datasources/uid/prom-main` は引き続き返りました。Grafanaの外からIDでデータソースを触っているスクリプトは、13の前にUID指定へ直しておく必要があります。 Image Rendererは、画像化の機能が消えたのではありません。Grafana内のプラグインとして動かす形が廃止され、レンダラーをGrafanaの横に別サービスとして立てる構成に変わりました。認証もJWTになるので、`[rendering]` の `renderer_token` に空でも既定値（`-`）でもない値を設定し、レンダラー側にも同じ値を渡して再起動します。アラート通知やレポートにパネル画像を添付している運用は、13へ上げる前にこの分離を設計してください。 ### 13.0.0の配布停止とGit Sync利用環境の復旧手順 13.0.0には、Git Sync系のフラグ（`provisioning`・`kubernetesClientDashboardsFolders`・`kubernetesDashboards`）を有効にした12.xのセルフマネージド環境から上げると、ダッシュボードやフォルダが失われたり巻き戻ったりする不具合がありました。13.0.0は配布から外され、修正は13.0.1に入っています。13.0.0へ上げた後に13.0.1へ上げても、失ったデータは戻りません。公式の復旧手順は、ローカルとGit Syncの内容が混在していたならアップグレード前のバックアップを戻してから13.0.1へ、インスタンス全体をGit Syncで管理していたなら13.0.1へ上げてリポジトリから再同期、判断がつかなければバックアップを戻してから13.0.1へ、です。 ## 12.3→12.4→13.2の移行実測とロールバックの境界 13のアップグレードガイドは、Unified Storageへの移行後に旧版へ戻すと古いテーブルが読まれ、移行後の変更が反映されないと書いています。ここで見落とされやすいのが、12.4にも「小規模インスタンスはフォルダとダッシュボードをUnified Storageへ自動移行する」という破壊的変更がある点です（[v12.4のWhat’s new](https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v12-4/)）。どこで戻れなくなるのかを確かめるため、公式配布のmacOS版（12.3.11・12.4.13・13.2.4、SQLite構成）で、同じデータディレクトリのまま版を上げ下げしました（2026年10月19日）。 | 手順 | 作成したダッシュボード | 検索結果に出たもの | 旧テーブル | | --------------- | ------------ | -------------- | ------- | | 1\. 12.3.11で起動 | made-in-1230 | 1230 | 1230 | | 2\. 12.4.13へ上げる | made-in-1240 | 1230・1240 | 1230のまま | | 3\. 13.2.4へ上げる | made-in-1320 | 1230・1240・1320 | 1230のまま | | 4\. 12.4.13へ戻す | – | 1230・1240・1320 | 1230のまま | | 5\. 12.3.11へ戻す | – | 1230だけ | 1230のまま | 12.4.13の初回起動で `unifiedstorage_migration_log` テーブルが作られ、「folders and dashboards migration」が成功として記録されました。以後に作ったダッシュボードは新しいストレージ（`resource` テーブル）にだけ書かれ、旧来の `dashboard` テーブルには入りません。そのため12.4.13と13.2.4の間は行き来しても全件見えましたが、12.3.11へ戻した時点で12.4以降に作った2件が消えたように見えます。 ここから言えるのは、小規模インスタンスでは「13に上げたら戻れない」ではなく「12.4に上げた時点で12.3以前へは戻れない」ということです。12.4への更新も、アップグレード前のデータベースバックアップを取ってから行い、戻すときはバックアップのリストアを前提にしてください。公式は「小規模」の基準を示していないので、大きなインスタンスでは12.4で移行されず13で初めて移る場合があります。ログに「Auto-migration already completed」が出ているか、`unifiedstorage_migration_log` に「folders and dashboards migration」の成功（success=1）が記録されているかで、移行済みかを確かめられます。 ## Grafana 12に留まるか13へ上げるかの判断基準 12.0〜12.3で止まっている環境に「様子見」はありません。いずれも修正が止まっており、次に脆弱性が出ても直りません。まず12.4.13以降へ上げるのが先です。 **12.4に留めるべき環境**：使用中のプラグインは12.4で動いているものの、13の破壊的変更（Image Rendererの分離、カスタムロールの見直し、数値IDのAPI廃止）を検証する工数がいま取れない場合です。12.4は2027年5月24日まで修正を受けられるので、残り約7か月を13の検証にあてます。 **13へ上げるべき環境**：ダッシュボードをGitで管理したい、似たダッシュボードの複製が増えて管理しきれない、といった場合です。Git SyncとDynamic DashboardsはOSSの12ではGAに届かず、13で初めて本番に載せられる段階になりました。上げる先は13.2以降の最新パッチにし、13.0.0は選べません。 **避けるべきは、メジャーを飛ばして年1回だけ上げる運用です。**公式も、前メジャーの最終マイナーに年1回追従する戦略は、活発に開発されているプラグインとの互換性が限られると注意しています。11.6から13へ一気に上げると、Angular削除・APIキー用エンドポイントの削除（12）と、Image Rendererの分離・React 19・数値IDのAPI廃止（13）が同時に適用され、障害原因の切り分け対象が増えます。11.6→12.4→13.2と1段ずつ上げ、各段でバックアップを取ります。 2か月ごとの更新を自社で回し続けられないなら、[Amazon Managed Grafanaの対応バージョンと料金](/tech/details/4540/)のようにバージョン管理をマネージドに任せる手もあります。ただしマネージド側は新しい版への追随に時差があります。自社運用のまま更新計画と監視の保守を外に出したい場合は、[システムの保守運用・内製化支援](/service/system/maintenance/)で相談できます。 ## よくある質問 ### Grafanaの最新バージョンは何ですか？ 2026年10月19日時点では13.2.4（2026年10月13日公開）です。13.3は公式スケジュールで2026年10月20日の予定で、マイナー版は2か月ごとに進みます。導入前にGitHubのリリース一覧か公式のダウンロードページで確認してください。 ### Grafanaのバージョンはどこで確認できますか？ 画面右上のヘルプアイコン（?）をクリックするとバージョン番号が表示されます。ほかに、認証なしの `GET /api/health` の `version`、サーバー上の `grafana server -v` でも確認できます。13では `grafana-server` コマンドが無いので、`grafana server` を使います。 ### Grafana 12はまだサポートされていますか？ 12系で修正が届くのは12.4系だけで、期限は2027年5月24日です。12.0は2026年2月5日、12.1は4月22日、12.2は6月23日、12.3は8月19日にサポートが終わりました。 ### Grafana 11から12へ上げると何が動かなくなりますか？ Angularベースのプラグインです。v12では `angular_support_enabled` で有効にする手段もありません。ほかに、半角英数字・ハイフン・アンダースコア以外を含むデータソースUIDや40文字を超えるUIDの作成・更新が400で拒否され、12.1以降はAPIキー用のエンドポイントが無くなります。 ### Grafana 13から12へダウングレードできますか？ 公式は、Unified Storageへの移行後に戻す場合はアップグレード前のバックアップをリストアするよう求めています。小規模インスタンスでは12.4の時点で移行が済むため、12.4以降で作ったダッシュボードは12.3以前に戻すと表示されなくなります。 ## 関連記事 - [Grafana Lokiとは？仕組み・Alloyでの導入手順とLogQLの書き方【v3.7】](/tech/details/9570/) - [Grafana Tempoとは？3.xの仕組み・TraceQL・導入手順と2.xからの移行【3.1対応】](/tech/details/15584/) - [Amazon Managed Grafanaとは？料金・対応バージョン・作成手順とGrafana Cloudとの違い](/tech/details/4540/) - [OpenTelemetryとは｜LinuxでCollectorを動かしテレメトリを集める手順とPrometheusとの違い](/tech/details/3625/) - [LaravelでPrometheusとGrafana監視を実装：メトリクス収集・可視化・アラート設定](/tech/details/2932/) --- 出典: [Grafana 12とは？最新版13との違い・サポート期限・v11からの変更点とバージョン確認方法]()（株式会社一創）