Prometheusの始め方 — まずは「自分を監視する」小さな実験

ひよこ

サーバーが元気か、数字で見られるようにしたい！

ペンギン先生

Prometheusはメトリクスという数値を時刻と一緒に記録する監視システムだよ。最初からCPU・通知・ダッシュボードを全部そろえず、まずPrometheus自身を監視して、収集できたことを確かめよう。

ひよこ

何を用意すればいい？

ペンギン先生

公式から自分のOSとCPUに合う配布物を入手するよ。展開したフォルダに設定ファイルを置き、ローカルだけで起動する。Dockerでも動かせるけれど、今回の最初の実験では必須ではないんだ。

ひよこ

プル型って、何を引っ張ってくるの？

ペンギン先生

Prometheusが監視対象のHTTPエンドポイントへアクセスし、数値を取得する方式だよ。これをスクレイプという。今回は自分の/metricsから15秒間隔で取る設定にする。15秒は今回の設定値で、設定省略時の既定値は1分だよ。

ひよこ

ちゃんと取れたかはどう見るの？

ペンギン先生

クエリ画面でupと入力しよう。対象の収集が成功していれば1、失敗していれば0になる。ただし1は「サービスのあらゆる機能が正常」の保証ではないよ。利用者の操作やエラー率なども別に見るんだ。

ひよこ

数値を加工するのがPromQL？

ペンギン先生

そう。ラベルで対象を絞ったり、関数で集計したりする。rate(counter[5m])は過去5分のデータから1秒あたりの平均増加量を求める。「5分間の合計」ではないんだ。rateは再起動によるリセットも考慮するよ。

ひよこ

CPUの値も自動で出てくる？

ペンギン先生

Linuxホスト全体のCPUやメモリならNode Exporterなどを別に用意するよ。今回見ているのはPrometheus自身のメトリクス。コンテナでNode Exporterを起動するだけではホストを正しく監視できないこともあるので、公式のマウントや起動条件を確認しよう。

ひよこ

GrafanaとAlertmanagerも必要？

ペンギン先生

グラフを並べたダッシュボードにはGrafanaが便利だよ。通知するならPrometheusで条件を評価し、Alertmanagerで通知先や重複排除などを管理する。今回の実験は収集とクエリまでで、通知はまだ設定していないよ。

ひよこ

どこまでできれば最初の一歩は成功？

ペンギン先生

自分の対象でupが1になり、グラフに値が出たら成功だよ。次は何を知りたいかを決めて対象を増やそう。「数字が取れた」と「問題に気づいて対応できる」は別なので、通知を使うときは届くところまで試すんだ。

最初のゴール：upが1になったら収集成功

まず自分のPCの中だけで試します。公式配布からOS・CPUに合う版を展開し、そのフォルダで作業します。WindowsならWindows用、macOSならdarwin用、Linuxならlinux用です。利用した版を控えておきましょう。

1. prometheus.ymlを保存する

global:
  scrape_interval: 15s
scrape_configs:
  - job_name: prometheus
    static_configs:
      - targets: ['127.0.0.1:9090']

2. 起動する

macOS/Linuxでは展開したフォルダで実行します。

./prometheus --config.file=prometheus.yml --web.listen-address=127.0.0.1:9090

Windows PowerShellでは実行ファイル名を変えます。

.\prometheus.exe --config.file=prometheus.yml --web.listen-address=127.0.0.1:9090

ブラウザで http://127.0.0.1:9090/query を開きます。まず15秒ほど待って up を実行し、対象の値が 1 なら成功です。/targets で対象の状態とエラー、/metrics で生の数値を確認できます。実験を終えるときは起動したターミナルでCtrl+C。収集したデータは通常、作業フォルダのdataに残ります。

画面が開かないなら起動ログとポートの使用状況、upが0ならtargetsのエラーと設定先を確認。何もないなら設定を読み込めたか、初回の収集まで待ったかを確かめます。外部に公開するためにファイアウォールを開ける必要はありません。

数字の意味をひとつずつ読む

up{job="prometheus"}
rate(prometheus_tsdb_head_chunks_created_total[5m])

1つ目は今回の対象の収集状態。2つ目は内部で作られるチャンクの、過去5分から求めた1秒あたりの平均増加量です。蓄積が少ないと計算できないので、数回の収集後に試します。値は環境で変わり、0もありえます。

Counterは累積値で再起動などでリセットされます。Gaugeは温度やメモリ量のように増減する現在値。分布を扱うHistogramとSummaryもありますが、まずは「この数値の単位は何か」「累積か現在値か」を確認しましょう。アプリ独自の http_requests_total などは、アプリ側で公開しなければ現れません。

次は、知りたいことに合わせて増やす

アラートルールは現行のYAML形式で書き、Prometheus設定の rule_files で読み込みます。ルールを書くだけではメールやチャットへ届きません。Grafanaをコンテナで使う場合も、コンテナのlocalhostは自分自身を指すため、到達先の考え方が必要です。

コンテナの基礎ならDocker入門、通知が対応につながる運用を考えるならITIL入門へ進めます。

参考資料

2026年10月9日確認。

• Prometheus — Getting started — 自己監視・クエリ・起動手順
• Prometheus — Configuration — 間隔の既定値と設定ファイル
• Prometheus — Query functions — rateの単位とリセット
• Prometheus — Node Exporter — ホスト監視の追加
• Prometheus — Alerting overview — 条件評価と通知の分担
• Grafana — Prometheus data source — 接続先の設定