tencent cloud

TDMQ for MQTT

Monitoring Metric Description

PDF
Focus Mode
Font Size
Last updated: 2026-04-01 16:30:55
TDMQ for MQTT provides a comprehensive, multidimensional monitoring metrics system, covering public network, connection, production consumption, authentication and authorization, and other dimensions. It helps you gain real-time insights into the running status of resources. This document describes the monitoring metrics of MQTT. Through these metrics, you can quickly grasp the health status of resources and determine whether scaling or other actions are required to maintain stability.

Monitoring Metrics

The following table describes all monitoring metrics provided by MQTT. You can configure monitoring and alarm policies based on your actual business requirements.
Cluster
Topic
Category
Metric Name
Unit
Metric Description
Statistical Rule
Cluster Specification Metrics
Message Throughput Workload
%
Message throughput workload of the current cluster = Current minute-level peak TPS/Cluster peak TPS x 100%. TPS is calculated according to Billing Overview.
[ 60s, sum ]
[ 300s, last ]
Connection Load
%
Connection load of the current cluster = Current number of online connections/Connection specifications x 100%.
[ 60s, sum ]
[ 300s, last ]
Total TPS
Count
Minute-level peak TPS of the current cluster is calculated based on the sum of production and consumption according to Billing Overview, and is throttled if it exceeds the cluster limit.
[ 60s, sum ]
[ 300s, last ]
Public Network Metrics
Public Network Outbound Traffic
MB
Change in the public network traffic due to the MQTT cluster outflow traffic. Public network fees are calculated based on this metric.
[ 60s, sum ]
[ 300s, last ]
Public Network Inbound Traffic
MB
Change in the public network traffic due to client requests to the MQTT cluster.
[ 60s, sum ]
[ 300s, last ]
Public Network Outbound Bandwidth
Mbps
Change in the public network bandwidth due to the MQTT cluster outflow traffic.
[ 60s, sum ]
[ 300s, last ]
Public Network Inbound Bandwidth
Mbps
Change in the public network bandwidth due to client requests to the MQTT cluster.
[ 60s, sum ]
[ 300s, last ]
Public Network Dropped Outbound Bandwidth
Bit/s
A value is generated when the public network bandwidth is limited. If it is greater than 0, raise the public network bandwidth limit of the cluster.
[ 60s, sum ]
[ 300s, last ]
Dropped Inbound Public Network Bandwidth
Bit/s
A value is generated when the public network bandwidth is limited. If it is greater than 0, raise the public network bandwidth limit of the cluster.
[ 60s, sum ]
[ 300s, last ]
Public Network Outbound Bandwidth Utilization
%
Bandwidth utilization of the MQTT cluster connecting to clients over the public network = Current outbound bandwidth/Public network bandwidth configured for the cluster x 100%.
[ 60s, sum ]
[ 300s, last ]
Public Network Inbound Bandwidth Utilization
%
Bandwidth utilization of clients connecting to the MQTT cluster over the public network = Current inbound bandwidth/Public network bandwidth configured for the cluster x 100%.
[ 60s, sum ]
[ 300s, last ]
Public Network New Connections
Count/s
Number of new connections per minute when clients connect to the MQTT cluster over the public network.
[ 60s, sum ]
[ 300s, last ]
Public Network Active Connections
Count
Number of active connections when clients connect to the MQTT cluster over the public network.
[ 60s, sum ]
[ 300s, last ]
Public Network Inactive Connections
Count
Number of inactive connections when clients connect to the MQTT cluster over the public network.
[ 60s, sum ]
[ 300s, last ]
Public Network Concurrent Connections
Count
Number of concurrent connections when clients connect to the MQTT cluster over the public network.
[ 60s, sum ]
[ 300s, last ]
Public Network Outbound Packets
Count/s
Change in the public network outbound packet volume due to client requests to the MQTT cluster.
[ 60s, sum ]
[ 300s, last ]
Public Network Inbound Packets
Count/s
Change in the public network inbound packet volume due to client requests to the MQTT cluster.
[ 60s, sum ]
[ 300s, last ]
Connection Metrics
Online Clients
Count
Number of client connections established in the current cluster.
[ 60s, sum ]
[ 300s, last ]
CONNECT Packets
Count
Change in the total number of CONNECT packets received by the server.
[ 60s, sum ]
[ 300s, last ]
CONNACK Packets
Count
Change in the total number of CONNACK packets sent by the server.
[ 60s, sum ]
[ 300s, last ]
Successful Connections
Count
Change in the number of CONNECT packets that successfully created a new connection.
[ 60s, sum ]
[ 300s, last ]
Throttling Count for CONNECT packets
Count
Change in the number of CONNECT packets that failed to create a connection due to the traffic throttling mode. You can adjust the cluster specifications to avoid throttling.
[ 60s, sum ]
[ 300s, last ]
Failed Connections
Count
Change in the number of CONNECT packets that failed to create a connection.
[ 60s, sum ]
[ 300s, last ]
DISCONNECT Packets IN
Count
Change in the total number of DISCONNECT packets received by the server.
[ 60s, sum ]
[ 300s, last ]
DISCONNECT Packets OUT
Count
Change in the total number of DISCONNECT packets sent by the server.
[ 60s, sum ]
[ 300s, last ]
PINGREQ Packets
Count
Number of PINGREQ packets received by the server.
[ 60s, sum ]
[ 300s, last ]
PINGRESP Packets
Count
Number of PINGRESP packets sent by the server
[ 60s, sum ]
[ 300s, last ]
Production Metrics
Published Messages
Count
Number of messages published by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Throttled PUBLISH Packets
Count
Number of PUBLISH packets throttled after the cluster limit is exceeded. You can adjust the cluster specifications to avoid throttling.
[ 60s, sum ]
[ 300s, last ]
Average Produced Message Size
Bytes
Average size of messages published by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Produce Throughput
Bytes
Throughput of messages published by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Client Produce Errors
Count
Total number of error codes generated when clients publish specific messages.
[ 60s, sum ]
[ 300s, last ]
PUBLISH Packets IN
Count
Number of PUBLISH packets received by the server.
[ 60s, sum ]
[ 300s, last ]
PUBLISH Packets OUT
Count
Number of PUBLISH packets sent by the server.
[ 60s, sum ]
[ 300s, last ]
PUBACK Packets IN
Count
Number of PUBACK packets received by the server.
[ 60s, sum ]
[ 300s, last ]
PUBACK Packets OUT
Count
Number of PUBACK packets sent by the server.
[ 60s, sum ]
[ 300s, last ]
PUBREC Packets IN
Count
Number of PUBREC packets received by the server.
[ 60s, sum ]
[ 300s, last ]
PUBREC Packets OUT
Count
Number of PUBREC packets sent by the server.
[ 60s, sum ]
[ 300s, last ]
PUBREL Packets IN
Count
Number of PUBREL packets received by the server.
[ 60s, sum ]
[ 300s, last ]
PUBREL Packets OUT
Count
Number of PUBREL packets sent by the server.
[ 60s, sum ]
[ 300s, last ]
PUBCOMP Packets IN
Count
Number of PUBCOMP packets received by the server.
[ 60s, sum ]
[ 300s, last ]
PUBCOMP Packets OUT
Count
Number of PUBCOMP packets sent by the server.
[ 60s, sum ]
[ 300s, last ]
Consumption Metrics
Consumed Messages
Count
Number of messages consumed by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Average Consumed Message Size
Bytes
Average size of messages consumed by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Consume Throughput
Bytes
Throughput of messages consumed by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Client Consume Errors
Count
Total number of error codes generated when clients consume specific messages.
[ 60s, sum ]
[ 300s, last ]
Consume Retry
Count
Change in the number of automatic retries after consumption fails.
[ 60s, sum ]
[ 300s, last ]
Online subscriptions
Count
Number of client subscriptions established in the current cluster.
[ 60s, sum ]
[ 300s, last ]
SUBSCRIBE Packets
Count
Number of SUBSCRIBE packets received by the server.
[ 60s, sum ]
[ 300s, last ]
Throttled SUBSCRIBE Packets
Count
Number of SUBSCRIBE packets throttled after the cluster limit is exceeded. You can adjust the cluster specifications to avoid throttling.
[ 60s, sum ]
[ 300s, last ]
UNSUBSCRIBE Packets
Count
Number of UNSUBSCRIBE packets received by the server.
[ 60s, sum ]
[ 300s, last ]
Unconsumed Messages in Shared Subscription
Count
Total number of unconsumed messages for a specific ShareName. For details, see Configuring Shared Subscription.
[ 60s, sum ]
[ 300s, last ]
Authentication and Authorization Metrics
Successful Authentications
Count
Number of successful client authentications in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Failed Authentications
Count
Number of failed client authentications in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Successful Authorizations
Count
Number of successful ACL authorizations in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Failed Authorizations
Count
Number of failed ACL authorizations in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Successful CONNECT Authorizations
Count
Number of successful authorizations when clients send CONNECT packets.
[ 60s, sum ]
[ 300s, last ]
Failed CONNECT Authorizations
Count
Number of failed authorizations when clients send CONNECT packets.
[ 60s, sum ]
[ 300s, last ]
Successful PUBLISH Authorizations
Count
Number of successful authorizations when clients send PUBLISH packets.
[ 60s, sum ]
[ 300s, last ]
Failed PUBLISH Authorizations
Count
Number of failed authorizations when clients send PUBLISH packets.
[ 60s, sum ]
[ 300s, last ]
Successful SUBSCRIBE Authorizations
Count
Number of successful authorizations when clients send SUBSCRIBE packets.
[ 60s, sum ]
[ 300s, last ]
Failed SUBSCRIBE Authorizations
Count
Number of failed authorizations when clients send SUBSCRIBE packets.
[ 60s, sum ]
[ 300s, last ]
Category
Metric Name
Unit
Metric Description
Statistical Rule
Production Metrics
Published Messages
Count
Number of messages published by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Average Produced Message Size
Bytes
Average size of messages published by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Produce Throughput
Bytes
Throughput of messages published by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Client Produce Errors
Count
Total number of error codes generated when clients publish specific messages.
[ 60s, sum ]
[ 300s, last ]
Consumption Metrics
Consumed Messages
Count
Number of messages consumed by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Average Consumed Message Size
Bytes
Average size of messages consumed by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Consume Throughput
Bytes
Throughput of messages consumed by the current topic in a statistical period.
[ 60s, sum ]
[ 300s, last ]
Client Consume Errors
Count
Total number of error codes generated when clients consume specific messages.
[ 60s, sum ]
[ 300s, last ]
Consume Retry
Count
Change in the number of automatic retries after consumption fails.
[ 60s, sum ]
[ 300s, last ]

Overview of Parameters Corresponding to Each Dimension

Parameter Name
Dimension Name
Dimension Description
Format
Instances.N.Dimensions.0.Name
instanceId
Dimension name of the MQTT instance ID
Enter the dimension name of the string type: instanceId.
Instances.N.Dimensions.0.Value
instanceId
MQTT instance ID
Enter the specific instance ID, for example, mqtt-qg44xwvj.
Instances.N.Dimensions.2.Name
qos
Dimension name of the MQTT QoS
Enter the dimension name of the string type: qos.
Instances.N.Dimensions.2.Value
qos
MQTT QoS
Enter the specific QoS, for example, mytopic.
Instances.N.Dimensions.3.Name
topic
Dimension name of the MQTT topic filter
Enter the dimension name of the string type: topic.
Instances.N.Dimensions.3.Value
topic
MQTT topic filter
Enter the specific topic filter, for example, mytopic.
Instances.N.Dimensions.4.Name
sharegroup
Dimension name of the MQTT shared subscription group
Enter the dimension name of the string type: sharegroup.
Instances.N.Dimensions.4.Value
sharegroup
MQTT shared subscription group name
Enter the specific group, for example, mygroup.

Description of Input Parameters

The input parameter values for querying QCE/MQTT monitoring data are as follows:
&Namespace = QCE/MQTT
&Instances.N.Dimensions.0.Name = instanceId
&Instances.N.Dimensions.0.Value = Instance ID
&Instances.N.Dimensions.1.Name = qos
&Instances.N.Dimensions.1.Value = Specific QoS
&Instances.N.Dimensions.2.Name = topic
&Instances.N.Dimensions.2.Value = Specific topic filter
&Instances.N.Dimensions.3.Name = sharegroup
&Instances.N.Dimensions.3.Value = Specific shared subscription group name


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback