はじめに

Grafanaは、マルチプラットフォームで動作するオープンソースの分析および可視化ツールです。Prometheus、PostgreSQL、CloudWatchなど、多様なデータソースを統合し、洗練されたダッシュボードを作成できます。

本記事では、Grafanaを使い始めた方が最初にマスターすべき「管理構造」と、ダッシュボードの再利用性を高める「変数（Variable）」の使い方について、実務的なTipsを交えて解説します。

1. Folderによる階層化と権限管理

ダッシュボードが増えてくると、目的のダッシュボードを見つけるのが困難になります。
そこで「Folder（フォルダ）」による整理が不可欠です。

構造化:
関連するダッシュボードや下位フォルダを階層的に管理できます。
サイドメニューの「Dashboards」から一覧を確認可能です。
権限管理（重要）:
フォルダ右上の Folder actions > Manage Permissions から、フォルダ単位でアクセス権を設定できます。
- チームやユーザー、ロール（Admin/Editor/Viewer）ごとに制限をかけることで、例えば「本番環境用」と「開発環境用」を分けるといった柔軟な運用が可能です。

ダッシュボードは、1つ以上の「Panel（パネル）」を「Row（行）」で整理して配置するキャンバスです。

一からダッシュボードを作成する以外に、JSON形式の定義ファイルをインポートして素早く構築する方法があります。

「特定の地点だけ表示したい」「ユーザーごとにフィルタしたい」といった要望には、Variable（変数） を利用します。

クエリやパネルタイトルに「動的なプレースホルダー」を埋め込むことで、1つのダッシュボードを何通りにも使い回せるようになります。

Label and Value は内部的な値としてではなく、ユーザーが理解できるラベルを選択肢として表示したい場合に有効です。

SQL（PostgreSQL等）での実装例:
クエリ内で __value（内部値）と __text（表示名）を定義します。

SELECT
  id AS __value,
  name AS __text
FROM
  customer

作成した変数は ${変数名} の形式で参照します。
SQLで文字列として扱う場合などは、フォーマット指定が便利です。

クエリ内での参照例:

SQL
SELECT name 
FROM customer
WHERE id IN (${id:singlequote}) -- 選択された値をシングルクォートで囲んで展開

次回は、より詳細な「Panel」のビジュアライズ設定やTransform（データ変換）について解説します。