3. Prometheus 安装部署：二进制安装、Docker 部署、Operator 部署（K8s 环境）的对比与选择

在生产控制面环境中，Prometheus 的部署方式直接影响运维效率、资源消耗与可观测性体系的可扩展性。本章从二进制安装、Docker 部署、Kubernetes Operator 部署三种主流方式出发，分析其适用场景、配置要点与调优方向，帮助你在不同基础设施条件下做出合理选择。

3.1 三种部署方式概述

3.2 二进制安装：传统控制面的可靠选择

二进制安装不依赖容器运行时，适合对系统资源有严格隔离要求或需要直接绑定宿主机网络/存储的场景。

3.2.1 安装步骤

1. 从 Prometheus 官方 GitHub Releases 页面下载对应平台的最新稳定版 tarball。
2. 解压至目标目录（如 /opt/prometheus）。
3. 创建 Prometheus 系统用户（useradd -r -s /sbin/nologin prometheus）。
4. 编写 prometheus.yml 配置文件，定义全局参数、scrape 目标和告警规则。
5. 创建 systemd service 单元文件，实现开机自启与进程守护。

# /etc/systemd/system/prometheus.service
[Unit]
Description=Prometheus Monitoring System
Documentation=https://prometheus.io/docs/introduction/overview/
After=network.target

[Service]
User=prometheus
Group=prometheus
Type=simple
ExecStart=/opt/prometheus/prometheus \
  --config.file=/etc/prometheus/prometheus.yml \
  --storage.tsdb.path=/var/lib/prometheus/data \
  --web.listen-address=0.0.0.0:9090 \
  --web.external-url=https://prometheus.controlplane.example.com

Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

3.2.2 调优要点

• 存储路径： 使用独立磁盘或高性能 SSD，避免与系统日志共享 I/O。
• 内存限制： 通过 --storage.tsdb.retention.time 和 --storage.tsdb.retention.size 控制 TSDB 块数量，防止 OOM。
• WAL 压缩： 启用 --storage.tsdb.wal-compression 减少磁盘写入量。
• 进程监控： 配合 node_exporter 和 systemd 自身监控，确保 Prometheus 进程异常时自动恢复。

3.3 Docker 部署：快速原型与轻量级场景

Docker 部署将 Prometheus 及其依赖打包在容器内，适合快速验证配置、本地开发或边缘节点监控。

3.3.1 基础部署命令

docker run -d \
  --name prometheus \
  -p 9090:9090 \
  -v /etc/prometheus:/etc/prometheus \
  -v /var/lib/prometheus:/prometheus \
  prom/prometheus:v2.53.0 \
  --config.file=/etc/prometheus/prometheus.yml \
  --storage.tsdb.path=/prometheus \
  --web.console.libraries=/etc/prometheus/console_libraries \
  --web.console.templates=/etc/prometheus/consoles

3.3.2 docker-compose 多服务编排

当需要同时部署 Prometheus、Alertmanager、Grafana 时，推荐使用 docker-compose 统一管理：

version: '3.8'
services:
  prometheus:
    image: prom/prometheus:v2.53.0
    container_name: prometheus
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      - prometheus_data:/prometheus
    ports:
      - "9090:9090"
    restart: unless-stopped

  alertmanager:
    image: prom/alertmanager:v0.27.0
    container_name: alertmanager
    volumes:
      - ./alertmanager.yml:/etc/alertmanager/alertmanager.yml
    ports:
      - "9093:9093"
    restart: unless-stopped

  grafana:
    image: grafana/grafana:11.0.0
    container_name: grafana
    volumes:
      - grafana_data:/var/lib/grafana
    ports:
      - "3000:3000"
    restart: unless-stopped

volumes:
  prometheus_data:
  grafana_data:

3.3.3 调优要点

• 资源限制： 使用 --memory 和 --cpus 参数限制容器资源，避免容器争抢宿主机资源。
• 日志驱动： 使用 --log-opt max-size=10m --log-opt max-file=3 控制容器日志轮转。
• 网络模式： 若 Prometheus 需要采集宿主机指标，使用 --network=host 模式。
• 持久化： 务必使用 Docker volume 或绑定挂载保存 TSDB 数据，容器重建后数据不丢失。

3.4 Operator 部署：K8s 控制面的原生方案

Prometheus Operator 基于 Kubernetes 的 CRD（Custom Resource Definition）机制，将 Prometheus 实例、ServiceMonitor、Rule 等资源抽象为 K8s 对象，实现声明式运维。

3.4.1 核心 CRD 体系

3.4.2 部署示例

使用 Helm 安装 kube-prometheus-stack（包含 Operator、Prometheus、Alertmanager、Grafana）：

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update

helm install monitoring prometheus-community/kube-prometheus-stack \
  --namespace monitoring \
  --create-namespace \
  --set prometheus.prometheusSpec.replicas=2 \
  --set prometheus.prometheusSpec.retention=30d \
  --set prometheus.prometheusSpec.resources.requests.memory=4Gi \
  --set prometheus.prometheusSpec.resources.limits.memory=8Gi \
  --set alertmanager.alertmanagerSpec.replicas=3

3.4.3 调优要点

• 副本与反亲和： 设置 replicas: 2 或更多，配合 PodAntiAffinity 将实例调度到不同节点，实现高可用。
• 存储类： 使用高性能 StorageClass（如 SSD 后端），设置 storage.volumeClaimTemplate.spec.storageClassName。
• 资源配额： 根据 scrape 目标数量调整 resources.requests 和 limits，避免 OOMKill。
• Sharding： 当 scrape 目标超过 5000 时，启用 shards 参数将采集任务分片到多个 Prometheus 实例。
• Thanos Sidecar： 集成 Thanos 实现长期存储与全局查询，Operator 原生支持 thanos 配置段。

3.5 三种部署方式对比总结

3.6 选型决策矩阵

3.7 配置与调优通用原则

无论选择哪种部署方式，以下配置调优原则适用于所有控制面环境：

• 全局配置： 设置合理的 scrape_interval（默认 15s，控制面可调整为 30s 以减少负载）和 evaluation_interval（默认 15s）。
• 存储保留： 控制面监控数据通常保留 30-90 天，使用 --storage.tsdb.retention.time 和 --storage.tsdb.retention.size 双重限制。
• 标签优化： 避免高基数标签（如 request_id、user_ip），使用 metric_relabel_configs 丢弃无用标签。
• 安全加固： 启用 --web.external-url 配合反向代理，使用 --web.basic-auth 或 OAuth2 代理保护 API 端点。
• 日志与审计： 将 Prometheus 自身日志输出到独立文件或集中式日志系统，便于排查配置错误。

# prometheus.yml 核心配置片段
global:
  scrape_interval: 30s
  evaluation_interval: 30s
  external_labels:
    cluster: 'control-plane-prod'
    region: 'cn-east-1'

scrape_configs:
  - job_name: 'kubernetes-nodes'
    kubernetes_sd_configs:
      - role: node
    relabel_configs:
      - source_labels: [__meta_kubernetes_node_label_kubernetes_io_hostname]
        target_label: instance
    metric_relabel_configs:
      - source_labels: [__name__]
        regex: 'go_.*'
        action: drop

storage:
  tsdb:
    retention:
      time: 30d
      size: 50GB
    wal-compression: true