Monitoring Metric Description
Last updated:2026-01-30 14:55:29
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 resource running state. 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 operational tasks are required to ensure stable operation.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 resource running state. 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 operational tasks are required to ensure stable operation.
Monitoring MetricsMonitoring Metrics
The following is the description of all monitoring metrics provided by MQTT. Please configure monitoring and alarm policies properly based on actual business needs:The following is the description of all monitoring metrics provided by MQTT. Please configure monitoring and alarm policies properly based on actual business needs:
Category | Metric Name | Unit | Metric Description | Statistical Method |
Cluster Specification Metrics | Message Throughput Workload | % | The message sending and receiving load of the current cluster = current minute-level peak TPS / cluster peak TPS * 100%, and TPS is calculated according to the billing overview. | [ 60s, sum ] [ 300s, last ] |
| Connection Load | % | Connection load of the current cluster = current number of online connections / connection specifications * 100%. | [ 60s, sum ] [ 300s, last ] |
| Total TPS | Count | The current cluster's minute-level peak TPS (sum of production and consumption, calculated according to the billing overview) will be throttled when exceeding the cluster limit. | [ 60s, sum ] [ 300s, last ] |
Public Network Metrics | Public Network Outbound Traffic | MB | Changes in public network traffic from MQTT clusters. Public network costs are calculated based on this metric. | [ 60s, sum ] [ 300s, last ] |
| Public Network Inbound Traffic | MB | Client requests public network traffic changes for the MQTT cluster. | [ 60s, sum ] [ 300s, last ] |
| Public Network Outbound Bandwidth | Mbps | Public network bandwidth changes for outbound traffic from MQTT clusters. | [ 60s, sum ] [ 300s, last ] |
| Public Network Inbound Bandwidth | Mbps | Client requests public network bandwidth changes for the MQTT cluster. | [ 60s, sum ] [ 300s, last ] |
| Public Network Dropped Outbound Bandwidth | Bit/s | value generated when public network bandwidth is limited. If the value is above 0, increase the Bandwidth Limit for the large cluster. | [ 60s, sum ] [ 300s, last ] |
| Dropped Inbound Public Network Bandwidth | Bit/s | value generated when public network bandwidth is limited. If the value is above 0, increase the Bandwidth Limit for the large cluster. | [ 60s, sum ] [ 300s, last ] |
| Public Network Outbound Bandwidth Utilization | % | Bandwidth utilization when an MQTT cluster connects clients via the public network equals current outbound bandwidth / public network bandwidth setting * 100%. | [ 60s, sum ] [ 300s, last ] |
| Public Network Inbound Bandwidth Utilization | % | Bandwidth utilization when clients connect to an MQTT cluster via the public network equals current inbound bandwidth / public network bandwidth setting * 100%. | [ 60s, sum ] [ 300s, last ] |
| Public Network New Connections | Count/s | Number of new connections per minute when clients connect to the MQTT cluster via the public network. | [ 60s, sum ] [ 300s, last ] |
| Public Network Active Connections | Count | Number of active connections when clients connect to the MQTT cluster via the public network. | [ 60s, sum ] [ 300s, last ] |
| Public Network Inactive Connections | Count | Number of inactive connections when clients connect to the MQTT cluster via the public network. | [ 60s, sum ] [ 300s, last ] |
| Public Network Concurrent Connections | Count | Number of concurrent connections when clients connect to the MQTT cluster via the public network. | [ 60s, sum ] [ 300s, last ] |
| Public Network Outbound Packets | Count/s | Client requests outbound packets adjustment for the MQTT cluster. | [ 60s, sum ] [ 300s, last ] |
| Public Network Inbound Packets | Count/s | Client requests inbound packet volume transition for 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 | Total number of received CONNECT Packets on the server side. | [ 60s, sum ] [ 300s, last ] |
| CONNACK Packets | Count | Total number of CONNACK Packets emitted by the server | [ 60s, sum ] [ 300s, last ] |
| Successful Connections | Count | Change in the number of successfully connected CONNECT Packets. | [ 60s, sum ] [ 300s, last ] |
| Throttling Count for CONNECT packets | Count | The change in the number of CONNECT Packets that failed to connect due to flow control mechanisms can be avoided by adjusting the cluster specifications to prevent throttling. | [ 60s, sum ] [ 300s, last ] |
| Failed Connections | Count | Change in the number of failed CONNECT Packets. | [ 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 emitted 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 emitted by the server | [ 60s, sum ] [ 300s, last ] |
Production Metrics | Published Messages | Count | Current theme message count in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Throttled PUBLISH Packets | Count | The number of PUBLISH Packets throttled after the cluster specification limitation is exceeded can be avoided by adjusting the cluster specification to prevent throttling. | [ 60s, sum ] [ 300s, last ] |
| Average Produced Message Size | Bytes | Average message size of the current theme in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Produce Throughput | Bytes | Message traffic size of the current theme in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Client Produce Errors | Count | Total number of error codes generated when the client produces a specified message. | [ 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 emitted 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 emitted 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 emitted 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 emitted 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 emitted by the server. | [ 60s, sum ] [ 300s, last ] |
Consumption Metrics | Consumed Messages | Count | Current theme message consumption count in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Average Consumed Message Size | Bytes | Average message size consumed by the current theme in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Consume Throughput | Bytes | Message traffic size consumed by the current theme in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Client Consume Errors | Count | Total number of error codes generated when the client consumes a specified message. | [ 60s, sum ] [ 300s, last ] |
| Consume Retry | Count | 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 throttled SUBSCRIBE Packets when the cluster specification limits are exceeded. You can scale up the cluster specifications to avoid throttling issues. | [ 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 the client sends a CONNECT packet. | [ 60s, sum ] [ 300s, last ] |
| Failed CONNECT Authorizations | Count | Number of failed authorizations when the client sends a CONNECT packet. | [ 60s, sum ] [ 300s, last ] |
| Successful PUBLISH Authorizations | Count | Number of successful authorizations when the client sends a PUBLISH packet. | [ 60s, sum ] [ 300s, last ] |
| Failed PUBLISH Authorizations | Count | Number of failed authorizations when the client sends a PUBLISH packet. | [ 60s, sum ] [ 300s, last ] |
| Successful SUBSCRIBE Authorizations | Count | Number of successful authorizations when the client sends a SUBSCRIBE packet. | [ 60s, sum ] [ 300s, last ] |
| Failed SUBSCRIBE Authorizations | Count | Number of failed authorizations when the client sends a SUBSCRIBE packet. | [ 60s, sum ] [ 300s, last ] |
Category | Metric Name | Unit | Metric Description | Statistical Method |
Production Metrics | Published Messages | Count | Current theme message count in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Average Produced Message Size | Bytes | Average message size of the current theme in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Produce Throughput | Bytes | Message traffic size of the current theme in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Client Produce Errors | Count | Total number of error codes generated when the client produces a specified message. | [ 60s, sum ] [ 300s, last ] |
Consumption Metrics | Consumed Messages | Count | Current theme message consumption count in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Average Consumed Message Size | Bytes | Average message size consumed by the current theme in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Consume Throughput | Bytes | Message traffic size consumed by the current theme in a statistical period. | [ 60s, sum ] [ 300s, last ] |
| Client Consume Errors | Count | Total number of error codes generated when the client consumes a specified message. | [ 60s, sum ] [ 300s, last ] |
| Consume Retry | Count | Number of automatic retries after consumption fails. | [ 60s, sum ] [ 300s, last ] |
Overview of Parameters Corresponding to Each DimensionOverview of Parameters Corresponding to Each Dimension
Parameter NameParameter Name | Dimension NameDimension Name | Dimensional InterpretationDimensional Interpretation | FormatFormat |
Instances.N.Dimensions.0.NameInstances.N.Dimensions.0.Name | instanceIdinstanceId | MQTT Instance ID Dimension NameMQTT Instance ID Dimension Name | Enter the dimension name of String type: instanceIdEnter the dimension name of String type: instanceId |
Instances.N.Dimensions.0.ValueInstances.N.Dimensions.0.Value | instanceIdinstanceId | MQTT instance IDMQTT instance ID | Enter the specific instance ID, for example: mqtt-qg44xwvjEnter the specific instance ID, for example: mqtt-qg44xwvj |
Instances.N.Dimensions.2.NameInstances.N.Dimensions.2.Name | qosqos | MQTT QoS Dimension NameMQTT QoS Dimension Name | Enter the dimension name of String type: qosEnter the dimension name of String type: qos |
Instances.N.Dimensions.2.ValueInstances.N.Dimensions.2.Value | qosqos | MQTT QoSMQTT QoS | Enter specific qos, for example: mytopic Enter specific qos, for example: mytopic |
Instances.N.Dimensions.3.NameInstances.N.Dimensions.3.Name | topictopic | MQTT topic filter Dimension NameMQTT topic filter Dimension Name | Enter the dimension name of String type: topic Enter the dimension name of String type: topic |
Instances.N.Dimensions.3.ValueInstances.N.Dimensions.3.Value | topictopic | MQTT topic filterMQTT topic filter | Enter specific topic filter, for example: mytopic Enter specific topic filter, for example: mytopic |
Instances.N.Dimensions.4.NameInstances.N.Dimensions.4.Name | sharegroupsharegroup | MQTT Shared Subscription Group Dimension NameMQTT Shared Subscription Group Dimension Name | Enter the dimension name of String type: sharegroup Enter the dimension name of String type: sharegroup |
Instances.N.Dimensions.4.ValueInstances.N.Dimensions.4.Value | sharegroupsharegroup | MQTT shared subscription group nameMQTT shared subscription group name | Enter specific group, for example: mygroup Enter specific group, for example: mygroup |
Input ParametersInput Parameters
To query QCE/MQTT monitoring metrics, input parameters are as follows:To query QCE/MQTT monitoring metrics, input parameters are as follows:
&Namespace = QCE/MQTT&Namespace = QCE/MQTT
&Instances.N.Dimensions.0.Name = instanceId&Instances.N.Dimensions.0.Name = instanceId
&Instances.N.Dimensions.0.Value = Instance ID&Instances.N.Dimensions.0.Value = Instance ID
&Instances.N.Dimensions.1.Name = qos&Instances.N.Dimensions.1.Name = qos
&Instances.N.Dimensions.1.Value = Specific QoS&Instances.N.Dimensions.1.Value = Specific QoS
&Instances.N.Dimensions.2.Name = topic&Instances.N.Dimensions.2.Name = topic
&Instances.N.Dimensions.2.Value = Specific topic filter&Instances.N.Dimensions.2.Value = Specific topic filter
&Instances.N.Dimensions.3.Name = sharegroup&Instances.N.Dimensions.3.Name = sharegroup
&Instances.N.Dimensions.3.Value = Specific subscription group name&Instances.N.Dimensions.3.Value = Specific subscription group name
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback