クイックリファレンス

Docker Composeで一発起動（Prometheus + Grafana）

# docker-compose.yml
version: '3'
services:
  prometheus:
    image: prom/prometheus:latest
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    ports:
      - "9090:9090"

  node-exporter:
    image: prom/node-exporter:latest
    ports:
      - "9100:9100"

  grafana:
    image: grafana/grafana:latest
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin

prometheus.yml（基本設定）

global:
  scrape_interval: 15s     # 15秒ごとにスクレイピング
  evaluation_interval: 15s # ルール評価間隔

scrape_configs:
  - job_name: 'prometheus'
    static_configs:
      - targets: ['localhost:9090']

  - job_name: 'node'
    static_configs:
      - targets: ['node-exporter:9100']

よく使うPromQLクエリ

# CPU使用率（%）
100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

# メモリ使用率（%）
(1 - (node_memory_MemAvailable_bytes / node_memory_MemTotal_bytes)) * 100

# HTTPリクエストレート（5分あたり）
rate(http_requests_total[5m])

# 5xxエラーレート（サービス別）
sum(rate(http_requests_total{status=~"5.."}[5m])) by (service)

# 95パーセンタイルのレイテンシ
histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m]))

アラートルールの設定

# alert_rules.yml
groups:
  - name: example
    rules:
      - alert: HighCPUUsage
        expr: 100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100) > 80
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "CPU使用率が80%を超えています"
          description: "インスタンス {{ $labels.instance }} のCPU使用率が {{ $value }}% です"

---

よくある詰まりポイント

Q. Prometheusのターゲットが DOWN になっている

A. Prometheusのステータスページ（http://localhost:9090/targets）でエラー詳細を確認してください。よくある原因は「対象サービスが起動していない」「ポートが間違っている」「ファイアウォールでブロックされている」の3つです。curl http://ターゲットホスト:9100/metrics でPrometheus外からメトリクスが取得できるか確認してみましょう。

Q. PromQLで no data になって何も表示されない

A. メトリクス名が正確か確認してください。PrometheusのUIで /graph にアクセスして、メトリクス名の一部を入力すると補完候補が出ます。rate() を使う場合は [5m] の時間範囲がスクレイピング間隔の2倍以上必要（例: 15秒間隔なら最低 [30s] 以上）なので注意してください。

Q. Grafanaでデータソースに接続できない

A. Grafana UIから「Configuration」→「Data Sources」→「Add data source」→「Prometheus」を選んで、URLに http://prometheus:9090（Docker Composeなら）を設定してください。localhostではなくサービス名で参照するのがDocker環境のポイントです。「Save & Test」でボタンが緑になれば成功です。