【実務・中級編】GrafanaとPrometheusの連携方法：美しく見やすいダッシュボードの作り方 – 運用監視・オブザーバビリティ活用バイブル

オブザーバビリティの極致：Prometheus x Grafanaで実現する「迷わない」監視基盤の構築術

運用監視の現場において、ダッシュボードは単なる「絵画」ではない。それはシステムという巨大な有機体が発する信号を翻訳し、我々エンジニアが即座に戦術的判断を下すための「コックピット」だ。

PrometheusとGrafanaを単につないでグラフを並べるだけなら、誰にでもできる。だが、「障害時に0.1秒でも速く真因に辿り着けるか」という問いに対し、最高の結果を叩き出せる構成を知っているだろうか。

今日は、運用の現場で血を流してきたエンジニアだけが知る、生産性を極限まで高める設計論を伝授する。

—

1. 接続の作法：インフラの「型」を定義する

PrometheusをGrafanaのデータソースとして追加する際、URLを入力して終わりにしていないか？現場では「HTTP Method」と「Timeout」のチューニングが命だ。

HTTP Method: `POST` を選択せよ。複雑なPromQLクエリはURL長制限に引っかかることがあり、GETリクエストではキャッシングにより意図しない古いデータが返るリスクがある。
Timeout: デフォルトの10sは短すぎる。重い集計クエリが走る環境では `30s` に引き上げ、`Min interval` を `15s` 程度に設定し、Prometheusのスクレイピング間隔と同期させろ。

2. テンプレート変数：動的ダッシュボードの神髄

ハードコードされたダッシュボードは技術的負債だ。環境が増えるたびにダッシュボードを作る気か？

テンプレート変数の極意

`$instance` や `$namespace` を活用し、「単一のダッシュボードで全環境を俯瞰する」のがプロの流儀だ。

隠れたテクニック: `Multi-value` と `Include All option` を必ず有効にせよ。
神クエリ: `label_values(up{job=”myapp”}, instance)` でインスタンスリストを動的に取得し、`Regex` フィールドに `([^:]+):.` と書くことで、ポート番号を除去したクリーンなホスト名リストを生成できる。

3. 現場で「使える」ダッシュボードの定石

車輪の再発明はするな。しかし、公式IDをそのまま使うのも素人だ。

おすすめID:
Node Exporter Full (ID: 1860): 基本の極み。まずはこれをベースに「自社に必要なメトリクス」だけを抽出する。
プロのカスタマイズ: 全てを表示するな。「CPU/Memory/Network/Disk I/O/Active Threads」の5指標のみを「一行」に配置せよ。視線の移動を最小限に抑えるのが、障害時の鉄則だ。

4. 現場で震えるほど役立つテクニック

開発スピードを加速させるショートカット

`d` + `r`: ダッシュボードをリロード（即座に最新状態へ）
`e`: 全パネルの編集モードを一括切り替え（レイアウト調整時に必須）
`f`: 時間範囲のクイック選択

絶対入れるべき「神プラグイン」

[Infinity](https://grafana.com/grafana/plugins/yesoreyeram-infinity-datasource/): Prometheus以外の外部API（CloudWatchやSaaSのステータス）をPromQLと統合できる。これ一つで監視の死角が消える。
[Dynamic Text](https://grafana.com/grafana/plugins/grafana-dynamictext-panel/): 障害時の「対応手順（Runbook）」をMarkdownでダッシュボードに埋め込め。監視画面からWikiへ遷移する時間は、障害時には永遠に等しい。

—

5. 実践：ベストプラクティス構成例（Dashboard JSON）

ダッシュボードをコード管理（GitOps）するためのJSON構成の要点をここに記す。

{
“title”: “Production-Overview”,
“timezone”: “browser”,
“refresh”: “10s”, // 監視画面なら10sで固定
“templating”: {
“list”: [
{
“name”: “namespace”,
“type”: “query”,
“datasource”: “Prometheus”,
“query”: “label_values(up, namespace)”, // 名前空間を動的取得
“refresh”: 1
}
]
},
“panels”: [
{
“title”: “Error Rate (Rate/5m)”,
“type”: “timeseries”,
“targets”: [
{
“expr”: “sum(rate(http_requests_total{status=~’5..’}[5m])) by (service)”,
“legendFormat”: “{{service}}”
}
]
}
]
}

6. チームで共有する「監視の作法」

1. Dashboard as Code: GrafanaのUIで直接作成したダッシュボードは「プロトタイプ」と見なせ。完成したものは必ずJSONエクスポートし、Gitリポジトリで管理・プルリクベースで運用しろ。
2. アラートパネルの配置: アラート設定（Alerting）はDashboardとは別管理せよ。しかし、「現在発報中のアラート一覧」パネルは全ダッシュボードの最上部に配置せよ。どこを見ればいいか迷わせるな。

—

最後に

オブザーバビリティの本質は「見ること」ではない。「理解すること」だ。
PrometheusとGrafanaを使いこなし、システムが発するノイズの中から「真のサイン」を抽出できた時、君たちは障害に怯える運用者から、システムを支配するアーキテクトへと進化する。

さあ、ダッシュボードを書き換えろ。次なるアラートが鳴る前に。