Prometheusサービスインストールガイド

システムモニタリング機能を使用するOn-Premise環境用のインストールガイドです。

概要

本ガイドはkube-prometheus-stack Helm Chartを活用したPrometheusインストールガイドを提供しています。

※ OVA Virtual Appliance Baseline 2025.09バージョンからはPrometheusが基本仕様としてインストールされています。

Prometheusがインストールされている場合、次のconfigmap設定でシステムモニタリング機能を有効化できます。 (直接インストールする方式とネームスペースが異なります。)

### portal-web-config
VUE_APP_USE_SYSTEM_MONITORING: true

### cloud-spsvr-config
CUSTOM_PROMETHEUS_URL: http://rancher-monitoring-prometheus.monitoring.svc.cluster.local:9090

kube-prometheus-stackに含まれているサービス一覧

サービス	機能	必須可否
prometheus	クラスターメトリクスデータの収集および保存	⭕️
prometheus-config-reloader	Prometheus設定の自動検出および反映	⭕️
prometheus-operator	Prometheusに関連するリソース管理および自動化	⭕️
prometheus-node-exporter	ノードシステムリソースデータの提供(CPU、メモリ、ディスク、ネットワーク)	⭕️
kube-state-metrics	Kubernetesクラスターで動作するリソース状態情報を提供	⭕️
alertmanager	Prometheusで発生するアラートをメール、ウェブフックで送信	❌
grafana	Prometheusで収集したデータを可視化してダッシュボード形式で提供	❌

インストール方法

必要なDocker Imageファイルの準備

Docker Image Pull

# prometheus
docker pull quay.io/prometheus/prometheus:v3.2.1

# prometheus-operator
docker pull quay.io/prometheus-operator/prometheus-operator:v0.80.1

# prometheus-node-exporter
docker pull quay.io/prometheus/node-exporter:v1.9.0

# prometheus-config-reloader
docker pull rancher/mirrored-prometheus-operator-prometheus-config-reloader:v0.59.1

# kube-state-metrics
docker pull rancher/mirrored-kube-state-metrics-kube-state-metrics:v2.6.0

閉鎖網環境Harbor経路でDocker Imageタグ変更

# prometheus
docker tag quay.io/prometheus/prometheus:v3.2.1 harbor.local:5050/prometheus/prometheus:v3.2.1

# prometheus-operator
docker tag quay.io/prometheus-operator/prometheus-operator:v0.80.1 harbor.local:5050/prometheus/prometheus-operator:v0.80.1

# prometheus-node-exporter
docker tag quay.io/prometheus/node-exporter:v1.9.0 harbor.local:5050/prometheus/prometheus-node-exporter:v1.9.0

# prometheus-config-reloader
docker tag rancher/mirrored-prometheus-operator-prometheus-config-reloader:v0.59.1 harbor.local:5050/prometheus/prometheus-config-reloader:v0.59.1

# kube-state-metrics
docker tag rancher/mirrored-kube-state-metrics-kube-state-metrics:v2.6.0 harbor.local:5050/prometheus/kube-state-metrics:v2.6.0

Docker Image .tarファイルで保存

# prometheus
docker save -o prometheus.tar harbor.local:5050/prometheus/prometheus:v3.2.1

# prometheus-operator
docker save -o prometheus-operator.tar harbor.local:5050/prometheus/prometheus-operator:v0.80.1

# prometheus-node-exporter
docker save -o node-exporter.tar harbor.local:5050/prometheus/prometheus-node-exporter:v1.9.0

# prometheus-config-reloader
docker save -o prometheus-config-reloader.tar harbor.local:5050/prometheus/prometheus-config-reloader:v0.59.1

# kube-state-metrics
docker save -o kube-state-metrics.tar harbor.local:5050/prometheus/kube-state-metrics:v2.6.0

kube-prometheus-stack Helm Chartの準備

# helmリポジトリ追加
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update

# prometheus-operator-crdsダウンロード
helm pull prometheus-community/prometheus-operator-crds

# kube-prometheus-stack chartダウンロード
helm pull prometheus-community/kube-prometheus-stack

kube-prometheus-stackチャートvalues.yamlファイル設定値の修正

kube-prometheus-stackチャートvalues.yaml

# values.yaml
fullnameOverride: "rancher-monitoring"
alertmanager:
  enabled: false #使用しない
grafana:
  enabled: false #使用しない
kubeApiServer:
  enabled: false #使用しない
kubeControllerManager:
  enabled: false #使用しない
coreDns:
  enabled: false #使用しない
kubeEtcd:
  enabled: false #使用しない
kubeScheduler:
  enabled: false #使用しない
kubeProxy:
  enabled: false #使用しない
prometheusOperator:
  image:
    registry: harbor.local:5050 #ローカルHarborアドレスに変更が必要
    repository: prometheus/prometheus-operator
    tag: "v0.80.1"
  prometheusConfigReloader:
    image:
      registry: harbor.local:5050 #ローカルHarborアドレスに変更が必要
      repository: prometheus/prometheus-config-reloader
      tag: "v0.59.1"
prometheus:
  prometheusSpec:
    scrapeInterval: "60s"
    evaluationInterval: "60s"
    retention: 10d #データ保管期間
    image:
      registry: harbor.local:5050 #ローカルHarborアドレスに変更が必要
      repository: prometheus/prometheus
      tag: v3.2.1
    volumeClaimTemplate: #PVC設定
      spec:
        storageClassName: longhorn
        accessModes: ["ReadWriteOnce"]
        resources:
          requests:
            storage: 10Gi

prometheus-node-exporterサブチャートvalues.yaml

# charts\prometheus-node-exporter\values.yaml
image:
  registry: harbor.local:5050 #ローカルHarborアドレスに変更が必要
  repository: prometheus/prometheus-node-exporter
  tag: "v1.9.0"

kube-state-metricsサブチャートvalues.yaml

# charts\kube-state-metrics\values.yaml
image:
  registry: harbor.local:5050 #ローカルHarborアドレスに変更が必要
  repository: prometheus/kube-state-metrics
  tag: "v2.6.0"

※ 収集メトリクスを制限する必要がある場合

PVC容量制限で収集メトリクスを制限する必要がある場合、values.yamlで以下の値を追加で変更する必要があります。

kubelet:
  serviceMonitor:
    enabled: false #kubelet default job除外処理
prometheusOperator:
  serviceMonitor:
    selfMonitor: false #prometheus-operator default job除外処理
prometheus:
  serviceMonitor:
    selfMonitor: false #prometheus default job除外処理
  prometheusSpec:
    additionalScrapeConfigs:
      - job_name: "node-exporter-custom"
        kubernetes_sd_configs:
          - role: endpoints
            namespaces:
              names: ["cattle-monitoring-system"]
        relabel_configs:
          - source_labels: [__meta_kubernetes_namespace]
            regex: cattle-monitoring-system
            action: keep
          - source_labels:
              [__meta_kubernetes_service_label_app_kubernetes_io_name]
            regex: prometheus-node-exporter
            action: keep
          - source_labels: [__meta_kubernetes_endpoint_port_name]
            regex: http-metrics
            action: keep
          - source_labels: [__meta_kubernetes_endpoint_address_target_kind]
            regex: Pod
            action: keep
          - source_labels: [__meta_kubernetes_pod_node_name]
            target_label: instance
            action: replace
        metric_relabel_configs:
          - source_labels: [__name__]
            regex: node_uname_info|node_cpu_seconds_total|node_load1|node_load5|node_load15|node_memory_MemTotal_bytes|node_memory_MemAvailable_bytes|node_memory_Active_bytes|node_memory_.*|node_filesystem_(size|avail|free|used)_bytes|node_network_(receive|transmit)_bytes_total
            action: keep

修正したkube-prometheus-stack Helm Chartのパッケージング

helm package kube-prometheus-stack # kube-prometheus-stack-69.8.2.tgz形式のパッケージファイル生成

生成したDocker Imageファイルおよびprometheus-operator-crds、kube-prometheus-stack Helm Chartを構築サーバーにコピー
HarborウェブUIでローカルHarborにプロジェクト作成
- Project Name : prometheus
- Access Level : Public

構築サーバーローカルHarborにDocker Image load & push

# prometheus
docker load -i prometheus.tar
docker push harbor.local:5050/prometheus/prometheus:v3.2.1

# prometheus-operator
docker load -i prometheus-operator.tar
docker push harbor.local:5050/prometheus/prometheus-operator:v0.80.1

# prometheus-node-exporter
docker load -i node-exporter.tar
docker push harbor.local:5050/prometheus/prometheus-node-exporter:v1.9.0

# prometheus-config-reloader
docker load -i prometheus-config-reloader.tar
docker push harbor.local:5050/prometheus/prometheus-config-reloader:v0.59.1

# kube-state-metrics
docker load -i kube-state-metrics.tar
docker push harbor.local:5050/prometheus/kube-state-metrics:v2.6.0

Prometheus CRDs設定

既存に設定されているPrometheus CRDの削除

# CRD照会
kubectl get crd | grep monitoring.coreos.com

# 上記コマンド実行結果で出たCRDの削除
kubectl delete crd <CRD名>

CRD削除後、コピーしたCRDs HelmチャートでCRDインストール

# Namespace : cattle-monitoring-system
# ReleaseName : prometheus

helm install prometheus-operator-crds prometheus-operator-crds-20.0.0.tgz -n cattle-monitoring-system --create-namespace

Prometheusインストール

# Namespace : cattle-monitoring-system
# ReleaseName : prometheus

helm install prometheus kube-prometheus-stack-69.8.2.tgz -n cattle-monitoring-system --create-namespace

※ 収集メトリクスを制限する必要がある場合、次のコマンドを実行する必要があります。基本メトリクス収集を防ぐことができます。

kubectl delete servicemonitor prometheus-prometheus-node-exporter -n cattle-monitoring-system
kubectl delete servicemonitor prometheus-kube-state-metrics -n cattle-monitoring-system

インストール削除

Prometheusインストール削除が必要な場合、次のコマンドで削除できます。

helm uninstall prometheus -n cattle-monitoring-system

追加設定

管理センターconfigMap設定

管理センターのシステムモニタリング機能を使用するには、管理センターフロントエンド/バックエンドのconfigMap値が正しく設定されている必要があります。

Security365管理センターフロントエンドconfigMap

VUE_APP_USE_SYSTEM_MONITORING: システムモニタリング機能の使用可否
```
### portal-web-config
VUE_APP_USE_SYSTEM_MONITORING: true
```
Security365管理センターバックエンドconfigMap

CUSTOM_PROMETHEUS_URL: Prometheusサービスクラスター内部アドレス
```
### cloud-spsvr-config
CUSTOM_PROMETHEUS_URL: http://rancher-monitoring-prometheus.cattle-monitoring-system.svc.cluster.local:9090
```

概要​

インストール方法​

※ 収集メトリクスを制限する必要がある場合​

インストール削除​

追加設定​

管理センターconfigMap設定​

概要

インストール方法

※ 収集メトリクスを制限する必要がある場合

インストール削除

追加設定

管理センターconfigMap設定