0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Grafana】「Panel」作成ガイド(Query / Transform / Visualization)

0
Posted at

はじめに

Grafanaのダッシュボードを構成する最小単位、それが「Panel(パネル)」です。
単にデータを表示するだけでなく、複数のデータソースを組み合わせたり、ブラウザ側でデータを加工(Transform)したりすることで、よりインサイトを得やすい画面を構築できます。

本記事では、パネルの基本的な仕組みから、実務で役立つデータ加工・可視化のテクニックまでを深掘りします。


1. パネルの基本構造と編集

パネルは、ダッシュボード上の個々の可視化要素です。

  • 編集方法:
    パネル右上の縦三点リーダ(⋮)から Edit を選択して設定画面に入ります。

  • 表示制御のヒント:
    現時点では「特定の条件でパネル自体を非表示にする」標準機能はないため、設計段階で適切なダッシュボード分割やRowの活用を検討するのが一般的です。


2. Query:データの取得(データソースの使い分け)

パネルごとに独自のクエリを持ちます。ここでは3つのパターンを紹介します。

① PostgreSQL

直接DBを参照する方式です。

  • Codeモード: 通常はSQLを直接記述して制御します。
  • Builderモード: GUIベースで構築できるため、SQLに不慣れな場合でも安心です。

② Infinity

API経由でデータを取得する際に非常に強力なプラグインです。

  • 設定ポイント: Typeを JSON、Parserを Backend、Sourceを URL とし、Formatは Table を選択するのが使いやすいかと思います。
  • JSONataの注意点: Parsing options でJSONata記法を用いた加工が可能ですが、Infinityが採用しているバージョンによっては最新の構文(switch等)が使えない場合がある点に注意が必要です。
  • Pagination: 現状、最大5ページまでの制限があるため、大規模なデータ取得には工夫が必要です。

③ Dashboard

同じダッシュボード内の他のパネルが取得したデータ をソースにします。

  • メリット: 同じデータを複数のパネルで見せたい場合、クエリの発行回数を抑えられ、パフォーマンスが向上します。
  • 設定: Source panel で対象パネルを選択します。

3. Transform Data:可視化前のデータ加工

データソースから取得した生データを、パネルに表示する直前で加工するのが「Transform」機能です。
ここではいくつかのTransformを紹介します。

Transform名 用途
Add field from calculation 既存のカラムを使って計算(合計・差分など)し、新しい列を作る。
Convert field type フィールドの型変換。特に文字列を「Time」型にする際に多用。
Extract fields JSONオブジェクトを展開して個別のカラムにする。
Filter data by values 取得後のデータに対してさらにフィルタリングを行う。
Group by / Rows to fields グルーピングや行列変換。円グラフ用の集計データを作る際に便利。
Organize fields カラム名の変更や、不要な列の非表示化。

4. Visualization:最適な表現の選択

データの特性に合わせて適切なパネルを選択します。

よく使うパネルタイプ

  • Stat:
    特定の数値を大きく強調。Calculation 設定(CountやLastなど)で表示内容を制御します。
    image.png

  • Table:
    詳細データの閲覧に。Overrides で特定の列だけ非表示にする(Hide in table)といった微調整が可能です。

  • Pie chart:
    内訳の可視化。あらかじめ Group by 等で集計されたデータを渡すのが基本です。
    image.png

  • Text / BusinessText:

    • Text: Markdown/HTMLでのリンク表示などに利用。
    • BusinessText: 標準機能では実現できないリッチなUIをJavaScript/CSSでカスタム実装する際に使用。API連携を伴う設定画面の構築などにも応用可能です。

5. 高度な共通設定

すべてのパネルに共通する重要な設定項目です。
よく使う設定項目をいくつか紹介します。

  • Panel options
    パネルのタイトルや説明を設定。
    image.png
  • Standard options:
    単位(Unit)や最小・最大値の設定。
    image.png
  • Thresholds(閾値):
    値に応じて色を変える(例:80%以上で赤)。
    {8AA7925F-0DFA-475D-8593-455457713CB1}.png
  • Value mappings:
    特定の値(例:0)をテキスト(例:OFF)に置換。
  • Data links:
    データをリンク化。
    image.png
  • Overrides:
    全体ではなく特定のフィールドだけ に色や表示設定を適用したい場合に必須の機能です。
    image.png

まとめ

パネルを使いこなすコツは、Queryで取得し、Transformで整え、Visualizationで飾る という流れを理解することです。特にDashboardデータソースやBusinessTextを使いこなせるようになると、Grafanaの活用の幅が一気に広がります。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?