はじめに
このラボでは、Grafana を使用して監視ダッシュボードを作成する基礎を学びます。Grafana は、監視と可観測性のための人気のあるオープンソースプラットフォームであり、データの保存場所に関係なく、メトリクスのクエリ、視覚化、アラート設定、調査を行うことができます。
用意された設定ファイルから監視スタックを起動します。次のコンポーネントで構成されます。
- Grafana: ダッシュボードを構築するための視覚化ツール。
- Prometheus: Grafana のデータソースとなる時系列データベース。
- Node Exporter: ホストマシンからハードウェアおよび OS のメトリクスを収集し、Prometheus がスクレイピングできるように公開するエージェント。
今回の目標は、ラボ環境のリアルタイム CPU 使用率を表示するシンプルなダッシュボードをゼロから構築することです。
監視スタックを起動して確認する
このステップでは、Grafana、Prometheus、Node Exporter を起動します。Node Exporter はシステムメトリクスを公開し、Prometheus はそれを収集し、Grafana は表示します。設定ファイルとデータソースのプロビジョニングファイルは用意されています。
cd /home/labex/project
固定した各タグは、このラボで使用するバージョンを指定します。ダウンロードには数分かかる場合があります。各コマンドがプロンプトに戻るまで待ってください。取得に失敗した場合は、同じ pull コマンドを再実行します。Docker は完了済みのレイヤーを再利用します。ダウンロードが完了するまで先に進まないでください。
docker pull prom/prometheus:v3.3.0
docker pull prom/node-exporter:v1.9.1
docker pull grafana/grafana:11.6.0
docker network create はコンテナが互いの名前を解決できるネットワークを作成します。docker run -d はコンテナをバックグラウンドで起動し、--name は名前を指定し、--network はネットワークに接続し、-p はホストのポートをコンテナのポートに割り当てます。-v のマウントは用意された設定ファイルを接続し、:ro サフィックスは読み取り専用にします。
docker network create monitoring-net
docker run -d --name node-exporter --network monitoring-net -p 9100:9100 prom/node-exporter:v1.9.1
docker run -d --name prometheus --network monitoring-net -p 9090:9090 -v /home/labex/project/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro prom/prometheus:v3.3.0
docker run -d --name grafana --network monitoring-net -p 8080:3000 -v /home/labex/project/grafana/provisioning:/etc/grafana/provisioning:ro grafana/grafana:11.6.0
これらの curl オプションは HTTP エラーを報告し、一時的な起動エラーに対して 2 秒間隔で最大 30 回再試行します。実行中のコンテナでも初期化中の場合があるため、ヘルスチェックが成功してから進んでください。
curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:9090/-/ready
curl --fail --silent --show-error --retry 30 --retry-delay 2 --retry-connrefused --retry-all-errors http://localhost:8080/api/health
Prometheus は準備完了を報告し、Grafana は "database": "ok" を返すはずです。次のコマンドでコンテナを確認します。
docker ps
指定した 3 つのコンテナがすべて Up になっていることを確認します。ラボの Grafana タブを選択します。埋め込みログインがブロックされる場合は、ブラウザで開く操作を使って新しいタブで開きます。ユーザー名 admin、パスワード admin でログインし、パスワード変更画面で Skip をクリックします。これらの認証情報は一時的なラボ専用です。
Connections → Data sources を開き、Prometheus が存在することを確認します。プロビジョニングファイルは共有 Docker ネットワーク経由で http://prometheus:9090 に接続します。CPU クエリを作成する前に Prometheus が複数のサンプルを収集できるよう、スタックを実行したままにしてください。
Grafana で新しいダッシュボードを作成する
このステップでは、空のダッシュボードを作成し、最初の可視化を追加します。ダッシュボードはパネルをグリッドに配置し、各パネルがデータクエリの結果を表示します。
左側のサイドバーで Dashboards を開きます。New をクリックし、New dashboard を選択します。
空のダッシュボードで Add visualization をクリックします。データソースの選択画面で Prometheus を選択します。これにより、新しいパネルのクエリの送信先を指定します。
可視化のプレビュー、クエリエディタ、表示オプションを備えたパネルエディタが表示されるはずです。次のステップで CPU クエリを入力します。
CPU 使用率を表示する PromQL クエリパネルの追加
このステップでは、ダッシュボードにパネルを追加し、PromQL (Prometheus Query Language) クエリを使用して CPU 使用率データを取得します。
前のステップからパネルエディタが開いている状態のはずです。
エディタの下部にクエリセクションがあります。デフォルトで Prometheus データソースが選択されているはずです。
クエリエディタを Code に切り替え、次の PromQL クエリを入力します。そのままコピーして貼り付けられます。
100 - (avg by (instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)
このクエリの解説は以下の通りです。
node_cpu_seconds_total{mode="idle"}: CPU が「アイドル」状態であった合計秒数をカウントする Node Exporter のメトリクスです。rate(...[5m]): 過去 5 分間のアイドル時間の 1 秒あたりの平均増加率を計算します。結果は 0 から 1 の値となり、CPU がアイドル状態であった時間の割合を表します。avg by (instance): 結果を集計します。複数の CPU やマシンがある場合に便利です。* 100: 小数値をパーセンテージに変換します(例: 0.95 は 95% になります)。100 - ...: 最後に、100 からアイドル率を引くことで、アクティブな CPU 使用率のパーセンテージを算出します。
Run queries をクリックします。rate の計算には少なくとも 2 回の収集が必要です。スタックを起動した直後の場合は約 30 秒待ち、もう一度クエリを実行してください。上部のプレビューに CPU 使用率の推移を示すグラフが表示されるはずです。
パネルにデータが表示されましたが、次のステップでラベルやフォーマットを調整して、より見やすくします。
ダッシュボードをカスタマイズして保存する
このステップでは、CPU パネルに分かりやすいタイトルを付け、値をパーセント表示にして、ダッシュボードを保存します。明確なラベルは結果を理解しやすくします。
右側の Panel options で Title を正確に CPU Usage % に設定します。
Standard options の Unit を開き、percent を検索して Misc / Percent (0-100) を選択します。クエリはすでに 0 から 100 の値を返すため、この単位は値を再スケーリングせずにパーセント記号を追加します。
Back to dashboard をクリックし、パネルを保持してダッシュボードに戻ります。ダッシュボードはまだ永続的には保存されていません。
Save dashboard をクリックします。保存ダイアログで正確なタイトル My System Dashboard を入力し、Save をクリックします。ラボはこのタイトルで保存済みダッシュボードを見つけます。
保存したダッシュボードに、CPU グラフとパーセント単位を表示する CPU Usage % パネルが含まれていることを確認します。
まとめ
このラボでは Grafana ダッシュボードを一から作成しました。用意された設定ファイルで監視スタックを起動し、次の操作を行いました。
- Grafana、Prometheus、Node Exporter コンテナで構成される環境の確認。
- Grafana UI を操作して、新しい空のダッシュボードを作成。
- 視覚化パネルを追加し、Prometheus データソースから CPU 使用率データを取得するための PromQL クエリを記述。
- パネルのタイトルと単位フォーマットをカスタマイズし、可読性を向上。
- 完成したダッシュボードを保存。
これで、Grafana で視覚化を作成するための基本的なワークフローを習得しました。この知識を基に、メモリ使用量、ディスク I/O、ネットワークトラフィックなどの他のシステムメトリクスを監視するためのパネルを追加して、ダッシュボードを拡張していくことができます。



