View a markdown version of this page

Grafana のバージョン間の違い - Amazon Managed Grafana

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Grafana のバージョン間の違い

Grafana ワークスペースを作成するときは、作成する Grafana バージョンを選択する必要があります。Grafana バージョン 8、9、10、12 と互換性のあるバージョンから選択できます。いずれも、以前のバージョンから機能が追加されました。以下のトピックでは、バージョン 9、10、および 12 の変更について説明します。これには、以前のバージョンで使用する機能が破損する可能性がある変更が含まれます。

注記

Grafana ワークスペースを使用するためのバージョン固有のドキュメントはGrafana バージョン 10 での作業Grafana バージョン 12 での作業、、Grafana バージョン 9 での作業、および Grafana バージョン 8 での作業トピックで確認できます。

バージョン別の詳細なメモと Grafana Labs からの詳細については、「Grafana Labs ドキュメント」の「Grafana の新機能」を参照してください。

Grafana バージョン 12

Grafana バージョン 12 では、次の機能が追加されました。

ドリルダウンアプリケーション
  • メトリクスのドリルダウン – Prometheus メトリクスデータを探索するためのクエリレスのpoint-and-clickエクスペリエンス。「メトリクスのドリルダウン」を参照してください。

  • ログのドリルダウン – ボリュームパターンとテキストパターンで Loki ログを参照するためのクエリレスエクスペリエンス。「ログのドリルダウン」を参照してください。

  • トレースドリルダウン – 分散 Tempo トレースを探索するためのクエリレスエクスペリエンス。「トレースのドリルダウン」を参照してください。

  • プロファイルのドリルダウン – Pyroscope プロファイリングデータを参照するためのクエリレスエクスペリエンス。「プロファイルのドリルダウン」を参照してください。

ダッシュボードとビジュアライゼーション
  • シーンを活用したダッシュボード – ダッシュボードレンダリングエンジンは Scenes フレームワークを使用して再構築され、パフォーマンスの向上、テンプレート変数のサポートの向上、レイアウトの柔軟性が向上しました。

  • 新しいテーブルの視覚化 – テーブルパネルは、CSS セルのスタイル、テーブルフィールドからのツールヒントの生成、フッターの改善、インタラクティブボタンの新しいアクションセルタイプ、Cell Inspect の自動フォーマットされたセル値など、パフォーマンスと新機能を向上させるために完全に再構築されました。

  • Canvas の視覚化の改善 – Canvas パネルは、ワンクリックのデータリンクとアクション、動的な接続方向、ツールヒントを無効にする機能、パンとズームの改善をサポートするようになり、インタラクティブなデータ駆動型レイアウトをより詳細に制御できるようになりました。

  • 視覚化アクション – カスタム変数のサポート、ワンクリックデータリンク、テーブル視覚化の新しいアクションセルタイプを使用して、API コールをトリガーしたり URLs に移動したりする視覚化にインタラクティブなアクションを追加できるようになりました。

  • 条件付き書式を使用した色付きテーブル行 – テーブルの視覚化で行レベルの条件付き書式がサポートされるようになり、データ値に基づいて行全体を色付けできるようになりました。

  • 統計の視覚化率の変化 – 統計パネルは、設定可能なカラーモードオプションでパーセントの変化を表示するようになり、傾向が一目でわかるようになりました。

  • 棒ゲージでの凡例のサポート – 棒ゲージの視覚化で凡例がサポートされるようになり、複数のシリーズを表示する際の読みやすさが向上しました。

  • ステートタイムラインのページ分割 – ステートタイムラインの視覚化でページ分割がサポートされるようになり、大規模なデータセットを簡単にナビゲートできるようになりました。

  • 再設計されたダッシュボードフィルター – ダッシュボードリストフィルターは、より直感的なブラウジングエクスペリエンスを実現するために再設計されました。

  • 変数タイプの切り替え – 新しい変数タイプの切り替えを使用すると、クエリの値をすばやく切り替えて、ダッシュボードの操作を簡素化できます。

  • クエリ変数の静的オプション – クエリ変数は静的オプションをサポートするようになり、データソースクエリを必要とせずに変数値をより詳細に制御できるようになりました。

  • 拡張アドホックフィルター – アドホックフィルターでは、データソース間のサポートが改善され、ダッシュボードデータの動的フィルタリングが容易になりました。

  • Cron 構文による時間リージョン制御の向上 – 注釈は時間リージョンの Cron 構文をサポートするようになり、時間ベースの注釈をより正確に制御できるようになりました。

  • ジオマップのパフォーマンスの向上 – ジオマップの視覚化は、パフォーマンスの最適化によって大幅に高速にレンダリングされるようになりました。

  • ナビゲーションブックマーク – ナビゲーションメニューで頻繁に使用されるページをブックマークして、すばやくアクセスできるようになりました。

  • クエリからしきい値の色を設定する – クエリ変換の Config で、クエリ結果に基づいてしきい値の色を動的に設定できるようになりました。

  • 拡張カスタム通貨形式 – 新しいカスタム通貨形式オプションを使用すると、正確な財務値を正確な 10 進数制御で表示できます。

  • サーバー設定可能なクイック時間範囲 – 管理者は、ダッシュボードのタイムピッカーで使用できるクイック時間範囲オプションを設定できるようになりました。

  • お知らせバナー – 管理者はお知らせバナーを表示して、重要な情報をワークスペースユーザーに伝達できるようになりました。

変換
  • 値によるフィルタリングの部分文字列マッチャー – 値によるフィルタリング変換に部分文字列マッチャーが含まれるようになり、部分的なテキスト一致に基づいてデータをフィルタリングすることが容易になりました。

  • トレンドライン変換 – 新しいトレンドライン変換では、トレンドラインを追加し、平均を視覚化に移動することで、データのパターンを検出できます。

  • すべての数値フィールドのバイナリ変換 – テーブル内のすべての数値フィールドに同じバイナリ変換を一度に適用して、反復的な設定を減らすことができるようになりました。

  • 抽出フィールドの新しい正規表現オプション – 抽出フィールド変換で正規表現がサポートされるようになり、テキストデータからより強力なフィールド抽出が可能になりました。

  • 変換の更新 – 変換パイプライン全体で新しいモードやユーザビリティの強化など、複数の変換の改善が追加されました。

  • すべての変換のダッシュボード変数 – ダッシュボード変数がすべての変換タイプでサポートされるようになり、データ処理パイプラインの柔軟性が向上しました。

[アラート]
  • Grafana マネージドアラートの最終状態を保持する – クエリがデータまたはエラーを返さないときに最後の状態を維持するようにアラートルールを設定できるようになりました。これにより、不要なアラート状態の変更を防ぐことができます。

  • アラート詳細ビューの再設計 – アラートルールの詳細ビューは、より明確なレイアウトとより実用的な情報で再設計されました。

  • アラートテンプレートセレクタ – アラート UI の新しいテンプレートセレクタを使用すると、通知テンプレートの選択と適用が容易になります。

  • 一時停止されたアラートの可視性の向上 – 一時停止されたアラートルールが UI でより明確に示されるようになり、どのルールがアクティブに評価されていないかを簡単に特定できるようになりました。

  • Grafana マネージドアラートでのみ使用可能: ルール固有のサイレンス – きめ細かなアクセス許可を持つ特定のアラートルールに適用されるサイレンスを作成し、より的を絞ったアラート抑制を提供できるようになりました。

  • Grafana マネージドアラートの録画ルール – Grafana マネージドアラートで録画ルールを使用できるようになりました。これにより、頻繁に使用されるクエリを事前計算してパフォーマンスを向上させることができます。これにより、非推奨の記録されたクエリ機能が置き換えられます。「記録ルールを設定する」を参照してください。

  • アラートルールのバージョン履歴 – アラートルールがバージョン履歴を維持するようになりました。これにより、変更を追跡して以前の設定に戻すことができます。

  • Grafana が管理するアラートルールの「復旧中」状態 – アラートルールが「復旧中」状態をサポートするようになりました。これは、アラート条件が発砲されなくなったが、まだ正常に戻っていないことを示します。

  • アラートルールの改善 – Grafana が管理するアラートルールには、更新されたリストページ、アクティブな時間間隔、Prometheus YAML からルールをインポートする機能、再設計された設定ページなど、複数のユーザビリティの改善が含まれています。

と ログを調べる
  • 新しいログの視覚化 – 新しいログの視覚化パネルでは、表示されるフィールドをカスタマイズするための新しいフィールドセレクタコンポーネントを使用して、ログのレンダリングが改善されています。

  • JSON Log Line Viewer – Logs Drilldown アプリに構造化ログ行の JSON ビューワーが含まれるようになり、JSON 形式のログデータを簡単に検査できるようになりました。

  • Loki の前方方向検索 – Explore の Loki クエリが前方方向検索をサポートするようになり、最も古いものから最新のものまでログを検索できるようになりました。

  • Explore の相関関係 – Explore から直接外部 URLs に相関関係を追加できるようになりました。これにより、データソースと外部システム間のシームレスなナビゲーションが可能になります。「Grafana バージョン 12 の相関関係」を参照してください。

データソース
  • Amazon Managed Service for Prometheus データソースの移行 – このリリース以降、 Core Prometheus プラグインでの Sigv4 認証のサポートは廃止されました。Grafana バージョン 12 にアップグレードすると、以前に Core Prometheus プラグインを使用していたすべての Amazon Managed Service for Prometheus データソースが Amazon Managed Service for Prometheus プラグインに自動的に移行されます。これらのデータソースを使用するダッシュボードは、この変更を反映するように自動的に更新されます。

  • PPL と SQL を使用した Amazon CloudWatch Logs Insights – 標準のクエリ言語に加えて、PPL (パイプ処理言語) と SQL 構文を使用して Amazon CloudWatch Logs Insights をクエリできるようになりました。

  • Amazon CloudWatch Metric Insights クロスアカウントサポート – Amazon CloudWatch Metric Insights はクロスアカウントオブザーバビリティをサポートするようになり、複数の にわたってメトリクスをクエリできるようになりました AWS アカウント。

  • Amazon CloudWatch Logs 異常検出とパターン分析 – Amazon CloudWatch データソースは、ログデータの異常なパターンを識別するためのログ異常検出とパターン分析をサポートするようになりました。

  • OpenSearch PPL とサンプルクエリ – OpenSearch データソースが PPL 言語とサンプルクエリをサポートするようになり、クエリの構築が容易になりました。

  • MSSQL Windows Active Directory 認証 – Microsoft SQL Server データソースが Windows Active Directory (Kerberos) 認証をサポートするようになりました。

  • 古い Tempo および Loki 検索の削除 – 従来の Tempo 検索インターフェイスと Loki 検索インターフェイスは、TraceQL を使用した検索エクスペリエンスに代わって削除されました。

  • BigQuery サービスアカウントのなりすまし – BigQuery データソースは、より柔軟な認証のためにサービスアカウントのなりすましをサポートするようになりました。

  • Google Sheets テンプレート変数 – Google Sheets データソースが動的データクエリのテンプレート変数をサポートするようになりました。

  • SQL データソースの時系列マクロサポート – SQL データソースのビジュアルクエリビルダーが時系列マクロをサポートするようになり、時間ベースのクエリが簡素化されました。

  • Databricks での Unity Catalog サポート – Grafana Databricks プラグインは、統合データガバナンスのために Unity Catalog をサポートするようになりました。

  • Honeycomb raw クエリのサポート – Honeycomb データソースは、高度なクエリ機能の raw クエリをサポートするようになりました。

  • GitHub アプリ認証 – GitHub データソースは、個人用アクセストークンの代わりに GitHub アプリ認証をサポートするようになりました。

認証とセキュリティ
  • サービスアカウントに移行された API キー – API キーは完全に廃止され、サービスアカウントに自動的に移行され、セキュリティおよび管理機能が向上しました。「サービスアカウントの使用」を参照してください。

  • OAuth および SAML セッション処理の改善 – OAuth および SAML 認証プロバイダーのセッション処理が改善され、信頼性とセキュリティが向上しました。

  • Entra Workload Identity サポート – Grafana は、Azure 環境での認証用に Microsoft Entra Workload Identity をサポートするようになりました。

  • OAuth2 for Alertmanager and Mimir – バニラアラートマネージャーと Mimir データソースの HTTP 設定で OAuth2 認証を設定できるようになりました。

Accessibility
  • GeoMap キーボードのサポート – GeoMap ビジュアライゼーションでキーボードナビゲーションがサポートされ、アクセシビリティが向上しました。

  • パネルショートカットキーボードのサポート – ダッシュボードパネルで、一般的なアクションのキーボードショートカットがサポートされるようになりました。

  • 見出しとモーションの軽減 – 見出し構造はスクリーンリーダー向けに改善され、アニメーションを最小限に抑えたいユーザー向けにモーションのサポートが減少しました。

重要な変更

重要

レガシーアラートは完全に削除されます – レガシーアラートは Amazon Managed Grafana v12 で完全に削除され、レガシーアラート設定を持つワークスペースは起動できません。v12 にアップグレードする前に、レガシーアラートから Grafana アラートに移行する必要があります。「従来のダッシュボードアラートを Grafana アラートに移行する」および「従来のダッシュボードアラート」を参照してください。

重要

AngularJS サポートが削除されました – Amazon Managed Grafana v12 では AngularJS サポートが完全に削除されるため、Angular ベースのプラグインはロードされず、それらを使用するダッシュボードにエラーが表示されます。アップグレードする前に、すべての Angular ベースのプラグインを React の代替品に移行する必要があります。ワークスペースでのプラグインの管理プラグインカタログによるプラグインの検索については、「」を参照してください。

重要

API キーが削除される – Amazon Managed Grafana v12 では、サービスアカウントに代わって API キーが完全に削除され、既存の API キーは機能しなくなります。アップグレードする前に、すべての API キーを置き換えるサービスアカウントを作成し、自動化を更新してサービスアカウントトークンを使用する必要があります。「サービスアカウントの使用」を参照してください。

重要

アラートルールの評価結果の制限 – アラートルールあたりのクエリ評価結果の数は 500 に制限されるようになりました。アラートルールの条件クエリがこの制限よりも多くの結果を生成する場合、評価はエラーになります。このエラーが発生したときにアラートを受信するには、アラートルールの設定ErrorAlert state if execution error or timeoutを に設定します。「アラートルールの状態と正常性」を参照してください。

重要

注釈は 300 万に制限 – 注釈の数はワークスペースあたり 300 万に制限されるようになりました。300 万個を超える注釈が作成された場合、最も古い注釈が最初に削除されます。

  • 入力データソースが削除される – 入力データソースプラグインが完全に削除されたため、アップグレードする前に、影響を受けるダッシュボードを TestData データソースに移行する必要があります。Grafana Labs ドキュメントのTestData ドキュメント」を参照してください。

  • クエリフィルタリングの動作の変更 – 「クエリを無効にする」ボタンが「レスポンスを非表示/レスポンスを表示」になり、非表示のクエリのレスポンスはパネルに返されなくなりました。アップグレード後にデータが欠落している場合は、クエリ設定を確認し、パネルを更新します。Grafana Labs ドキュメント「クエリフィルタリングの変更」を参照してください。

  • データソース UIDsより厳格な形式に従う必要があります。データソース UIDs は英数字、ハイフン、アンダースコアのみを使用する必要があるため、アップグレードする前に非準拠UIDs とそのダッシュボード参照を更新する必要があります。Grafana Labs ドキュメント「Stricter Data Source UID Format」を参照してください。

  • 繰り返しパネルのパネルビュー URLsが変更されました – 個々の繰り返しパネルを表示するための URL 形式が変更され、古い URLs「パネルが見つかりません」エラーを返すため、ビューモードでパネルを開いてブックマークまたはオートメーションを更新して新しい URLsを取得します。Grafana Labs ドキュメント「パネルビュー URL の変更」を参照してください。

  • フォワードスラッシュを持つフォルダにはエスケープされたマッチャーが必要です – サブフォルダの導入により、フォワードスラッシュを含むフォルダに関連付けられたアラートルールが壊れる可能性があるため、エスケープされたマッチャー ( などgrafana_folder=MyFolder\/sub-folder) で通知ポリシーを更新したり、フォルダの名前を変更してアップグレード前にフォワードスラッシュを削除したりできます。「ダッシュボードフォルダの作成」および「通知ポリシーを設定する」を参照してください。

  • アラートテンプレート $value 変数の動作変更 – アラート通知テンプレートの $value変数は、単一のデータソースをクエリするときにクエリ値を返すようになりました。そのため、 を使用するアラートテンプレートを確認し、必要に応じてフォーマット$valueを更新します。「ラベルと注釈のテンプレート作成」を参照してください。

  • アラートルールアクセス許可の緩和 – アラートルールにアクセスするためのアクセス許可要件が緩和されました。Grafana Labs ドキュメントの許可の使用「」と「Grafana v11.1 の新機能」を参照してください。 https://grafana.com/docs/grafana/latest/whatsnew/whats-new-in-v11-1/#removes-requirement-of-datasourcesquery-permission-for-reading-rules

  • デフォルトで有効になっている録画ルール – Grafana アラートで録画ルールがデフォルトで有効になりました。「記録ルールを設定する」を参照してください。

  • 内部アラートマネージャー設定 POST エンドポイントの削除 – 内部 Grafana アラートマネージャー設定の POST エンドポイントが削除されたため、アップグレードする前に新しいプロビジョニングエンドポイント ( などPOST /api/v1/provisioning/alert-rules) を使用するように API 統合を更新する必要があります。

  • ビューワーとエディタのアクセス許可の拡張 – ビューワーは注釈の読み取りと書き込みが可能になり、エディタは注釈を作成および削除できるようになりました。「許可の使用」を参照してください。

  • 作成者のアクセス許可の変更 – リソースの作成者 (ダッシュボードやフォルダなど) に付与されたアクセス許可が変更されました。アップグレード後にアクセスコントロールの設定を確認してください。Grafana Labs ドキュメント「作成者権限の変更」を参照してください。

  • API キーに関連付けられたアクセス許可の削除 – API キーに関連付けられたアクセス許可は、サービスアカウントへの完全な移行の一環として削除されました。Grafana Labs ドキュメントの「API キーに関連付けられたアクセス許可の削除」を参照してください。

  • SNS コンタクトポイントの移行 – SNS コンタクトポイントは、新しい SNS 通知機能に自動的に移行されます。この移行には手動アクションは必要ありません。ただし、SNS のコンタクトポイント設定スキーマが変更されました。更新されたリクエスト形式の例通知チャネルの作成については、「」を参照してください。

  • アラートルールの評価結果の制限 – アラートルールあたりのクエリ評価結果の数は 500 に制限されるようになりました。アラートルールの条件クエリがこの制限よりも多くの結果を生成する場合、評価の結果はエラーになります。このエラーが発生したときにアラートを受信するには、アラートルールの設定ErrorAlert state if execution error or timeoutを に設定します。

  • Core Prometheus プラグインから SigV4 認証を削除 – Core Prometheus プラグインでの SigV4 認証のサポートは削除されました。Grafana バージョン 12 にアップグレードすると、以前に Core Prometheus プラグインを使用していたすべての Amazon Managed Service for Prometheus データソースが Amazon Managed Service for Prometheus プラグインに自動的に移行されます。これらのデータソースを使用するダッシュボードは、この変更を反映するように自動的に更新されます。「Amazon Managed Service for Prometheus データソースに接続する」を参照してください。

Amazon Managed Grafana v12 には、オープンソースの Grafana v11.0 から v12.4 までの機能が含まれています。 AWS固有の機能については、「Amazon Managed Grafana ユーザーガイド」を参照してください。最新情報の詳細については、Grafana Labs ドキュメントの Grafana for v11.x および v12.x の最新情報を参照してください。 バージョン 11.x および 12.x には、機能を損なう可能性のある変更が含まれているため、本番稼働用ワークスペースを更新する前に非本番稼働環境でテストします。

重要な変更の詳細については、Grafana Labs ドキュメントの以下のトピックを参照してください。

Grafana 12

Grafana 11

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 APIsを介してのみ作成できます。

    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/query API は削除されました。

    必要なアクション: 代わりに /api/ds/query を使用します。Grafana 公開ドキュメントの「データソースのクエリ」および GitHub の「問題」#49916 を参照してください。

  • API エンドポイントの変更 – 一部のアラート API エンドポイントでは、数値 ID の代わりにデータソース UID が必要になるようになりました。

    影響を受けるエンドポイント: api/v1/rule/testapi/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.passwordsecureJsonData.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.jsonTime のように time フィールドを編集します。GitHub の「問題」#64842 を参照してください。

  • ログメッセージ形式の更新 – ログメッセージ構造が変更されました。

    lvllevel になりました。erordbugerrordebug になりました。タイムスタンプの精度が向上しました。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 を参照してください。