VerneMQ监控指标解析：状态页面与Prometheus端点的差异

概述

VerneMQ作为一款高性能的MQTT消息代理，提供了多种监控方式帮助运维人员掌握系统运行状态。其中状态页面和Prometheus/metrics端点是两种常用的监控数据获取方式，但两者提供的指标存在一定差异，这在实际运维中可能会造成困惑。

监控指标对比

VerneMQ的状态页面提供了丰富的运行时指标，包括：

• 在线客户端数量(num_online)
• 离线客户端数量(num_offline)
• 消息流入/流出数量(msg_in/msg_out)
• 队列操作统计(queue_in/queue_out/queue_drop/queue_unhandled)
• 订阅数量(num_subscriptions)
• 保留消息数量(num_retained)

而Prometheus/metrics端点则基于vmq-admin metrics show命令输出的指标列表，虽然包含大部分相同信息，但指标命名有所不同：

• 保留消息指标显示为gauge.retain_messages
• 订阅数量指标显示为gauge.router_subscriptions

关键差异分析

最值得注意的差异在于客户端状态统计。状态页面中的num_offline和num_online指标实际上是前端JavaScript通过计算得出的：

1. 系统提供了队列进程的指标(gauge)
2. 同时提供了在线连接的指标(gauge)
3. 离线客户端数量即为两者之差

这种计算方式意味着在Prometheus中，用户可以通过组合查询实现相同的统计效果，而不需要直接获取离线客户端数量指标。

实际应用建议

对于需要全面监控VerneMQ的用户，建议：

1. 熟悉vmq-admin metrics show命令输出的完整指标列表
2. 了解状态页面指标与Prometheus指标的对应关系
3. 对于JavaScript计算的指标，可以在Prometheus中通过查询组合实现相同功能
4. 定期检查指标一致性，确保监控系统覆盖所有关键指标

通过深入理解这些监控指标的来源和关系，运维人员可以构建更全面、可靠的VerneMQ监控体系，及时发现并解决系统运行中的潜在问题。