prometheus-monitoring

Prometheus モニタリング

目次

• 概要
• 使用する場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

アプリケーションやインフラストラクチャから時系列メトリクスを収集、保存、クエリするための包括的な Prometheus モニタリング基盤を構築します。

使用する場面

• メトリクス収集を設定する場合
• カスタムアプリケーションメトリクスを作成する場合
• スクレイピング対象を設定する場合
• サービスディスカバリーを実装する場合
• モニタリング基盤を構築する場合

クイックスタート

最小限の動作例：

# /etc/prometheus/prometheus.yml
global:
  scrape_interval: 15s
  evaluation_interval: 15s
  external_labels:
    cluster: production

alerting:
  alertmanagers:
    - static_configs:
        - targets: ["localhost:9093"]

rule_files:
  - "/etc/prometheus/alert_rules.yml"

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

  - job_name: "node"
    static_configs:
      - targets: ["localhost:9100"]

  - job_name: "api-service"
// ... (see reference guides for full implementation)

リファレンスガイド

references/ ディレクトリにある詳細な実装：

ガイド	内容
Prometheus Configuration	Prometheus の設定
Node.js Metrics Implementation	Node.js メトリクスの実装
Python Prometheus Integration	Python と Prometheus の統合
Alert Rules	アラートルール
Docker Compose Setup	Docker Compose のセットアップ

ベストプラクティス

✅ 推奨事項

• 一貫性のあるメトリクス命名規則を使用します
• フィルタリング用の包括的なラベルを追加します
• 適切なスクレイピング間隔（10～60秒）を設定します
• 保持ポリシーを実装します
• Prometheus 自体をモニタリングします
• デプロイ前にアラートルールをテストします
• メトリクスの意味を文書化します

❌ 避けるべき事項

• カーディナリティが無制限になるラベルを追加します
• スクレイピングの頻度を上げすぎます（10秒未満）
• メトリクスの命名規則を無視します
• ランブックのないアラートを作成します
• 生のイベントデータを Prometheus に保存します
• ゲージのような値にカウンターを使用します