hivemq/hivemq-platform-monitoring

HiveMQ监控应用镜像文档

镜像概述和主要用途

本镜像为HiveMQ平台提供专用监控工具，主要功能是实时检查MQTT协议的核心操作状态，确保HiveMQ服务的稳定运行。可监控MQTT连接建立、消息发布及订阅功能的可用性，是HiveMQ平台运维和管理的重要辅助工具。

核心功能和特性

• MQTT连接性检查：验证与HiveMQ broker的网络连接状态
• 发布功能检查：模拟客户端发布消息至指定主题，检测消息传递能力
• 订阅功能检查：模拟客户端订阅主题，验证消息接收机制

使用场景和适用范围

• HiveMQ平台日常运维监控
• MQTT服务可用性实时检测
• 自动化测试环境中MQTT功能验证
• IoT设备通信链路诊断与问题排查

使用方法和配置说明

基本使用（Docker Run）

通过以下命令启动监控容器：

bash
docker run -e BROKER_URL=mqtt://your-hivemq-broker -e PORT=1883 -e TOPIC=monitor/test hivemq/monitoring-app

环境变量配置

Docker Compose示例

yaml
version: '3'
services:
  hivemq-monitor:
    image: hivemq/monitoring-app
    environment:
      - BROKER_URL=mqtt://hivemq-service
      - PORT=1883
      - TOPIC=system/health
      - QOS=1
      - TIMEOUT=60
    restart: always

启动命令：docker-compose up -d

输出说明

容器运行后将在日志中输出监控结果，成功状态示例：

• "MQTT连接成功"
• "消息发布成功"
• "订阅消息接收成功"

失败状态将输出具体错误信息，如"连接超时"、"发布失败"等，便于问题定位。