Monitoring Metric Description

Last updated:2026-01-27 15:34:19

Monitoring Metric Description

Last updated: 2026-01-27 15:34:19

TDMQ for Apache Pulsar provides a comprehensive, multi-dimensional monitoring metric system, covering dimensions such as clusters, namespaces, and topics and helping you monitor the running status of resources in real time. This document introduces the meanings of various monitoring metrics of TDMQ for Apache Pulsar and the recommended key metrics to focus on. You can use these metrics to quickly master the health status of resources such as instances, and determine whether to perform Ops operations such as specification adjustment to ensure stable operation.
Meaning of Monitoring Metrics
The following table describes all monitoring metrics provided by TDMQ for Apache Pulsar. You can configure monitoring and alarm policies based on your actual business requirements.
Cluster
Namespace
Topic
Category
Metric Name
Unit
Description
Key monitoring metrics
PulsarTenantTps
Count/s
TPS used by the current cluster.
﻿
PulsarTenantTpsUsage
%
TPS usage of the current cluster. The maximum value is used per unit time.
﻿
TenantCaculateRateIn
Count/s
Message production rate calculated with the multiplier.
﻿
TenantCaculateRateOut
Count/s
Message consumption rate calculated with the multiplier.
﻿
PulsarTenantThroughputIn
Bytes/s
Maximum data volume of messages written per second by all producers.
﻿
PulsarTenantThroughputOut
Bytes/s
Maximum data volume of messages read per second by all consumers.
﻿
TenantTagFilterRejectedMsgRate
Count/s
Number of messages discarded per second due to the mismatch with the tag filter in the subscription per unit time.
﻿
TenantTagFilterRejectedBytesRate
Bytes/s
Total data volume of messages discarded per second due to the mismatch with the tag filter in the subscription within a unit time.
﻿
PulsarMessageDelayed
Count
Number of delayed messages in the current cluster.
﻿
PulsarMessageDelayedUsage
%
Usage percentage of delayed messages in the current cluster. The maximum value is used per unit time.
﻿
TenantDelayRateIn
Count/s
Number of delayed messages sent per unit time.
﻿
PulsarClbIntraffic
Mbps
Public network traffic volume for accessing the cluster over the public network.
﻿
PulsarClbIntrafficVipRatio
%
Ratio of the bandwidth occupied by the public network traffic to the total bandwidth.
Cluster storage metrics
TenantStorageSize
Bytes
Tenant-level message backlog size.
﻿
TenantStorageSizeUsedPercentage
%
Percentage of storage used in the current cluster.
Traffic throttling metrics of clusters
TenantInLimitCount
Count
Number of tenant-level write requests per minute due to traffic throttling.
﻿
TenantOutLimitCount
Count
Number of tenant-level consumption requests per minute due to traffic throttling.
Metric Name
Unit
Description
NsCaculateRateIn
Count/s
Number of messages produced per second to the topics under the namespace.
NsCaculateRateOut
Count/s
Number of messages consumed per second from the topics under the namespace.
NsThroughputIn
Bytes/s
Message data volume produced per second to the topics under the namespace.
NsThroughputOut
Bytes/s
Message data volume consumed per second from the topics under the namespace.
NsStorageSize
Bytes
Total disk space occupied by messages of all topics under the namespace.
Metric Name
Unit
Description
PulsarCaculateRateIn
Count/s
Number of messages produced per second to the topic.
PulsarCaculateRateOut
Count/s
Number of messages consumed per second from the topic.
TopicTagFilterRejectedMsgRate
Count/s
Number of messages discarded per second under the topic due to the mismatch with the tag filter.
MsgThroughputIn
Bytes/s
Message data volume produced per second to the topic.
MsgThroughputOut
Bytes/s
Message data volume consumed per second from the topic.
TopicTagFilterRejectedBytesRate
Bytes/s
Message data volume discarded per second under the topic due to the mismatch with the tag filter.
TopicMessageDelayed
Count
Total number of messages currently under delayed delivery and unconsumed messages under the topic.
StorageSize
Bytes
Total disk space occupied by all unconsumed messages under the topic.
TopicDelayRateIn
Bytes/s
Number of messages sent to the topic and set as delayed delivery per second.
ProducersCount
Count
Total number of producer clients currently connected to the topic.
ConsumersCount
Count
Total number of consumer clients currently connected to the topic.
TopicProducerPercentage
%
Percentage of the number of producers used to the maximum number of producers allowed for the topic.
TopicConsumerPercentage
%
Percentage of the number of consumers used to the maximum number of consumers allowed for the topic.
Overview of Parameters in Each Dimension
Parameter Name
Dimension Name
Dimension Description
Description
Instances.N.Dimensions.0.Name
environmentId
Dimension name of environmentId
Enter the dimension name of the string type: environmentId.
Instances.N.Dimensions.0.Value
environmentId
Specific namespace
Enter a specific namespace. Example: default.
It can be obtained by using the DescribeEnvironments API. The field name is EnvironmentId.
Instances.N.Dimensions.0.Name
tenantId
Dimension name of a cluster ID
Enter the dimension name of the string type: tenantId.
Instances.N.Dimensions.0.Value
tenantId
Specific cluster ID
Enter the ID of a specific cluster. Example: pulsar-xxxxxxxxxx.
It can be obtained on the Cluster page in the TDMQ for Apache Pulsar console.
It can also be obtained by using the DescribeClusterDetail API. The field name is ClusterId.
Instances.N.Dimensions.0.Name
topicName
Dimension name of a topic name
Enter the dimension name of the string type: topicName.
Instances.N.Dimensions.0.Value
topicName
Specific topic name
Enter the name of a specific topic. Example: testTopic. 
It can be obtained on theTopic page in the TDMQ for Apache Pulsar console.
Instances.N.Dimensions.0.Name
namespace
Dimension name of the namespace where the cluster resides
Enter the dimension name of the string type: namespace.
Instances.N.Dimensions.0.Value
namespace
Specific namespace
Enter the name of a specific namespace. Example: test.
It can be obtained by using the DescribeEnvironments API. The field name is NamespaceName.
Instances.N.Dimensions.0.Name
tenant
Dimension name of a cluster ID
Enter the dimension name of the string type: tenant.
Instances.N.Dimensions.0.Value
tenant
Specific cluster ID
Enter the ID of a specific cluster. Example: pulsar-xxxxxxxxxx.
It can be obtained by using the DescribeClusterDetail API. The field name is ClusterId.
Instances.N.Dimensions.0.Name
subName
Dimension name of a subscription name
Enter the dimension name of the string type: subName.
Instances.N.Dimensions.0.Value
subName
Subscription name
Enter the subscription name of the string type. You can click a consumer on the Details page of a specific topic and copy the subscription name in the TDMQ for Apache Pulsar console.
Input Parameters
The input parameter values for querying message queue monitoring data are as follows:
Metric type 1:
&Namespace = QCE/TDMQ 
&Instances.N.Dimensions.0.Name = environmentId
&Instances.N.Dimensions.0.Value = Specific namespace
&Instances.N.Dimensions.1.Name = tenantId 
&Instances.N.Dimensions.1.Value = Specific cluster ID 
&Instances.N.Dimensions.2.Name = topicName 
&Instances.N.Dimensions.2.Value = Specific topic name
Metric type 2:
&Namespace = QCE/TDMQ 
&Instances.N.Dimensions.0.Name = tenant 
&Instances.N.Dimensions.0.Value = Specific cluster ID

Was this page helpful?

You can also Contact Sales or Submit a Ticket for help.

Yes

Feedback

Category	Metric Name	Unit	Description
Key monitoring metrics	PulsarTenantTps	Count/s	TPS used by the current cluster.
		PulsarTenantTpsUsage	%	TPS usage of the current cluster. The maximum value is used per unit time.
		TenantCaculateRateIn	Count/s	Message production rate calculated with the multiplier.
		TenantCaculateRateOut	Count/s	Message consumption rate calculated with the multiplier.
		PulsarTenantThroughputIn	Bytes/s	Maximum data volume of messages written per second by all producers.
		PulsarTenantThroughputOut	Bytes/s	Maximum data volume of messages read per second by all consumers.
		TenantTagFilterRejectedMsgRate	Count/s	Number of messages discarded per second due to the mismatch with the tag filter in the subscription per unit time.
		TenantTagFilterRejectedBytesRate	Bytes/s	Total data volume of messages discarded per second due to the mismatch with the tag filter in the subscription within a unit time.
		PulsarMessageDelayed	Count	Number of delayed messages in the current cluster.
		PulsarMessageDelayedUsage	%	Usage percentage of delayed messages in the current cluster. The maximum value is used per unit time.
		TenantDelayRateIn	Count/s	Number of delayed messages sent per unit time.
		PulsarClbIntraffic	Mbps	Public network traffic volume for accessing the cluster over the public network.
		PulsarClbIntrafficVipRatio	%	Ratio of the bandwidth occupied by the public network traffic to the total bandwidth.
Cluster storage metrics	TenantStorageSize	Bytes	Tenant-level message backlog size.
Cluster storage metrics		TenantStorageSizeUsedPercentage	%	Percentage of storage used in the current cluster.
Traffic throttling metrics of clusters	TenantInLimitCount	Count	Number of tenant-level write requests per minute due to traffic throttling.
Traffic throttling metrics of clusters		TenantOutLimitCount	Count	Number of tenant-level consumption requests per minute due to traffic throttling.

Parameter Name	Dimension Name	Dimension Description	Description
Instances.N.Dimensions.0.Name	environmentId	Dimension name of environmentId	Enter the dimension name of the string type: environmentId.
Instances.N.Dimensions.0.Value	environmentId	Specific namespace	Enter a specific namespace. Example: default. It can be obtained by using the DescribeEnvironments API. The field name is EnvironmentId.
Instances.N.Dimensions.0.Name	tenantId	Dimension name of a cluster ID	Enter the dimension name of the string type: tenantId.
Instances.N.Dimensions.0.Value	tenantId	Specific cluster ID	Enter the ID of a specific cluster. Example: pulsar-xxxxxxxxxx. It can be obtained on the Cluster page in the TDMQ for Apache Pulsar console. It can also be obtained by using the DescribeClusterDetail API. The field name is ClusterId.
Instances.N.Dimensions.0.Name	topicName	Dimension name of a topic name	Enter the dimension name of the string type: topicName.
Instances.N.Dimensions.0.Value	topicName	Specific topic name	Enter the name of a specific topic. Example: testTopic. It can be obtained on theTopic page in the TDMQ for Apache Pulsar console.
Instances.N.Dimensions.0.Name	namespace	Dimension name of the namespace where the cluster resides	Enter the dimension name of the string type: namespace.
Instances.N.Dimensions.0.Value	namespace	Specific namespace	Enter the name of a specific namespace. Example: test. It can be obtained by using the DescribeEnvironments API. The field name is NamespaceName.
Instances.N.Dimensions.0.Name	tenant	Dimension name of a cluster ID	Enter the dimension name of the string type: tenant.
Instances.N.Dimensions.0.Value	tenant	Specific cluster ID	Enter the ID of a specific cluster. Example: pulsar-xxxxxxxxxx. It can be obtained by using the DescribeClusterDetail API. The field name is ClusterId.
Instances.N.Dimensions.0.Name	subName	Dimension name of a subscription name	Enter the dimension name of the string type: subName.
Instances.N.Dimensions.0.Value	subName	Subscription name	Enter the subscription name of the string type. You can click a consumer on the Details page of a specific topic and copy the subscription name in the TDMQ for Apache Pulsar console.

tencent cloud

Meaning of Monitoring Metrics

Overview of Parameters in Each Dimension

Input Parameters