RabbitMQ安装部署，如何通过Prometheus监控RabbitMQ

一、RabbitMQ安装部署指南

1.1 环境准备

RabbitMQ作为开源的消息代理软件，支持多种操作系统。在部署前，需确保服务器满足以下基本要求：

• 操作系统：Linux（推荐CentOS/Ubuntu）、Windows Server
• 内存：建议≥4GB（生产环境）
• 磁盘空间：根据消息存储量规划，建议≥20GB
• 依赖项：Erlang运行时环境（RabbitMQ基于Erlang开发）

1.2 安装步骤（以CentOS为例）

1.2.1 安装Erlang

RabbitMQ 3.9+版本需Erlang 23.x或更高版本。通过以下命令安装：

# 添加Erlang仓库
rpm -Uvh https://packages.erlang-solutions.com/erlang-solutions-2.0-1.noarch.rpm
# 安装Erlang
yum install esl-erlang

1.2.2 安装RabbitMQ

# 添加RabbitMQ官方仓库
curl -1sLf 'https://dl.cloudsmith.io/public/rabbitmq/rabbitmq-server/setup.rpm.sh' | sudo -E bash
# 安装RabbitMQ Server
yum install rabbitmq-server

1.2.3 启动服务

systemctl enable rabbitmq-server
systemctl start rabbitmq-server

1.3 基础配置

1.3.1 启用管理插件

RabbitMQ默认不开启Web管理界面，需通过插件启用：

rabbitmq-plugins enable rabbitmq_management

访问http://<服务器IP>:15672，默认用户名/密码为guest/guest。

1.3.2 安全配置

• 修改默认密码：

  rabbitmqctl change_password guest <新密码>

• 创建专用用户：

  rabbitmqctl add_user monitor_user <密码>
  rabbitmqctl set_user_tags monitor_user monitoring
  rabbitmqctl set_permissions -p / monitor_user ".*" ".*" ".*"

二、Prometheus监控RabbitMQ

2.1 监控原理

Prometheus通过抓取RabbitMQ的HTTP API端点（默认/metrics）获取指标数据。RabbitMQ需启用Prometheus插件，该插件将内部指标转换为Prometheus兼容格式。

2.2 部署步骤

2.2.1 启用RabbitMQ Prometheus插件

rabbitmq-plugins enable rabbitmq_prometheus

插件默认在5552端口暴露指标，可通过以下命令验证：

curl http://localhost:5552/metrics

2.2.2 配置Prometheus服务器

1. 修改Prometheus配置文件（prometheus.yml）：

   scrape_configs:
     - job_name: 'rabbitmq'
       static_configs:
         - targets: ['<RabbitMQ服务器IP>:5552']

2. 重启Prometheus服务：

   systemctl restart prometheus

2.3 关键监控指标

Prometheus可抓取以下RabbitMQ核心指标：
| 指标名称 | 描述 |
|———————————————|——————————————-|
| rabbitmq_queue_messages | 队列中的消息总数 |
| rabbitmq_queue_consumers | 消费者数量 |
| rabbitmq_node_mem_used | 节点内存使用量（字节） |
| rabbitmq_node_disk_free | 节点磁盘剩余空间（字节） |
| rabbitmq_connections | 当前连接数 |

2.4 可视化与告警

2.4.1 Grafana仪表盘

1. 导入RabbitMQ官方仪表盘模板（ID：10981）。
2. 配置变量：
   • host: $__url.host
   • port: 5552

2.4.2 告警规则示例

groups:
  - name: rabbitmq.rules
    rules:
      - alert: HighQueueDepth
        expr: rabbitmq_queue_messages > 1000
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "队列 {{ $labels.queue }} 消息积压"
          description: "当前消息数: {{ $value }}"

三、高级优化

3.1 性能调优

• 内存阈值：修改/etc/rabbitmq/rabbitmq.conf：

  vm_memory_high_watermark.relative = 0.6

• 磁盘预警：

  disk_free_limit.absolute = 1GB

3.2 高可用部署

3.2.1 集群搭建

# 在节点2上执行（假设节点1IP为192.168.1.100）
rabbitmqctl stop_app
rabbitmqctl join_cluster rabbit@node1
rabbitmqctl start_app

3.2.2 镜像队列配置

rabbitmqctl set_policy ha-all "^ha\." '{"ha-mode":"all"}'

3.3 监控扩展

• 自定义指标：通过Erlang代码暴露业务指标：

  -module(custom_metrics).
  -export([collect_mf/3]).
  collect_mf(_Registry, Callback) ->
      Callback(
          [#{name => "custom_metric",
             help => "业务自定义指标",
             type => counter,
             value => 42}]
      ).

• Exporter集成：使用prometheus_rabbitmq_exporter实现更细粒度监控。

四、常见问题解决

4.1 指标抓取失败

• 问题：Prometheus日志显示connection refused
• 解决：
  1. 检查RabbitMQ Prometheus插件是否运行：

     rabbitmq-plugins list | grep prometheus

  2. 验证防火墙规则：

     firewall-cmd --list-ports | grep 5552

4.2 内存溢出

• 现象：RabbitMQ日志出现OOM Command not permitted
• 方案：
  1. 调整Erlang内存分配：

     export ERL_MAX_PORTS=4096
     export ERL_FULLSWEEP_AFTER=0

  2. 启用内存监控告警。

五、最佳实践

1. 标签设计：

   • 为队列添加environment、service等标签，便于多维度分析。
   • 示例指标标签：

     rabbitmq_queue_messages{queue="order_queue",environment="prod"}

2. 容量规划：

   • 根据rabbitmq_node_mem_used和rabbitmq_node_disk_free预测扩容时机。
   • 历史数据保留策略建议设置为30天。

3. 备份验证：

   • 定期执行rabbitmqctl backup /path/to/backup。
   • 通过rabbitmqctl join_cluster验证备份恢复流程。

通过以上步骤，可实现RabbitMQ的高效部署与全面监控。实际生产环境中，建议结合CI/CD流水线自动化完成安装配置，并通过Ansible/Terraform等工具实现多环境一致性管理。