tencent cloud

消息队列 MQTT 版

动态与公告
新功能发布记录
产品简介
TDMQ 产品系列介绍与选型
什么是消息队列 MQTT 版
应用场景
技术架构
产品系列
MQTT 协议兼容说明
开源对比
高可用
产品约束与使用配额
基本概念
开服地域
购买指南
计费概述
续费说明
查看消费明细
欠费说明
退费说明
快速入门
入门流程指引
准备工作
公网接入
VPC 网络接入
用户指南
使用流程指引
配置账号权限
新建集群
管理 Topic
连接集群
查询消息
管理客户端
管理集群
查看监控和配置告警
数据集成
集成数据到云函数 SCF
集成数据到 CKafka
集成数据到 RocketMQ
开发指南
MQTT 5 高级特性
数据面 HTTP 接口说明
配置自定义域名
配置 SQL 过滤
配置点对点订阅
MQTT over QUIC
管理客户端订阅
消息增强规则
实践教程
MQTT 客户端开发注意事项
可观测能力
Topic 与通配符订阅
API 参考
History
Introduction
API Category
Making API Requests
Cluster APIs
Topic APIs
Authorization Policy APIs
User APIs
Client APIs
Message Enhancement Rule APIs
Message APIs
Data Types
Error Codes
SDK 参考
接入点格式
Java SDK
C SDK
Javascript/Node.JS/小程序
Go SDK
iOS SDK
JavaScript SDK
Dart SDK
Python SDK
.NET
安全与合规
权限管理
常见问题
相关协议
隐私协议
数据处理和安全协议
消息队列 MQTT 版服务等级协议
联系我们

监控指标说明

PDF
聚焦模式
字号
最后更新时间: 2026-01-30 15:10:03
消息队列 MQTT 版提供了全面、多维度的监控指标体系,覆盖公网、连接、生产消费、认证授权等各个维度,帮助您实时了解资源运行状态。本文为您介绍 MQTT 的各项监控指标的含义,您可以通过这些指标快速掌握资源的健康状态,并决定是否需要升降配等运维操作,保障其稳定运行。

监控指标

以下是 MQTT 提供的所有监控指标说明,请您根据实际业务需求合理配置监控和告警策略:
集群
Topic
分类
指标中文名
指标英文名
单位
指标含义
统计规则
集群规格相关指标
消息收发负载
MqttTpsLoadPercentage
%
当前集群的消息收发负载 = 当前分钟级峰值 TPS / 集群 TPS 峰值 * 100%,TPS 按照计费概述进行折算。
[ 60s, sum ]
[ 300s, last ]
连接负载
MqttConnectionLoadPercentage
%
当前集群的连接数负载 = 当前在线连接数 / 连接数规格 * 100%。
[ 60s, sum ]
[ 300s, last ]
总 TPS
MqttTpsCount
Count
当前集群分钟级 TPS 峰值变化(生产和消费之和,按照计费概述进行折算),超出集群限制后会被限流。
[ 60s, sum ]
[ 300s, last ]
公网相关指标
公网流出流量
MqttPublicNetworkOutboundTrafficInstance
MB
MQTT 集群流出的公网流量变化,公网费用按照该指标计算。
[ 60s, sum ]
[ 300s, last ]
公网流入流量
MqttPublicNetworkInboundTrafficInstance
MB
客户端请求 MQTT 集群的公网流量变化。
[ 60s, sum ]
[ 300s, last ]
公网流出带宽
MqttPublicNetworkOutboundBandwidthInstance
Mbps
MQTT 集群流出的公网带宽变化。
[ 60s, sum ]
[ 300s, last ]
公网流入带宽
MqttPublicNetworkInboundBandwidthInstance
Mbps
客户端请求 MQTT 集群的公网带宽变化。
[ 60s, sum ]
[ 300s, last ]
公网丢弃出带宽
MqttPublicNetworkDroppedOutboundBandwidthInstance
Bit/s
公网带宽被限流时产生值,大于0时请调大集群的公网带宽限制。
[ 60s, sum ]
[ 300s, last ]
公网丢弃入带宽
MqttPublicNetworkDroppedInboundBandwidthInstance
Bit/s
公网带宽被限流时产生值,大于0时请调大集群的公网带宽限制。
[ 60s, sum ]
[ 300s, last ]
公网出带宽利用率
MqttPublicNetworkOutboundBandwidthUtilizationInstance
%
MQTT 集群通过公网连接客户端时的带宽利用率,等于当前出带宽 / 集群设定的公网带宽规格 * 100%。
[ 60s, sum ]
[ 300s, last ]
公网入带宽利用率
MqttPublicNetworkInboundBandwidthUtilizationInstance
%
客户端通过公网连接 MQTT 集群时的带宽利用率,等于当前入带宽 / 集群设定的公网带宽规格 * 100%。
[ 60s, sum ]
[ 300s, last ]
公网新建连接数
MqttPublicNetworkNewConnectionsRateInstance
Count/s
客户端通过公网连接到 MQTT 集群的每分钟新建连接数。
[ 60s, sum ]
[ 300s, last ]
公网活跃连接数
MqttPublicNetworkActiveConnectionsInstance
Count
客户端通过公网连接到 MQTT 集群的活跃连接数。
[ 60s, sum ]
[ 300s, last ]
公网非活跃连接数
MqttPublicNetworkInactiveConnectionsInstance
Count
客户端通过公网连接到 MQTT 集群的非活跃连接数。
[ 60s, sum ]
[ 300s, last ]
公网并发连接数
MqttPublicNetworkConcurrentConnectionsInstance
Count
客户端通过公网连接到 MQTT 集群的并发连接数。
[ 60s, sum ]
[ 300s, last ]
公网出包量
MqttPublicNetworkOutboundPacketsRateInstance
Count/s
客户端到 MQTT 集群的公网出包量变化。
[ 60s, sum ]
[ 300s, last ]
公网入包量
MqttPublicNetworkInboundPacketsRateInstance
Count/s
客户端到 MQTT 集群的公网入包量变化。
[ 60s, sum ]
[ 300s, last ]
连接相关指标
在线客户端数量
MqttClientCount
Count
当前集群建立的客户端连接数量。
[ 60s, sum ]
[ 300s, last ]
CONNECT 总数量
MqttConnectPacketCount
Count
服务端接收到的 CONNECT Packet 的总数变化。
[ 60s, sum ]
[ 300s, last ]
CONNACK 总数量
MqttReceivedConnackCount
Count
服务端发出的 CONNACK Packet 的总数变化
[ 60s, sum ]
[ 300s, last ]
连接成功次数
MqttConnectSuccessCount
Count
新建连接成功的 CONNECT Packet 的数量变化。
[ 60s, sum ]
[ 300s, last ]
CONNECT 被限流次数
MqttConnectLimitedCount
Count
因为流控机制而连接失败的 CONNECT Packet 的数量变化,可以通过 调整集群规格 避免出现限流。
[ 60s, sum ]
[ 300s, last ]
连接失败次数
MqttConnectFailCount
Count
连接失败的 CONNECT Packet 的数量变化。
[ 60s, sum ]
[ 300s, last ]
DISCONNECT IN 数量
MqttDisconnectPacketCount
Count
服务端收到的 DISCONNECT Packet 的总数变化。
[ 60s, sum ]
[ 300s, last ]
DISCONNECT OUT 数量
MqttReceivedDisconnectCount
Count
服务端发出的 DISCONNECT Packet 的总数变化
[ 60s, sum ]
[ 300s, last ]
PINGREQ 数量
MqttPingreqPacketCount
Count
服务端收到的 PINGREQ Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PINGRESP 数量
MqttReceivedPingrespCount
Count
服务端发出的 PINGRESP Packet 数量
[ 60s, sum ]
[ 300s, last ]
生产相关指标
生产消息数量
MqttInstanceSendMessageCount
Count
当前主题在一个统计周期内的发送消息数量。
[ 60s, sum ]
[ 300s, last ]
PUBLISH 被限流次数
MqttPublishLimitedCount
Count
超出集群规格限制后,被限流的 PUBLISH Packet 数量,可以通过 调整集群规格 避免出现限流。
[ 60s, sum ]
[ 300s, last ]
生产消息平均大小
MqttPublishAverageBytesInstance
Bytes
当前主题在一个统计周期内的发送消息平均大小。
[ 60s, sum ]
[ 300s, last ]
生产流量大小
MqttPublishTrafficBytesInstance
Bytes
当前主题在一个统计周期内的发送消息流量大小。
[ 60s, sum ]
[ 300s, last ]
客户端生产消息错误次数
MqttPublishClientErrorCountInstance
Count
客户端生产指定消息时产生错误码的总次数。
[ 60s, sum ]
[ 300s, last ]
PUBLISH IN 数量
MqttPublishPacketCount
Count
服务端收到的 PUBLISH Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PUBLISH OUT 数量
MqttReceivedPublishCount
Count
服务端发出的 PUBLISH Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PUBACK IN 数量
MqttPubackPacketCount
Count
服务端收到的 PUBACK Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PUBACK OUT 数量
MqttReceivedPubackCount
Count
服务端发出的 PUBACK Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PUBREC IN 数量
MqttPubrecPacketCount
Count
服务端收到的 PUBREC Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PUBREC OUT 数量
MqttReceivedPubrecCount
Count
服务端发出的 PUBREC Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PUBREL IN 数量
MqttPubrelPacketCount
Count
服务端收到的 PUBREL Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PUBREL OUT 数量
MqttReceivedPubrelCount
Count
服务端发出的 PUBREL Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PUBCOMP IN 数量
MqttPubcompPacketCount
Count
服务端收到的 PUBCOMP Packet 数量。
[ 60s, sum ]
[ 300s, last ]
PUBCOMP OUT 数量
MqttReceivedPubcompCount
Count
服务端发出的 PUBCOMP Packet 数量。
[ 60s, sum ]
[ 300s, last ]
消费相关指标
消费消息数量
MqttInstanceConsumeMessageCount
Count
当前主题在一个统计周期内的消费消息数量。
[ 60s, sum ]
[ 300s, last ]
消费消息平均大小
MqttConsumeAverageBytesInstance
Bytes
当前主题在一个统计周期内的消费消息平均大小。
[ 60s, sum ]
[ 300s, last ]
消费流量大小
MqttConsumeTrafficBytesInstance
Bytes
当前主题在一个统计周期内的消费消息流量大小。
[ 60s, sum ]
[ 300s, last ]
客户端消费消息错误次数
MqttConsumeClientErrorCountInstance
Count
客户端消费指定消息时产生错误码的总次数。
[ 60s, sum ]
[ 300s, last ]
消费重试次数
MqttConsumeRetryCountInstance
Count
消费失败后自动重试消费的次数变化。
[ 60s, sum ]
[ 300s, last ]
在线订阅数量
MqttSubscriptionCount
Count
当前集群建立的客户端订阅数量。
[ 60s, sum ]
[ 300s, last ]
SUBSCRIBE 数量
MqttSubscribePacketCount
Count
服务端收到的 SUBSCRIBE Packet 数量。
[ 60s, sum ]
[ 300s, last ]
SUBSCRIBE 被限流次数
MqttConsumeLimitedCount
Count
超出集群规格限制后,被限流的 SUBSCRIBE Packet 数量,可以通过 调整集群规格 避免出现限流。
[ 60s, sum ]
[ 300s, last ]
UNSUBSCRIBE 数量
MqttUnsubscribePacketCount
Count
服务端收到的 UNSUBSCRIBE Packet 数量。
[ 60s, sum ]
[ 300s, last ]
共享订阅未消费消息总数
MqttShareBacklogCountInstance
Count
某个 ShareName 未消费的消息总数,详细参见 配置共享订阅
[ 60s, sum ]
[ 300s, last ]
共享订阅消费数量
MqttShareConsumeCountInstance
Count
统计周期内共享订阅消费消息数量,即 Shared Subscription 消费消息速率。
[ 60s, sum ]
[ 300s, last ]
认证和授权相关指标
认证成功次数
MqttAuthenticationSuccessCount
Count
统计周期内客户端成功通过认证的次数。
[ 60s, sum ]
[ 300s, last ]
认证失败次数
MqttAuthenticationFailureCount
Count
统计周期内客户端认证失败的次数。
[ 60s, sum ]
[ 300s, last ]
授权成功次数
MqttAuthorizationSuccessCount
Count
统计周期内 ACL 授权成功次数。
[ 60s, sum ]
[ 300s, last ]
授权失败次数
MqttAuthorizationFailureCount
Count
统计周期内 ACL 授权失败次数。
[ 60s, sum ]
[ 300s, last ]
CONNECT 授权成功次数
MqttConnectAuthorizationSuccessCount
Count
客户端发送 CONNECT packet时,授权成功的次数。
[ 60s, sum ]
[ 300s, last ]
CONNECT 授权失败次数
MqttConnectAuthorizationFailureCount
Count
客户端发送 CONNECT packet时,授权失败的次数。
[ 60s, sum ]
[ 300s, last ]
PUBLISH 授权成功次数
MqttPublishAuthorizationSuccessCount
Count
客户端发送 PUBLISH packet时,授权成功的次数。
[ 60s, sum ]
[ 300s, last ]
PUBLISH 授权失败次数
MqttPublishAuthorizationFailureCount
Count
客户端发送 PUBLISH packet时,授权失败的次数。
[ 60s, sum ]
[ 300s, last ]
SUBSCRIBE 授权成功次数
MqttSubscribeAuthorizationSuccessCount
Count
客户端发送 SUBSCRIBE packet时,授权成功的次数。
[ 60s, sum ]
[ 300s, last ]
SUBSCRIBE 授权失败次数
MqttSubscribeAuthorizationFailureCount
Count
客户端发送 SUBSCRIBE packet时,授权失败的次数。
[ 60s, sum ]
[ 300s, last ]
分类
指标中文名
指标英文名
单位
指标含义
统计规则
生产相关指标
生产消息数量
MqttTopicSendMessageCount
Count
当前主题在一个统计周期内的发送消息数量。
[ 60s, sum ]
[ 300s, last ]
生产消息平均大小
MqttPublishAverageBytesInstanceTopic
Bytes
当前主题在一个统计周期内的发送消息平均大小。
[ 60s, sum ]
[ 300s, last ]
生产流量大小
MqttPublishTrafficBytesInstanceTopic
Bytes
当前主题在一个统计周期内的发送消息流量大小。
[ 60s, sum ]
[ 300s, last ]
客户端生产消息错误次数
MqttPublishClientErrorCountInstanceTopic
Count
客户端生产指定消息时产生错误码的总次数。
[ 60s, sum ]
[ 300s, last ]
消费相关指标
消费消息数量
MqttTopicConsumeMessageCount
Count
当前主题在一个统计周期内的消费消息数量。
[ 60s, sum ]
[ 300s, last ]
消费消息平均大小
MqttConsumeAverageBytesInstanceTopic
Bytes
当前主题在一个统计周期内的消费消息平均大小。
[ 60s, sum ]
[ 300s, last ]
消费流量大小
MqttConsumeTrafficBytesInstanceTopic
Bytes
当前主题在一个统计周期内的消费消息流量大小。
[ 60s, sum ]
[ 300s, last ]
客户端消费消息错误次数
MqttConsumeClientErrorCountInstanceTopic
Count
客户端消费指定消息时产生错误码的总次数。
[ 60s, sum ]
[ 300s, last ]
消费重试次数
MqttConsumeRetryCountInstanceTopic
Count
消费失败后自动重试消费的次数变化。
[ 60s, sum ]
[ 300s, last ]

各维度对应参数总览

参数名称
维度名称
维度解释
格式
Instances.N.Dimensions.0.Name
instanceId
MQTT 实例 ID 的维度名称
输入 String 类型维度名称:instanceId
Instances.N.Dimensions.0.Value
instanceId
MQTT 具体实例的 ID
输入实例具体 ID,例如:mqtt-qg44xwvj
Instances.N.Dimensions.2.Name
qos
MQTT 的 QoS 的维度名称
输入 String 类型维度名称:qos
Instances.N.Dimensions.2.Value
qos
MQTT 具体的 QoS
输入具体 qos,例如:mytopic
Instances.N.Dimensions.3.Name
topic
MQTT 的 topic filter 的维度名称
输入 String 类型维度名称:topic
Instances.N.Dimensions.3.Value
topic
MQTT 具体的 topic filter
输入具体 topic filter,例如:mytopic
Instances.N.Dimensions.4.Name
sharegroup
MQTT 的共享订阅组维度名称
输入 String 类型维度名称:sharegroup
Instances.N.Dimensions.4.Value
sharegroup
MQTT 具体的共享订阅组名称
输入具体 group,例如:mygroup

入参说明

查询 QCE/MQTT 监控数据,入参取值如下:
&Namespace = QCE/MQTT
&Instances.N.Dimensions.0.Name = instanceId
&Instances.N.Dimensions.0.Value = 实例 ID
&Instances.N.Dimensions.1.Name = qos
&Instances.N.Dimensions.1.Value = 具体的 QoS
&Instances.N.Dimensions.2.Name = topic
&Instances.N.Dimensions.2.Value = 具体的 topic filter
&Instances.N.Dimensions.3.Name = sharegroup
&Instances.N.Dimensions.3.Value = 具体的共享订阅组名称


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈