sapcc/mosquitto-exporter

mosquitto-exporter 镜像文档

镜像概述

mosquitto-exporter是一个Prometheus指标导出器，专门用于从Mosquitto MQTT消息代理收集并暴露运行指标。通过对接Mosquitto的管理接口，该工具可将关键指标（如连接数、消息吞吐量、订阅数等）转换为Prometheus兼容格式，便于监控系统进行数据采集、存储和分析。

核心功能与特性

• 全面指标收集：支持收集Mosquitto的核心运行指标，包括连接数、活跃客户端数、消息发送/接收量、订阅数、保留消息数等
• Prometheus兼容：指标暴露格式符合Prometheus规范，可直接被Prometheus抓取
• 灵活配置：支持通过环境变量配置Mosquitto管理接口地址、认证信息及导出器监听端口
• 轻量级设计：容器化部署，资源占用低，易于集成到现有监控体系

使用场景

• IoT平台中Mosquitto代理的性能监控
• MQTT消息系统的运行状态跟踪与告警
• 分布式消息架构中的代理节点健康度监控
• DevOps流程中Mosquitto服务的性能指标可视化

使用方法与配置说明

环境变量配置

Docker Run 部署示例

bash
docker run -d \
  --name mosquitto-exporter \
  -p 9234:9234 \
  -e MOSQUITTO_URI="tcp://mosquitto-broker:1883" \
  -e MOSQUITTO_USER="admin" \
  -e MOSQUITTO_PASSWORD="secure_password" \
  sapcc/mosquitto-exporter

Docker Compose 配置示例

yaml
version: '3'
services:
  mosquitto-exporter:
    image: sapcc/mosquitto-exporter
    container_name: mosquitto-exporter
    ports:
      - "9234:9234"
    environment:
      - MOSQUITTO_URI=tcp://mosquitto:1883
      - MOSQUITTO_USER=admin
      - MOSQUITTO_PASSWORD=secure_password
      - LISTEN_PORT=9234
      - LOG_LEVEL=info
    depends_on:
      - mosquitto

  mosquitto:
    image: eclipse-mosquitto
    container_name: mosquitto
    ports:
      - "1883:1883"
    volumes:
      - ./mosquitto/config:/mosquitto/config
      - ./mosquitto/data:/mosquitto/data
      - ./mosquitto/log:/mosquitto/log

Prometheus 配置示例

在Prometheus的prometheus.yml中添加如下抓取配置：

yaml
scrape_configs:
  - job_name: 'mosquitto'
    static_configs:
      - targets: ['mosquitto-exporter:9234']

暴露指标示例

导出器暴露的部分关键指标如下：

• mosquitto_connections_total：总连接数
• mosquitto_active_clients：活跃客户端数
• mosquitto_messages_received_total：接收消息总数
• mosquitto_messages_sent_total：发送消息总数
• mosquitto_subscriptions_total：订阅总数
• mosquitto_retained_messages：保留消息数