1. 项目概述在AlmaLinux系统上通过容器化方式部署PrometheusGrafana监控套件是当前企业级监控系统搭建的主流方案之一。作为CentOS的替代品AlmaLinux凭借其稳定性和长期支持特性成为众多运维团队的首选操作系统。而将Prometheus指标采集与Grafana数据可视化这两个黄金组合以Docker容器方式部署既能保证环境隔离又能简化依赖管理。我最近在客户生产环境中实际部署了这套监控系统发现相比传统二进制安装方式容器化部署可以节省约60%的配置时间且更容易实现版本管理和快速迁移。下面将详细介绍从零开始完成整套部署的关键步骤和实战技巧。2. 环境准备2.1 系统基础配置首先确保使用AlmaLinux 8或9版本推荐9.3执行系统更新sudo dnf update -y sudo dnf install -y yum-utils device-mapper-persistent-data lvm2注意如果是从CentOS迁移过来的系统建议检查/etc/os-release确认系统类型避免残留的CentOS源导致依赖冲突。2.2 Docker环境安装添加Docker官方仓库sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo安装Docker引擎sudo dnf install -y docker-ce docker-ce-cli containerd.io启动并设置开机自启sudo systemctl enable --now docker验证安装sudo docker run hello-world2.3 防火墙与SELinux配置AlmaLinux默认启用了firewalld和SELinux需要适当调整# 放行Docker使用的端口范围 sudo firewall-cmd --permanent --zonepublic --add-port3000/tcp # Grafana sudo firewall-cmd --permanent --zonepublic --add-port9090/tcp # Prometheus sudo firewall-cmd --reload # SELinux设置为permissive模式生产环境建议保持enforcing并配置正确策略 sudo setenforce 0 sudo sed -i s/^SELINUXenforcing/SELINUXpermissive/ /etc/selinux/config3. Prometheus容器化部署3.1 配置文件准备创建配置目录结构mkdir -p ~/monitoring/prometheus/{data,conf} chmod 777 ~/monitoring/prometheus/data # 确保容器有写入权限编写Prometheus主配置文件~/monitoring/prometheus/conf/prometheus.ymlglobal: scrape_interval: 15s evaluation_interval: 15s scrape_configs: - job_name: prometheus static_configs: - targets: [localhost:9090]3.2 启动Prometheus容器使用官方镜像运行容器docker run -d \ --nameprometheus \ --restartalways \ -p 9090:9090 \ -v ~/monitoring/prometheus/conf:/etc/prometheus \ -v ~/monitoring/prometheus/data:/prometheus \ prom/prometheus:latest \ --config.file/etc/prometheus/prometheus.yml \ --storage.tsdb.path/prometheus \ --web.console.templates/etc/prometheus/consoles \ --web.console.libraries/etc/prometheus/console_libraries关键参数说明--restartalways确保容器异常退出后自动重启-v挂载卷持久化配置和时序数据--storage.tsdb.path指定TSDB存储路径3.3 验证部署访问http://服务器IP:9090应该能看到Prometheus Web界面。通过Status Targets可以查看当前监控目标状态。4. Grafana容器化部署4.1 启动Grafana容器docker run -d \ --namegrafana \ --restartalways \ -p 3000:3000 \ -v ~/monitoring/grafana/data:/var/lib/grafana \ grafana/grafana-oss:latest4.2 初始配置访问http://服务器IP:3000默认账号admin/admin首次登录会要求修改密码添加Prometheus数据源Configuration Data Sources Add data source选择PrometheusURL填写http://prometheus容器IP:9090点击Save Test技巧如果不知道Prometheus容器IP可以用docker inspect prometheus | grep IPAddress查询4.3 导入仪表盘Grafana官方提供丰富的仪表盘模板导航到Dashboards New Import输入模板ID如1860用于Node Exporter仪表盘选择刚添加的Prometheus数据源点击Import完成导入5. 进阶配置与优化5.1 使用Docker Compose编排创建docker-compose.yml统一管理服务version: 3 services: prometheus: image: prom/prometheus:latest container_name: prometheus restart: always ports: - 9090:9090 volumes: - ./prometheus/conf:/etc/prometheus - ./prometheus/data:/prometheus command: - --config.file/etc/prometheus/prometheus.yml - --storage.tsdb.path/prometheus - --web.console.templates/etc/prometheus/consoles - --web.console.libraries/etc/prometheus/console_libraries grafana: image: grafana/grafana-oss:latest container_name: grafana restart: always ports: - 3000:3000 volumes: - ./grafana/data:/var/lib/grafana depends_on: - prometheus启动服务docker-compose up -d5.2 添加Node Exporter监控主机在需要监控的机器上运行docker run -d \ --namenode_exporter \ --restartalways \ --nethost \ --pidhost \ -v /:/host:ro,rslave \ prom/node-exporter:latest \ --path.rootfs/host然后在Prometheus配置中添加jobscrape_configs: - job_name: node static_configs: - targets: [主机IP:9100]5.3 配置告警规则在prometheus.yml同目录创建alerts.ymlgroups: - name: host_stats rules: - alert: HighMemoryUsage expr: (node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes * 100 90 for: 5m labels: severity: warning annotations: summary: High memory usage on {{ $labels.instance }} description: Memory usage is {{ $value }}%在prometheus.yml中启用告警规则rule_files: - alerts.yml6. 常见问题排查6.1 容器无法访问外部网络现象Prometheus无法抓取其他主机的exporter数据解决方案# 检查Docker网络模式 docker network inspect bridge # 临时解决方案使用host网络模式 docker run --nethost ...6.2 数据卷权限问题现象容器启动失败日志显示permission denied解决方案# 递归修改数据目录权限 sudo chown -R 472:472 ~/monitoring/grafana/data sudo chown -R nobody:nobody ~/monitoring/prometheus/data6.3 Prometheus存储优化对于长期运行的监控系统需要调整TSDB配置# 在prometheus.yml中添加 storage: tsdb: retention: 15d # 数据保留周期 wal_compression: true # 启用WAL压缩7. 生产环境建议资源限制为容器设置合理的CPU和内存限制docker run --memory2g --cpus1 ...日志管理配置日志轮转docker run --log-driverjson-file --log-opt max-size50m --log-opt max-file3 ...备份策略定期备份重要数据# 备份Prometheus数据 tar czvf prometheus_backup.tar.gz ~/monitoring/prometheus/data # 备份Grafana配置 docker exec grafana grafana-cli admin backup backup-fileHTTPS配置通过Nginx反向代理添加SSL证书高可用方案考虑部署Prometheus HA集群和Grafana多实例这套容器化监控方案已经在多个生产环境稳定运行相比传统部署方式最大的优势在于环境隔离避免与系统其他服务产生依赖冲突快速部署全新环境10分钟内可完成全套部署易于维护通过容器编排工具实现一键更新和回滚资源可控精确限制每个组件的资源使用量实际使用中建议配合cAdvisor实现容器监控再结合Alertmanager构建完整的告警体系。对于大规模环境可以考虑使用VictoriaMetrics替代Prometheus以获得更好的性能。
1. 项目概述在AlmaLinux系统上通过容器化方式部署PrometheusGrafana监控套件是当前企业级监控系统搭建的主流方案之一。作为CentOS的替代品AlmaLinux凭借其稳定性和长期支持特性成为众多运维团队的首选操作系统。而将Prometheus指标采集与Grafana数据可视化这两个黄金组合以Docker容器方式部署既能保证环境隔离又能简化依赖管理。我最近在客户生产环境中实际部署了这套监控系统发现相比传统二进制安装方式容器化部署可以节省约60%的配置时间且更容易实现版本管理和快速迁移。下面将详细介绍从零开始完成整套部署的关键步骤和实战技巧。2. 环境准备2.1 系统基础配置首先确保使用AlmaLinux 8或9版本推荐9.3执行系统更新sudo dnf update -y sudo dnf install -y yum-utils device-mapper-persistent-data lvm2注意如果是从CentOS迁移过来的系统建议检查/etc/os-release确认系统类型避免残留的CentOS源导致依赖冲突。2.2 Docker环境安装添加Docker官方仓库sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo安装Docker引擎sudo dnf install -y docker-ce docker-ce-cli containerd.io启动并设置开机自启sudo systemctl enable --now docker验证安装sudo docker run hello-world2.3 防火墙与SELinux配置AlmaLinux默认启用了firewalld和SELinux需要适当调整# 放行Docker使用的端口范围 sudo firewall-cmd --permanent --zonepublic --add-port3000/tcp # Grafana sudo firewall-cmd --permanent --zonepublic --add-port9090/tcp # Prometheus sudo firewall-cmd --reload # SELinux设置为permissive模式生产环境建议保持enforcing并配置正确策略 sudo setenforce 0 sudo sed -i s/^SELINUXenforcing/SELINUXpermissive/ /etc/selinux/config3. Prometheus容器化部署3.1 配置文件准备创建配置目录结构mkdir -p ~/monitoring/prometheus/{data,conf} chmod 777 ~/monitoring/prometheus/data # 确保容器有写入权限编写Prometheus主配置文件~/monitoring/prometheus/conf/prometheus.ymlglobal: scrape_interval: 15s evaluation_interval: 15s scrape_configs: - job_name: prometheus static_configs: - targets: [localhost:9090]3.2 启动Prometheus容器使用官方镜像运行容器docker run -d \ --nameprometheus \ --restartalways \ -p 9090:9090 \ -v ~/monitoring/prometheus/conf:/etc/prometheus \ -v ~/monitoring/prometheus/data:/prometheus \ prom/prometheus:latest \ --config.file/etc/prometheus/prometheus.yml \ --storage.tsdb.path/prometheus \ --web.console.templates/etc/prometheus/consoles \ --web.console.libraries/etc/prometheus/console_libraries关键参数说明--restartalways确保容器异常退出后自动重启-v挂载卷持久化配置和时序数据--storage.tsdb.path指定TSDB存储路径3.3 验证部署访问http://服务器IP:9090应该能看到Prometheus Web界面。通过Status Targets可以查看当前监控目标状态。4. Grafana容器化部署4.1 启动Grafana容器docker run -d \ --namegrafana \ --restartalways \ -p 3000:3000 \ -v ~/monitoring/grafana/data:/var/lib/grafana \ grafana/grafana-oss:latest4.2 初始配置访问http://服务器IP:3000默认账号admin/admin首次登录会要求修改密码添加Prometheus数据源Configuration Data Sources Add data source选择PrometheusURL填写http://prometheus容器IP:9090点击Save Test技巧如果不知道Prometheus容器IP可以用docker inspect prometheus | grep IPAddress查询4.3 导入仪表盘Grafana官方提供丰富的仪表盘模板导航到Dashboards New Import输入模板ID如1860用于Node Exporter仪表盘选择刚添加的Prometheus数据源点击Import完成导入5. 进阶配置与优化5.1 使用Docker Compose编排创建docker-compose.yml统一管理服务version: 3 services: prometheus: image: prom/prometheus:latest container_name: prometheus restart: always ports: - 9090:9090 volumes: - ./prometheus/conf:/etc/prometheus - ./prometheus/data:/prometheus command: - --config.file/etc/prometheus/prometheus.yml - --storage.tsdb.path/prometheus - --web.console.templates/etc/prometheus/consoles - --web.console.libraries/etc/prometheus/console_libraries grafana: image: grafana/grafana-oss:latest container_name: grafana restart: always ports: - 3000:3000 volumes: - ./grafana/data:/var/lib/grafana depends_on: - prometheus启动服务docker-compose up -d5.2 添加Node Exporter监控主机在需要监控的机器上运行docker run -d \ --namenode_exporter \ --restartalways \ --nethost \ --pidhost \ -v /:/host:ro,rslave \ prom/node-exporter:latest \ --path.rootfs/host然后在Prometheus配置中添加jobscrape_configs: - job_name: node static_configs: - targets: [主机IP:9100]5.3 配置告警规则在prometheus.yml同目录创建alerts.ymlgroups: - name: host_stats rules: - alert: HighMemoryUsage expr: (node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes * 100 90 for: 5m labels: severity: warning annotations: summary: High memory usage on {{ $labels.instance }} description: Memory usage is {{ $value }}%在prometheus.yml中启用告警规则rule_files: - alerts.yml6. 常见问题排查6.1 容器无法访问外部网络现象Prometheus无法抓取其他主机的exporter数据解决方案# 检查Docker网络模式 docker network inspect bridge # 临时解决方案使用host网络模式 docker run --nethost ...6.2 数据卷权限问题现象容器启动失败日志显示permission denied解决方案# 递归修改数据目录权限 sudo chown -R 472:472 ~/monitoring/grafana/data sudo chown -R nobody:nobody ~/monitoring/prometheus/data6.3 Prometheus存储优化对于长期运行的监控系统需要调整TSDB配置# 在prometheus.yml中添加 storage: tsdb: retention: 15d # 数据保留周期 wal_compression: true # 启用WAL压缩7. 生产环境建议资源限制为容器设置合理的CPU和内存限制docker run --memory2g --cpus1 ...日志管理配置日志轮转docker run --log-driverjson-file --log-opt max-size50m --log-opt max-file3 ...备份策略定期备份重要数据# 备份Prometheus数据 tar czvf prometheus_backup.tar.gz ~/monitoring/prometheus/data # 备份Grafana配置 docker exec grafana grafana-cli admin backup backup-fileHTTPS配置通过Nginx反向代理添加SSL证书高可用方案考虑部署Prometheus HA集群和Grafana多实例这套容器化监控方案已经在多个生产环境稳定运行相比传统部署方式最大的优势在于环境隔离避免与系统其他服务产生依赖冲突快速部署全新环境10分钟内可完成全套部署易于维护通过容器编排工具实现一键更新和回滚资源可控精确限制每个组件的资源使用量实际使用中建议配合cAdvisor实现容器监控再结合Alertmanager构建完整的告警体系。对于大规模环境可以考虑使用VictoriaMetrics替代Prometheus以获得更好的性能。
