翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 APIs への呼び出しを認証するために推奨される方法です。Grafana Labs は API キーの中止に取り組んでいますが、ワークスペースユーザーインターフェイスから API キーを作成することはできません。API キーは AWS APIsを介してのみ作成できます。
Grafana Labs による API キーの廃止の詳細については、Grafana GitHub の問題リストのAPIKeys: Sunsetting of API keys
」を参照してください。
重要な変更
Grafana バージョン 10.4 リリースには、Grafana バージョン 9.5 から 10.4 への変更が含まれています。Grafana バージョン 10.0 および 10.3 には、場合によっては機能を損なう可能性のある変更がいくつかありました。新しいバージョンに更新する場合は、本番稼働用ワークスペースを更新する前に、本番稼働用以外の環境でテストすることをお勧めします。
以下の変更は、Grafana バージョン 10 に更新する一部のユーザーに影響する可能性があります。
-
Angular の廃止 – Angular を使用するプラグインは、Grafana の今後のリリースではサポートされなくなります。バージョン 10 では、角度を使用するパネルには、廃止された機能を使用していることを示すバナーが表示され、将来のバージョンでは機能しないことが通知されます。
-
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/query
API は削除されました。必要なアクション:
/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 のクエリ間隔仕様が更新されました。
fixed_interval
を プロパティinterval
に変更しました。Elasticsearch 8.x との整合性を提供します。ほとんどのクエリには表示可能な変更が表示されません。GitHub の「問題 #50297」を参照してください。 -
Elasticsearch Raw ドキュメントモードの廃止 – Elasticsearch データソースでモードの変更を表示します。
必要なアクション: 代わりに raw データモードを使用します。GitHub の「問題 #62236
」を参照してください。 -
Elasticsearch バージョンサポート – 古い Elasticsearch バージョンはサポートされなくなりました。
必要なアクション: Elasticsearch をバージョン 7.10.0 以降にアップグレードします。7.10.0 より前のバージョンはend-of-lifeです。GitHub の「問題 #48715
」を参照してください。 -
Explore URL 形式は廃止 – Compact Explore URLsは今後のリリースで削除されます。
必要なアクション: ハードコードされたリンクを更新して、標準の URL 形式を使用します。コンパクト URLs:
&left=["now-1h","now"...]
。標準 URLs:&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
に を追加してテストURLs。GitHub の「問題 #50229」を参照してください。 -
InfluxDB バックエンド移行 — InfluxDB データ解析の動作が変更されました。
InfluxDB バックエンド移行機能のトグル (
influxdbBackendMigration
) は、バックエンド処理の問題により再導入されます。デフォルトでは、InfluxDB データはフロントエンドで解析されます。9.4.4 にアップグレードし、InfluxDB データに変換を追加した場合、これらのパネルはレンダリングされません。必要なアクション: 影響を受けるパネルを削除して再作成するか、
panel.json
またはTime
のようにtime
フィールドを編集しますdashboard.json
。GitHub の「問題 #64842」を参照してください。 -
ログメッセージ形式が更新されました – ログメッセージ構造が変更されました。
lvl
は になりましたlevel
。eror
とdbug
はerror
になりましたdebug
。タイムスタンプの精度が向上しました。oldlog
機能トグル (一時) でオプトアウトできます。GitHub の「問題 #47584」を参照してください。 -
Loki データ形式の最適化 – Loki ログのデータは、より効率的なデータフレーム形式を使用します。
個別のデータフレームではなくラベル列を持つ単一のデータフレーム。Explore パネルと Logs パネルは変更なしで機能します。他のパネルや変換には調整が必要な場合があります。
必要なアクション: ラベルをフィールド変換に抽出フィールド変換に置き換えます。GitHub の「問題 #47153
」を参照してください。 -
NaN 値処理 – Prometheus データソースと Loki データソース間で一貫した
NaN
表現。NaN
値は、 に変換NaN
する代わりに のままですnull
。変更のほとんどはユーザーには表示されません。ダッシュボードパスとアラートパスの両方に影響します。GitHub の「問題 #49475と #45389 」を参照してください。 -
パスワードリセットリンクが無効 – アップグレード後、既存のパスワードリセットリンクは機能しません。
アップグレード前に送信されたパスワードリセットリンクが無効です。ユーザーは新しいパスワードリセットリンクをリクエストする必要があります。リンクは 2 時間後に期限切れになります。GitHub の「問題 #42334
」を参照してください。 -
予約済みラベルプレフィックス – で始まるラベル
grafana_
は予約されています。で始まる手動で設定されたラベルは上書き
grafana_
される場合があります。現在の予約済みラベル:grafana_folder
(アラートを含むフォルダのタイトル)。GitHub の「問題 #50262」を参照してください。 -
変換の改善 – 正規表現変換で名前を変更すると、グローバルパターンがサポートされるようになりました。
グローバルパターンは 形式を使用します
/<stringToReplace>/g
。一部の変換の動作は異なる場合があります。前の動作の一致文字列をスラッシュでラップします。 は(.*)
になります/(.*)/
。GitHub の「問題 #48179」を参照してください。