Docker Compose 编排 Prometheus 监控栈

1. 目标#

通过 Dockerfile 构建四个监控组件镜像，再用 Docker Compose 一键编排成监控栈：

容器	镜像	端口	作用
monitor-node	monitor-exporter.0	9100	采集节点指标
monitor-alertmanager	monitor-alert.0	9093 / 9094	告警分发
monitor-grafana	monitor-grafana.0	3000	可视化大盘
monitor-prometheus	monitor-prometheus.0	9090	时序数据库与拉取调度

所需软件包：Monitor.tar.gz（含各组件二进制 tar 包与基础镜像）。

2. 准备工作#

1
$ tar -zxvf Monitor.tar.gz
2
$ cd Monitor
3
$ docker load -i CentOS_7.9.2009.tar    # 导入基础镜像

3. 构建 Node-Exporter 镜像#

Dockerfile-exporter

1
FROM centos:centos7.9.2009
2
ADD node_exporter-0.18.1.linux-amd64.tar.gz node_exporter.sh /opt/
3
RUN chmod +x /opt/node_exporter.sh
4
EXPOSE 9100
5
CMD ["/bin/bash","/opt/node_exporter.sh"]

node_exporter.sh

1
#!/bin/bash
2
cd /opt/node_exporter-0.18.1.linux-amd64
3
./node_exporter

构建：

1
$ docker build -t monitor-exporter:v1.0 -f Dockerfile-exporter .

4. 构建 Alertmanager 镜像#

4.1 修改配置#

修改 alertmanager/alertmanager.yml，配置邮件告警通道（按需替换为真实邮箱）：

1
global:
2
  resolve_timeout: 5m
3
  smtp_smarthost: 'smtp.example.com:465'
4
  smtp_from: 'alert@example.com'
5
  smtp_auth_username: 'alert@example.com'
6
  smtp_auth_password: '<授权码>'
7
  smtp_require_tls: false
8

9
route:
10
  group_by: ['alertname']
11
  group_wait: 10s
12
  group_interval: 10s
13
  repeat_interval: 1h
14
  receiver: 'web.hook'
15

16
receivers:
17
  - name: 'web.hook'
18
    webhook_configs:
19
      - url: 'http://127.0.0.1:5001/'
20

21
inhibit_rules:
22
  - source_match:
23
      severity: 'critical'
24
    target_match:
25
      severity: 'warning'
26
    equal: ['alertname', 'instance']

抑制规则配置中 equal 字段如果原模板里有 dev，需要删除——它对应额外的标签维度，缺失该标签时会导致规则不生效。

4.2 Dockerfile-alert#

1
FROM centos:centos7.9.2009
2
ADD alertmanager-0.19.0.linux-amd64.tar.gz alert.sh /opt/
3
ADD alertmanager/alertmanager.yml /opt/alertmanager-0.19.0.linux-amd64
4
RUN chmod +x /opt/alert.sh
5
EXPOSE 9093 9094
6
CMD ["/bin/bash","/opt/alert.sh"]

alert.sh

1
#!/bin/bash
2
cd /opt/alertmanager-0.19.0.linux-amd64
3
./alertmanager --config.file="alertmanager.yml"

构建：

1
$ docker build -t monitor-alert:v1.0 -f Dockerfile-alert .

5. 构建 Grafana 镜像#

Dockerfile-grafana

1
FROM centos:centos7.9.2009
2
ADD grafana-6.4.1.linux-amd64.tar.gz grafana.sh /opt/
3
RUN chmod +x /opt/grafana.sh
4
EXPOSE 3000
5
CMD ["/bin/bash","/opt/grafana.sh"]

grafana.sh

1
#!/bin/bash
2
cd /opt/grafana-6.4.1/bin
3
./grafana-server

构建：

1
$ docker build -t monitor-grafana:v1.0 -f Dockerfile-grafana .

6. 构建 Prometheus 镜像#

6.1 准备 prometheus.yml#

1
global:
2
  scrape_interval:     15s
3
  evaluation_interval: 15s
4

5
alerting:
6
  alertmanagers:
7
    - static_configs:
8
        - targets:
9
            - 172.129.20.57:9093    # 替换为本机 IP
10

11
rule_files:
12
  - /opt/alert-rules.yml
13

14
scrape_configs:
15
  - job_name: 'prometheus'
16
    static_configs:
17
      - targets: ['172.129.20.57:9090']
18
        labels:
19
          instance: 'prometheus'
20

21
  - job_name: 'node'
22
    static_configs:
23
      - targets: ['172.129.20.57:9100']
24
        labels:
25
          instance: 'node-exporter'
26

27
  - job_name: 'alertmanager'
28
    static_configs:
29
      - targets: ['172.129.20.57:9093']
30
        labels:
31
          instance: 'alertmanager'

6.2 Dockerfile-prometheus#

1
FROM centos:centos7.9.2009
2
ADD prometheus-2.13.0.linux-amd64.tar.gz alert-rules.yml prometheus.sh /opt/
3
RUN mkdir -p /data/prometheus
4
COPY prometheus.yml /data/prometheus
5
RUN chmod +x /opt/prometheus.sh
6
EXPOSE 9090
7
CMD ["/bin/bash","/opt/prometheus.sh"]

prometheus.sh

1
#!/bin/bash
2
cd /opt/prometheus-2.13.0.linux-amd64
3
./prometheus --config.file="/data/prometheus/prometheus.yml"

构建：

1
$ docker build -t monitor-prometheus:v1.0 -f Dockerfile-prometheus .

7. docker-compose.yaml 编排#

1
version: "3"
2
services:
3
  monitor-node:
4
    container_name: monitor-node
5
    image: monitor-exporter:v1.0
6
    ports:
7
      - 9100:9100
8
    restart: always
9

10
  monitor-alertmanager:
11
    container_name: monitor-alert
12
    image: monitor-alert:v1.0
13
    depends_on:
14
      - monitor-node
15
    ports:
16
      - 9093:9093
17
      - 9094:9094
18
    restart: always
19

20
  monitor-grafana:
21
    container_name: monitor-grafana
22
    image: monitor-grafana:v1.0
23
    depends_on:
24
      - monitor-node
25
      - monitor-alertmanager
26
    ports:
27
      - 3000:3000
28
    restart: always
29

30
  monitor-prometheus:
31
    container_name: monitor-prometheus
32
    image: monitor-prometheus:v1.0
33
    depends_on:
34
      - monitor-node
35
      - monitor-alertmanager
36
      - monitor-grafana
37
    ports:
38
      - 9090:9090
39
    restart: always

启动：

1
$ docker-compose up -d
2
$ docker-compose ps -a

全部 State 为 Up 即部署成功。

8. 验证与配置数据源#

浏览器访问 http://<节点IP>:9090，Prometheus Web UI。在 Status → Targets 中确认三个 job 状态为 UP。
浏览器访问 http://<节点IP>:3000，Grafana 登录页。默认账号密码均为 admin，首次登录提示修改密码。
添加数据源：Configuration → Data Sources → Add data source → Prometheus
- URL：http://172.129.20.57:9090（用本机 IP，不要用 localhost，容器内 localhost 指容器自身）
- 名称：Prometheus
- 点击 Save & Test，出现 ✓ Data source is working 即成功。
之后可导入 Grafana 官方仪表盘（如 ID 1860 Node Exporter Full）。

9. 常见问题#

现象	排查点
`docker-compose ps` 状态不是 Up	`docker-compose logs <服务名>` 看具体报错
Prometheus Target Down	网络不通或目标端口未监听，检查容器日志和端口映射
Grafana 添加数据源失败	URL 写成 localhost；改成宿主机 IP 或服务名 `monitor-prometheus`
Alertmanager 不发邮件	SMTP 配置错误，授权码非密码；查容器日志
Prometheus 报告 `alert-rules.yml` 不存在	Dockerfile 中 ADD 是否包含规则文件

10. 小结#

监控栈分层很清晰：采集（Exporter）→ 存储与告警（Prometheus + Alertmanager）→ 展示（Grafana）
Compose 编排时用 depends_on 控制启动顺序，但它不等待服务真正就绪，必要时需要业务侧重试
数据源 URL 容易踩坑：容器内的 localhost 不是宿主机，要么用宿主机 IP，要么用 Compose 服务名
真实场景建议把配置文件、数据目录都通过 volumes 挂载出来，避免重建容器丢数据