apache/rocketmq-exporter

镜像概述

Apache RocketMQ Exporter是针对Apache RocketMQ消息中间件的监控指标采集工具，属于Prometheus监控生态的一部分。它通过连接RocketMQ集群的NameServer和Broker，收集集群运行时的各类关键指标，并通过标准HTTP接口（默认路径/metrics）暴露，供Prometheus抓取和后续监控分析（如 Grafana 可视化、告警规则配置等）。

核心功能

• 多维度指标采集：覆盖RocketMQ核心监控维度，包括：
  • 消息生产/消费指标：生产TPS、消费TPS、消息累计数量、消息大小
  • 队列状态指标：队列消息堆积量、最小/最大偏移量、消费位点滞后
  • 延迟指标：消息平均/最大延迟、存储延迟
  • Broker状态指标：Broker存活状态、磁盘使用率、内存占用
• Prometheus兼容：指标格式符合Prometheus规范，支持直接集成到Prometheus监控体系
• 灵活配置：支持通过环境变量自定义连接参数（如NameServer地址、超时时间）、指标暴露端口、采集间隔等
• 轻量部署：基于Docker容器化部署，无复杂依赖，资源占用低

使用场景

• 生产环境监控：实时监控RocketMQ集群运行状态，及时发现消息堆积、消费延迟、Broker异常等问题
• 性能分析：结合Prometheus+Grafana分析消息流量波动、峰值处理能力、瓶颈点
• 故障排查：通过历史指标数据回溯异常时段的集群状态，辅助定位问题根因
• 监控告警集成：对接告警系统（如Alertmanager），配置阈值告警（如堆积量超过阈值、消费延迟过高）

使用方法

快速启动

通过docker run命令快速启动Exporter，需指定RocketMQ集群的NameServer地址（必填）：

bash
docker run -d \
  --name rocketmq-exporter \
  -p 5557:5557 \
  -e ROCKETMQ_CONFIG_NAMESRV_ADDR="namesrv1:9876;namesrv2:9876" \  # RocketMQ NameServer地址列表，多个用分号分隔
  apache/rocketmq-exporter:latest

启动后，可通过http://<容器IP>:5557/metrics访问指标接口，验证是否正常暴露指标。

环境变量配置

Exporter支持通过环境变量自定义配置，常用参数如下：

Docker Compose示例

在监控系统（如Prometheus+Grafana）中集成时，可通过Docker Compose编排部署：

yaml
version: '3'
services:
  rocketmq-exporter:
    image: docker.xuanyuan.run/apache/rocketmq-exporter:latest
    container_name: rocketmq-exporter
    ports:
      - "5557:5557"
    environment:
      - ROCKETMQ_CONFIG_NAMESRV_ADDR=namesrv:9876  # 替换为实际NameServer地址
      - ROCKETMQ_EXPORTER_PORT=5557
      - ROCKETMQ_EXPORTER_INTERVAL=10
      - LOG_LEVEL=INFO
    restart: unless-stopped
    networks:
      - monitor-network

  prometheus:
    image: docker.xuanyuan.run/prom/prometheus:latest
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    ports:
      - "9090:9090"
    networks:
      - monitor-network

networks:
  monitor-network:

Prometheus配置示例（prometheus.yml）：

yaml
scrape_configs:
  - job_name: 'rocketmq'
    static_configs:
      - targets: ['rocketmq-exporter:5557']  # 对应Exporter容器名称或IP:端口
    scrape_interval: 10s  # 与Exporter采集间隔保持一致

指标说明

Exporter暴露的核心指标名称及说明（完整指标可通过/metrics接口查看）：

注意事项

• NameServer地址配置：必须确保Exporter能访问到RocketMQ的NameServer，否则无法获取集群元数据
• 网络连通性：Exporter容器需与RocketMQ集群（NameServer、Broker）网络互通
• 版本兼容性：建议使用与RocketMQ集群版本匹配的Exporter版本（如RocketMQ 4.9.x对应Exporter 0.0.2+）
• 资源配置：根据集群规模调整容器资源（如CPU/内存），大规模集群建议适当提高内存分配（推荐≥512MB）