Managed Service for Grafana:Grafana v10.0.x の新機能

Grafana v10.0.x には、次のアップデートが含まれます：

• パネルの更新

• ダッシュボードの更新

• ナビゲーションの更新

• Grafana アラートの更新

新しいパネル

XY Chart パネル

Grafana v10.0.x では、新しい XY Chart パネルが導入され、折れ線グラフと散布図をサポートします。Grafana XY Chart パネルの右側にある設定ペインでは、[Y Fields] セクションに、x や y などの選択したデータフィールドが一覧表示されます。[Show] オプションでは、[Points]、[Lines]、[Both] の 3 つの表示モードを利用できます。[Both] を選択すると、データポイントとそれらを結ぶ線の両方が表示されます。その他の設定項目には、[Point size] (デフォルトは 5)、[Line style] (Solid / Dash / Dots)、[Line width]、[Tooltip mode] (Single)、[Legend] の表示/非表示があります。下部のクエリエディターでは、[Data source] を [-- Grafana --] に、[Query type] を [Spreadsheet or snapshot] に設定します。その後、[Replace file] オプションを使用してデータファイルをアップロードできます。

XY Trend パネル

Grafana v10.0.x では XY Trend パネルが追加され、x 軸に時刻ではなく増加する数値をとるトレンドを表示します。このパネルは、時系列パネルや XY Chart パネルのいずれでも対応できない課題を解決します。たとえば、関数グラフ、RPM/トルク曲線、需要と供給の関係をプロットできます。

Datagrid パネル

Grafana v10.0.x では Datagrid パネルが追加され、Grafana ダッシュボード内でデータを編集できます。このパネルを使用して、データソースから読み込んだデータを微調整したり、ゼロから新しいデータを作成したりできます。

パネルエディターで、[Datagrid] の可視化タイプを選択し、データソースを [-- Grafana --] に設定して、[Query type] を [Spreadsheet or snapshot] に設定します。データグリッドでは、行と列のデータを直接編集できます。また、ファイルをドラッグ＆ドロップするか、クリックして .csv、.txt、.xlsx、.json などの形式 (最大 500 kB) のファイルをアップロードして、データをインポートすることもできます。

編集したデータはスナップショットとして保存され、時間の経過に伴って更新されません。

Datagrid パネルでデータを編集すると、[Change to panel embedded data] の確認ダイアログボックスが表示されます。このダイアログでは、Grafana が現在のクエリを削除し、現在のデータのスナップショットに置き換えることが通知されます。確認するには、[Continue] をクリックします。

Datagrid パネルを保存した後、調整したデータを新しいパネルのデータソースとして使用し、Transformation を適用できます。ターゲットパネルのクエリ設定で、[Data source] を [-- Dashboard --] に設定します。次に、[Source] セクションで、ドロップダウンリストから [Test Datagrid] パネルを選択し、Datagrid パネルのカスタムデータを参照します。

Table パネルの [Transform] タブで、[Add field from calculation] Transformation を追加します。[Mode] を [Reduce row] に設定し、[Time]、[x]、[y] フィールドを選択して、[Calculation] には [Total] を選択し、エイリアスとして [Total] を入力します。設定を適用すると、テーブルに [Total] 列が追加され、各行について選択したフィールドの合計が表示されます。

Canvas パネル

Canvas パネルは、Grafana の強力な機能とカスタム要素の柔軟性を組み合わせた新しいパネルです。Canvas の可視化は、フォームベースで構築する拡張可能なパネルで、静的および動的なレイアウトに要素を明示的に配置することで、標準の Grafana パネルでは対応できないカスタムの可視化を設計したり、データをオーバーレイ表示したりできます。たとえば、画像レイヤーを配置し、Grafana のデータソースから更新されるテキストをその上に重ね、データに基づいて色が変わるアイコンを表示できます。Canvas パネルでは、ダッシュボード内の可視化要素を自由に組み合わせられます。[Home Solar - Day] のサンプルシーンでは、家庭用ソーラーシステムのリアルタイムメトリクス (Solar output 3.30 kW、House draw 2.20 kW、Battery charge 1.10 kW) が表示されます。右側の [Canvas Inline Editor] で [Inline editing] トグルを有効にすると、[Elements] リストでレイヤー要素 (例：[metric-value] や [rectangle]) を管理できます。また、[Add Item] を使用して新しい要素を追加し、[背景] と [枠線] のプロパティを設定できます。[Show advanced element types] チェックボックスを選択すると、利用可能な要素タイプがさらに表示されます。

Logs パネルの機能強化

Grafana v10.0.x ではログの表示が改善され、次の機能とコンポーネントが導入されています：

• ログ詳細でのアクションとして、行を簡単にコピーできる [Copy] 機能や、選択したラベルのみを表示する機能が含まれます。これにより、ログコンテキストセクションから離れることなく、特定の情報に集中できます。

• 長いテキストを自動的に折り返す行の折り返しトグルにより、ログコンテキスト内でログエントリを直接読み取り、分析しやすくなります。

• [分割ビューで開く] 機能を使用すると、Explore の分割ビューで、ログエントリに対してコンテキストクエリを実行できます。

  1. ログ内容を直接コピーし、長いテキストを展開できます。展開されたログ詳細には、タイムスタンプ、アラートのフィンガープリント、レコード ID、アラートメッセージの内容、現在値などの完全なフィールド情報が、[Fields] のキー/値ペアとして表示されます。各フィールドの左側には、クイッククエリとコピーのアイコンが表示されます。

  2. 選択したログエントリの前後のコンテキストを展開し、分割ビューで直接開けます。

     Grafana では、[ログコンテキスト] ウィンドウの上部にクエリ条件が表示されます。このウィンドウには、行の自動折り返しのための [Wrap lines] トグルが用意されており、[50 lines] など、表示する行数を選択できます。ウィンドウには、選択したログエントリの前後のコンテキストログが時系列順に表示されます。

     左側のパネルでは、クエリ {userId="xxx",job="alerts"} | json | line_format を使用してアラートログを整形し、alertname、message、handler、team などのフィールドを含む読みやすいテキストにします。[Explain query] を有効にすると、ラベルフィルタリング、JSON のキー/値抽出、line_format テンプレート置換の 3 つの解析手順が表示されます。右側の log-row-context-query パネルでは、Type は Range に、Line limit は 1000 に設定されています。下部には、対応する期間のログ量の分布を示す [Logs volume] の棒グラフが表示されます。

新しいダッシュボード機能

複数レベルのフォルダー

Grafana v10.0.x は、多数のダッシュボードを階層的に管理するための複数レベルのフォルダーをサポートします。

[Dashboards] 管理ページでは、複数レベルのフォルダーとダッシュボードの階層リストを確認できます。右上の [New] ドロップダウンメニューから、新しいフォルダーまたはダッシュボードを作成できます。

[Move] ダイアログボックスで移動先フォルダーを選択し、[Confirm] をクリックして移動操作を完了します。

混合データソースクエリ

Grafana v10.0.x の Explore では、混合データソースを選択すると、クエリごとに異なるデータソースを定義し、結果を同じグラフに表示できます。

たとえば、クエリ A では arms-prometheus-cn-b データソースを使用し、クエリ B では arms-prometheus-cn-hangzh データソースを使用するように設定できます。両方に PromQL クエリ topk(5, scrape_duration_seconds)>10 を入力し、[クエリを実行] をクリックすると、両インスタンスの scrape_duration_seconds の時系列結果が同じ折れ線グラフに表示されます。

データソースの選択

• Grafana v10.0.x でデータソースを選択する際、[Open advanced datasource picker] をクリックすると、専用ページで利用可能なすべてのデータソースを確認できます。

• Grafana v10.0.x でパネルを編集または作成する際、ファイルをアップロードセクションにドラッグするか、クリックして .csv、.txt、.xlsx、.json など特定のタイプのファイルをアップロードできます。

データソース選択ページでは、左側に現在設定済みのデータソースが一覧表示され、右側には 3 つの特別なオプションが表示されます：[-- Mixed --] (複数のデータソースを一度にクエリする)、[-- Dashboard --] (他の可視化からクエリ結果を再利用する)、[-- Grafana --] (シミュレートデータを使用する)。右下の [Configure a new data source] をクリックして、新しいデータソースを設定できます。

時間領域のアノテーション

Grafana v10.0.x では、時系列パネルで時間領域をマークできます。時間領域により、よりコンテキストに沿った表示が可能になります。たとえば、平日 (月曜日から金曜日) をハイライトしてデータと並べて可視化できます。時間領域は、夜間、勤務時間、または定義したいその他の期間など、1 日の特定の部分をハイライトする場合にも便利です。ユーザーは、1 日の特定の部分を素早く特定したり、時系列内でハイライトされたセクションを無視したりできます。

この機能を設定するには、ダッシュボードの設定に移動し、[Annotations] ページでアノテーションを作成します。新しいアノテーション設定で、[Name] を「Annotations & Alerts」に設定し、[Data source] として -- Grafana -- を選択し、[Enabled] と [Hidden] のチェックボックスを選択します。[Color] は赤を選択します。[Show in] では「Selected panels」を選択し、[Number of write requests in progress] および [Number of read requests in progress] パネルに関連付けます。[Query type] を「Time regions」に設定し、時刻を「Everyday 15:00 to 19:00」に設定します。

上記で設定したアノテーションは、毎日 15:00 から 19:00 の期間をハイライトします：

必要に応じて、さまざまな時間領域を定義して表示できます：

ダッシュボードのアノテーションをフィルタリングして、すべてのパネルに適用するか、選択したパネルのみに適用できます。アノテーションの設定では、[Show in] ドロップダウンリストを使用して、アノテーションの表示範囲を選択します：[All panels] (アノテーションをサポートするすべてのパネルにアノテーションデータを送信する)、[Selected panels] (指定したパネルのみにデータを送信する)、[All panels except] (指定したパネルを除くすべてのパネルにデータを送信する)。

ナビゲーションの更新

検索ボックス

Grafana v10.0.x では、すべてのページの上部に検索ボックスが追加されました。これにより、すべてのページや最近使用したダッシュボードを検索し、直接アクセスできます。

接続

Grafana v10.0.x では、左側メニューの接続ページにより、データソースの作成と編集のための新しい一元的なエントリーポイントが提供されます：

[Add new connection] ビューには、すべてのデータソースプラグインが表示されます。プラグインをインストールすると、そのプラグインのページから直接データソースを作成できます。

データソース管理は Grafana v9.0.x と同様です。

Grafana v10.0.x は、従来のデータソースのインストールパスも引き続きサポートし、それを使用した場合はリマインダーが表示されます。

CSV プラグインを例にすると、インストール後、プラグインページの右上に赤い [Uninstall] ボタンと青い [Create a CSV data source] ボタンが表示されます。後者をクリックして、このタイプのデータソースを作成します。

ページナビゲーション

パンくずリストコンポーネントは、現在のページのパスを表示し、パス上の任意の前のページにすばやく戻れるようにします。Grafana で ARMS Prometheus モニタリングの [Ack Pro ApiServer] ダッシュボードに移動すると、ナビゲーションパスは [Home] > [Dashboards] > [arms-promethe...] > [Ack Pro ApiServer] と表示されます。

中国語のサポート

Grafana v10.0.x では、Administration > Default Preference に言語設定が追加され、中国語がサポートされます。Grafana の管理パネルで、[Administration] > [Default Preference] に移動します。[Preferences] セクションで、[Language] ドロップダウンリストから [中国語 (簡体字)] (Beta) を選択し、[Save] をクリックして、ユーザーインターフェースを中国語に切り替えます。

Grafana アラートの更新

通知テンプレートのプレビュー

Grafana v10.0.x では、通知テンプレートを定義した後にアラートをプレビューできます。[New notification template] ページで、[Alertmanager] として [Grafana] を選択し、[Template name] フィールドに名前を入力します。[Preview] タブをクリックします。左側のプレビューペインには、発火中および解決済みのアラート数とその詳細 (例：alertname や instance のラベル値) を含む、レンダリング済みの通知内容が表示されます。右側の [Payload data] エリアには、annotations.summary、labels.instance、startsAt などのフィールドを含む、利用可能な JSON データ構造が表示されます。

アラートルールのコピー

既存のアラートルールをコピーして、新しいアラートルールを作成できます。これにより、類似したルールが複数必要な場合の手順が簡素化されます。

すべてのアラートルールをエクスポートできます。[Alert rules] ページで、一覧から対象のアラートルールを見つけ、[Actions] 列の [Copy] ボタンをクリックして複製します。