Grafana のバージョン間の違い
Grafana ワークスペースを作成するときは、作成する Grafana バージョンを選択する必要があります。Grafana バージョン 8、9、10 と互換性のあるバージョンを選択できます。いずれも、以前のバージョンから機能が追加されました。以下のトピックでは、バージョン 9 および 10 の変更点について説明します。これには、バージョン 9 で使用する機能を破損する可能性のあるバージョン 10 の変更点が含まれます。
注記
Grafana ワークスペースを使用するためのバージョン固有のドキュメントは、「Grafana バージョン 8 での作業」、「Grafana バージョン 9 での作業」、および「Grafana バージョン 10 での作業」トピックで確認できます。
バージョン別の詳細なメモと Grafana Labs からの詳細については、「Grafana Labs ドキュメント」の「Grafana の新機能
Grafana バージョン 10
Grafana バージョン 10 では、以下の機能が追加されました。
-
[相関関係] – 相関関係は、あるデータソース内のデータを使用して別のデータソース内のデータにクエリを実行する方法を定義し、Explore による視覚化が、表示されたデータに関連するクエリを簡単に実行できるようにします。詳細については、「Grafana バージョン 10 の相関関係」を参照してください。
-
サブフォルダ – ダッシュボードを整理するときに、サブフォルダを使用してネストされた階層を作成できるようになりました。詳細については、「ダッシュボードフォルダの作成」を参照してください。
-
アラート – Grafana アラートは、サイレントアラートをサポートするようになりました。さらに、Grafana アラートは通知を 3 回送信しなくなりました。
-
[アラートのアップグレードプレビュー] – 従来のダッシュボードアラートから Grafana アラートにアップグレードする前に、アラートがどのように表示されるかを確認し、移行時に適用される変更を加えることもできます。詳細については、「従来のダッシュボードアラートを Grafana アラートに移行する」を参照してください。Grafana Labs は、Grafana バージョン 11 以降では、従来のダッシュボードアラートがサポート対象外となることを発表しました。
-
サポートバンドル – サポートバンドルは、Grafana ワークスペースに関する情報を収集して製品サポートと共有するための簡単な方法を提供します。移行、プラグイン、設定などのデータを含むサポートバンドルをすばやく作成できます。詳細については、「サポート用情報の収集」を参照してください。
-
新しいビジュアライゼーション — 3 つの新しいビジュアライゼーションが利用可能です。XY チャート、データグリッド、および トレンドパネルはすべて、バージョン 10 と互換性のあるワークスペースで使用できます。また、バージョン 9 のワークスペースでも、XY チャートを使用できます。
-
PagerDuty – エンタープライズ向けプラグインに PagerDuty のプラグインが搭載されました。
-
[トランスフォーメーションの再設計] – トランスフォーメーションタブでは、ユーザーエクスペリエンスとビジュアルデザインが改善されています。トランスフォーメーションは分類され、各トランスフォーメーションタイプには、適切なタイプを選択するのに役立つ解説があります。
-
Prometheus メトリクス百科事典 – Prometheus クエリビルダーにある Prometheus メトリクスのメトリクスドロップダウンが、ページ分割された検索可能なメトリクス百科事典に置き換わりました。
-
API キー UI の中止 – サービスアカウントは、Grafana HTTP API への呼び出しを認証する方法としてお勧めします。Grafana Labs は API キーの中止を推進していて、ワークスペースユーザーインターフェイスを通じて API キーを作成することはできなくなりました。API キーは、AWS API を介してのみ作成できます。
Grafana Labs による API キー中止の詳細については、Grafana GitHub の問題リストにある「APIKeys: API キーの終了
」を参照してください。
重要な変更
Grafana バージョン 10.4 リリースには、Grafana バージョン 9.5 から 10.4 への変更が含まれています。Grafana バージョン 10.0 および 10.3 には、場合によっては機能を損なう可能性のある変更がいくつかありました。新しいバージョンに更新する場合は、本番稼働用ワークスペースを更新する前に、本番稼働用以外の環境でテストすることをお勧めします。
以下の変更は、Grafana バージョン 10 に更新する一部のユーザーに影響する可能性があります。
-
Angular の中止 – Angular を使用するプラグインは、Grafana の今後のリリースではサポートされなくなります。バージョン 10 では、Angular を使用するパネルにおいて、廃止された機能を使用していることを示すバナーが表示され、将来のバージョンでは機能しないという通知が表示されます。
-
CloudWatch のエイリアスを削除 – CloudWatch クエリエディタのエイリアスパターンがラベル (動的ラベル) に置き換えられました。
エイリアスフィールドを使用する任意のダッシュボードを開き、保存してください。エイリアスはラベルに自動的に移行されます。
-
古いプラグインはアップグレードが必要 – Athena および Amazon Redshift データソースのプラグインを Grafana v10 ワークスペースで更新する必要があります。Athena データソースプラグインはバージョン 2.9.3 以降である必要があります。また、Amazon Redshift データソースプラグインはバージョン 1.8.3 以降である必要があります。
プラグインのインストールまたはアップグレードに関する詳細については、「プラグインカタログによるプラグインの検索」を参照してください。
-
DoiT BigQuery プラグインは今後サポート対象外 – DoiT BigQuery データソースプラグインはサポートされなくなりました。代わりに、公式の Grafana Labs BigQuery データソースプラグインをご使用ください。
-
[トランスフォーメーションの変更] – Grafana バージョン 10 では、フィールド名とキーにいくつかのバグ修正変更を行いました。詳細については、Grafana Labs のドキュメントにある「変換に関する重要な変更
」を参照してください。 -
データソースへのアクセス許可 API – データソースの権限にアクセスするためのエンドポイントが変更されました。詳細については、Grafana Labs ドキュメントにある「データソースのアクセス許可の変更
」を参照してください。
変更の中断、およびプラグインデベロッパーに影響する重要な変更の詳細については、「Grafana Labs ドキュメント」にある以下のトピックを参照してください。
Grafana バージョン 9
Grafana v9 では、以下の機能が追加されました。
-
アラート: Grafana が管理するアラートルールがグループ名をサポートするようになりました。
-
[Explore]: Explore ビュー内からダッシュボードを作成します。
-
Prometheus クエリ: Prometheus クエリの新しいクエリビルダー (PromQL を使用) を使用すると、クエリの書き込みが容易になります。
-
Loki クエリ: Loki クエリの新しいクエリビルダー (LogQL を使用) を使用すると、クエリの書き込みが容易になります。
-
API トークン/サービスアカウント: サービスアカウントは Grafana でのマシンアクセスを簡素化し、API トークンの管理に役立ちます。
-
プラグイン管理: プラグイン管理を有効にすると、ワークスペースにコミュニティプラグインをインストール、削除、更新できます。これにより、より多くのデータソースや視覚化にアクセスでき、使用する各プラグインのバージョン全体を管理できます。
-
メトリクスへのトレース: トレースデータソースを設定して、クエリとタグを含むメトリクスへのリンクを追加します。
-
Canvas パネル: 静的要素と動的要素を含む新しいパネル視覚化で、画像とオーバーレイテキストを含むデータ駆動型のカスタムパネルを作成します。
-
インターフェイスの再編成: Grafana コンソールでのナビゲーションを容易にして UI を更新しました。
-
CloudWatch: Amazon CloudWatch データソースは、AWS アカウント 全体および AWS リージョン 全体のメトリクスをモニタリングできるようになりました。
-
ログ: ログの詳細のインターフェイスが改善されました。
-
全般: バグ修正と全体的に改良を行いました。
重要な変更
Grafana バージョン 9.4 リリースには、以前のバージョンに追加された、さまざまな新機能と改善点が含まれています。このバージョンには、場合によっては機能を損なう可能性のある変更がいくつかありました。新しいバージョンに更新する場合は、本番稼働用ワークスペースを更新する前に、本番稼働用以外の環境でテストすることをお勧めします。
以下の変更は、Grafana バージョン 9.4 に更新する一部のユーザーに影響する可能性があります。これらの変更の詳細なリストについては、GitHub の「Grafana 9.4 変更ログ
-
API の中止 –
/api/tsdb/queryAPI は削除されました。必要なアクション: 代わりに
/api/ds/queryを使用します。Grafana 公開ドキュメントの「データソースのクエリ」および GitHub の「問題」#49916 を参照してください。 -
API エンドポイントの変更 – 一部のアラート API エンドポイントでは、数値 ID の代わりにデータソース UID が必要になるようになりました。
影響を受けるエンドポイント:
api/v1/rule/test、api/prometheus/、api/ruler/、api/alertmanager/必要なアクション: データソース UID をパスパラメータとして使用するように API コールを更新します。GitHub の「問題」#48070
、#48052 、#48046 、#47978 を参照してください。 -
Azure Monitor クエリの削除 – Application Insights クエリと Insight Analytics クエリはサポートされなくなりました。
Grafana 8.0 では廃止され、9.0 では削除されました。廃止されたクエリは実行されません。
必要なアクション: 移行ガイダンスについては、Grafana 公開ドキュメントの「Azure Monitor データソース
」を参照してください。 -
ブラウザアクセスモードの削除 – ブラウザアクセスモードは InfluxDB および Prometheus データソースで使用できなくなりました。
必要なアクション: データソース設定でサーバーアクセスモードに切り替えます。InfluxDB: 8.0.0 では廃止され、9.2.0 では削除されました。GitHub の「問題」#53529
を参照してください。Prometheus: 7.4.0 では廃止され、9.2.0 では削除されました。GitHub の「問題」#50162 を参照してください。 -
ダッシュボード設定へのアクセスの制限 – パネルの編集中にダッシュボード設定を開くことができなくなりました。
ダッシュボード設定は、パネル編集モードがアクティブになるとロックされます。ダッシュボード設定にアクセスする前に、パネル編集モードを閉じます。GitHub の「問題」#54746
を参照してください。 -
データソースパスワードの暗号化 – 暗号化されていないパスワードはサポートされなくなりました。
必要なアクション:
secureJsonData.passwordとsecureJsonData.basicAuthPasswordを使用します。以前に v8.1.0 で中止されました。GitHub の「問題」#49987を参照してください。 -
デフォルトのデータソース動作 – デフォルトのデータソースの選択は、既存のパネルに影響を与えなくなりました。
デフォルトのデータソースは、新しいパネルにのみ適用されます。デフォルトを変更しても、既存のダッシュボードは更新されません。以前に保存したパネルは、データソース設定を保持します。GitHub の「問題」#45132
を参照してください。 -
Elasticsearch 間隔プロパティの変更 – Elasticsearch 7.x のクエリ間隔仕様が更新されました。
intervalプロパティからfixed_intervalプロパティに変更しました。Elasticsearch 8.x と整合させました。ほとんどのクエリでは目に見える変更はありません。GitHub の「問題」#50297を参照してください。 -
Elasticsearch Raw ドキュメントモードの中止 – Elasticsearch データソースで表示モードが変更されます。
必要なアクション: 代わりに Raw Data モードを使用します。GitHub の「問題」#62236
を参照してください。 -
Elasticsearch バージョンサポート – 古い Elasticsearch バージョンはサポートされなくなりました。
必要なアクション: Elasticsearch をバージョン 7.10.0 以降にアップグレードします。7.10.0 より前のバージョンは有効期限を過ぎています。GitHub の「問題」#48715
を参照してください。 -
Explore URL 形式の中止 – Compact Explore URL は今後のリリースで削除されます。
必要なアクション: ハードコードされたリンクを更新して、標準の URL 形式を使用します。Compact URL:
&left=["now-1h","now"...]。標準 URL:&left={"datasource":"test"...}。GitHub の「問題」#50873を参照してください。 -
GitHub OAuth 表示の変更 – GitHub 名とログイン表示が更新されました。
GitHub 名は Grafana 名として表示されます。GitHub ログインは Grafana ログインとして表示されます。ユーザー識別の明確性が向上しました。GitHub の「問題」#45438
を参照してください。 -
ヒートマップパネル実装の更新 – 9.1.0 以降、ヒートマップパネルは新しい実装を使用します。
レンダリングパフォーマンスが大幅に向上しました。バケットは妥当な境界線 (1m、5m、30s) に配置されます。ラウンドセルはサポートされなくなりました。
必要なアクション: アップグレード後にヒートマップパネルをテストします。必要に応じて
useLegacyHeatmapPanel機能フラグを True に設定して、新しい実装を無効にします。テストするには、ダッシュボード URL に?__feature.useLegacyHeatmapPanel=trueを追加します。GitHub の「問題」#50229を参照してください。 -
InfluxDB バックエンド移行 — InfluxDB データ解析の動作が変更されました。
バックエンド処理の問題により、InfluxDB バックエンド移行機能のトグル (
influxdbBackendMigration) が再導入されます。デフォルトでは、InfluxDB データはフロントエンドで解析されます。9.4.4 にアップグレードし、InfluxDB データに変換を追加した場合、これらのパネルはレンダリングに失敗します。必要なアクション: 影響を受けるパネルを削除して再作成するか、
panel.jsonまたはdashboard.jsonのTimeのようにtimeフィールドを編集します。GitHub の「問題」#64842を参照してください。 -
ログメッセージ形式の更新 – ログメッセージ構造が変更されました。
lvlはlevelになりました。erorとdbugはerrorとdebugになりました。タイムスタンプの精度が向上しました。oldlog機能トグルでオプトアウトできます (一時的)。GitHub の「問題」#47584を参照してください。 -
Loki データ形式の最適化 – Loki ログデータは、より効率的なデータフレーム形式を使用します。
個別のデータフレームではなく [ラベル] 列を持つ単一のデータフレーム。検索パネルとログパネルは変更なしで機能します。他のパネルや変換には調整が必要な場合があります。
必要なアクション: [フィールドへのラベル付け] 変換を [フィールドの抽出] 変換に置き換えます。GitHub の「問題」#47153
を参照してください。 -
NaN 値処理 – Prometheus データソースと Loki データソース間で一貫した
NaN表現。NaN値は、nullに変換する代わりにNaNのままになります。変更のほとんどはユーザーには見えません。ダッシュボードパスとアラートパスの両方に影響します。GitHub の「問題」#49475と #45389 を参照してください。 -
パスワードリセットリンクの無効化 – アップグレード後は、既存のパスワードリセットリンクが機能しません。
アップグレード前に送信されたパスワードリセットリンクは無効になります。ユーザーは新しいパスワードリセットリンクをリクエストする必要があります。リンクは 2 時間後に期限切れになります。GitHub の「問題」#42334
を参照してください。 -
予約済みラベルプレフィックス –
grafana_で始まるラベルは予約されています。grafana_で始まる手動で設定されたラベルは上書きされる場合があります。現在の予約済みラベル:grafana_folder(アラートを含むフォルダのタイトル)。GitHub の「問題」#50262を参照してください。 -
変換の改善 – 正規表現による名前変更変換がグローバルパターンをサポートするようになりました。
グローバルパターンは
/<stringToReplace>/g形式を使用します。一部の変換の動作は異なる場合があります。前の動作における一致文字列をスラッシュで囲みます。(.*)は/(.*)/になります。GitHub の「問題」#48179を参照してください。