2. Prometheus 安装与启动：二进制安装、Docker 部署、配置文件基础结构

本章聚焦 Prometheus 服务端自身的安装与启动方式。生产环境中，二进制安装适用于物理机或虚拟机，Docker 部署适用于容器化环境。无论哪种方式，最终都会指向同一个核心——prometheus.yml 配置文件的结构与语义。

2.1 二进制安装（Linux amd64）

二进制安装是最直接的方式，不依赖任何运行时环境，适合对系统资源有严格管控的场景。

步骤清单

1. 下载：从 Prometheus 官方 GitHub Releases 获取最新稳定版 tarball。
2. 解压：tar -xzf prometheus-*.tar.gz
3. 移动目录：将解压后的目录移至 /opt/prometheus 或 /usr/local/prometheus。
4. 创建数据目录：mkdir -p /data/prometheus
5. 启动测试：直接执行二进制文件，指定配置文件与存储路径。

启动命令示例

cd /opt/prometheus
./prometheus \
  --config.file=prometheus.yml \
  --storage.tsdb.path=/data/prometheus \
  --web.listen-address=0.0.0.0:9090 \
  --log.level=info

2.2 Docker 部署

Docker 部署将 Prometheus 进程、配置、数据卷分离，适合快速迭代与 CI/CD 环境。

单容器快速启动

docker run -d \
  --name prometheus \
  -p 9090:9090 \
  -v /path/to/prometheus.yml:/etc/prometheus/prometheus.yml \
  -v prometheus_data:/prometheus \
  prom/prometheus:latest

docker-compose 推荐结构

version: '3.8'
services:
  prometheus:
    image: prom/prometheus:latest
    container_name: prometheus
    restart: always
    ports:
      - "9090:9090"
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      - prometheus_data:/prometheus
    command:
      - '--config.file=/etc/prometheus/prometheus.yml'
      - '--storage.tsdb.path=/prometheus'
      - '--web.console.libraries=/usr/share/prometheus/console_libraries'
      - '--web.console.templates=/usr/share/prometheus/consoles'

volumes:
  prometheus_data:

2.3 两种部署方式对比

2.4 配置文件基础结构

prometheus.yml 是 Prometheus 的核心配置，采用 YAML 格式。以下是最小可用配置的结构拆解。

最小配置示例

global:
  scrape_interval: 15s      # 全局采集间隔
  evaluation_interval: 15s  # 全局规则评估间隔

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

配置块语义说明

global 块关键字段

• scrape_interval：默认采集间隔，所有 job 未单独指定时使用此值。
• evaluation_interval：Prometheus 评估告警规则与记录规则的频率。
• scrape_timeout：单次采集超时时间，默认 10s，不能超过 scrape_interval。
• external_labels：全局标签，会附加到所有时间序列与告警中，常用于多集群标识。

scrape_configs 块核心字段

2.5 启动验证与健康检查

无论使用哪种部署方式，启动后都应执行以下验证步骤：

1. 访问 Web UI：浏览器打开 http://<IP>:9090，确认页面正常加载。
2. 查看 /metrics：curl http://localhost:9090/metrics，确认 Prometheus 自身指标暴露。
3. 检查 /-/ready：返回 200 OK 表示就绪。
4. 检查 /-/healthy：返回 200 OK 表示健康。
5. 查看 Target 状态：Web UI → Status → Targets，确认配置的 job 状态为 UP。

2.6 常见启动问题与排查