Creating a Cluster
Last updated: 2025-07-23 11:08:47
Operation Scenarios
Cluster is a form of resource dimension of TDMQ for RocketMQ, where resources in disparate clusters are fully isolated, such as Topic, Group, and etc. Each cluster adheres to specific resource constraints, such as a cap on the number of Topic and the duration of message retention. Typically, specialized clusters are designated for individual environments such as development, testing, and production.
Steps
Create a cluster
1. Log in to the RocketMQ console and go to the Cluster page.
2. On the Cluster page, select the region and click Create Cluster to enter to the purchase page, where you can configure the relevant information.
Parameter | Required or Not | Description |
Cluster Version | Yes | Select 5.x. |
Billing Mode | Yes | The 5.x architecture cluster currently supports two billing modes: pay-as-you-go and monthly subscription. |
Region | Yes | Select the region that is closest to your operations. Tencent Cloud products in various regions are unable to intercommunicate via the private network, and the region selection cannot be altered after purchasing. For instance, CVMs in the Guangzhou region cannot access clusters to the Shanghai region via the private network. In circumstances of required inter-regional private network communication, please refer to Peering Connections. |
Deployment Mode | Yes | Supports single-AZ deployment and multi-AZ deployment in two ways. For multi-AZ deployment, you can select Two Availability Zones to deploy. |
Cluster Specification | Yes | The following editions are currently supported: Basic, Pro, and Platinum. These differing cluster types exhibit variants in both performance, specifications, and functions. For more details, please refer to Product Series. Basic Edition: It is designed for customers with moderate scale, providing basic capabilities such as message sending and receiving that are compatible with the open source RocketMQ community. Pro Edition: It is designed for enterprise-level clients with larger business scale, but have no specific requirements for the physical resources isolation. It supports the sharing underlying resources, with the highest available TPS specification reaching up to 150,000 TPS. Platinum Edition: It is designed for large corporates and large-scale business scenarios that need physical resource separation. This is the only specification type possessing the underlying resources. It offers the broadest TPS specification span, up to a maximum of a million TPS. |
TPS Specification | Yes | TPS Specification contains the entire sum of message production and message consumption. Messages are measured in units of 4KB each, with special message types converted at specific proportions. For detailed rules, please refer to Billing Overview. Basic Edition: Supports Pro Edition: Supports a range between 4,000 to 150,000 TPS. Platinum Edition: Supports a range between 6,000 to 1,000,000 TPS. |
number of topics | Yes | Each cluster specification provides a certain free quota of topics. Buying extra topics incurs charges. For details, see Billing Overview. |
Group count | Yes | The default ratio of topics to groups is 1:10. Group quota is not billed. You can adjust it by modifying the number of topics. |
Message Retention Time | Yes | The message retention time ranges from 24 to 72 hours. Regardless of whether the message has been consumed, it will be deleted after exceeding the retention time. |
Virtual Private Cloud (VPC) | Yes | Authorize domain binding of the newly purchased cluster's access point to the Virtual Private Cloud (VPC). |
Public Network Access | No | Activating the public network bandwidth will incur additional fees. Once activated, it can be disabled via the cluster management page. For more details, please refer to Public Network Fee Description. |
Cluster Name | Yes | Enter the cluster name with 3-64 characters long, and can only contain numbers, letters, "-" and "_". |
Tag | No | Tags are used for the classified management of resources from various dimensions. For detailed usage, please refer to Managing Resources Using Tags. |
Terms and Conditions | Yes | Tick the box to confirm that you have read and accepted the <TDMQF OR ROCKETMQ SERVICE LEVEL AGREEMENT>. |
Parameter | Required or Not | Description |
Cluster Version | Yes | Select 4.x. |
Cluster type | Yes | Exclusive cluster: exclusive physical resources, data security, almost unlimited usage. Purchase freely on-demand by node specification. Generic cluster: exclusive physical resources, data security, almost unlimited usage. Sold by TPS range with fixed node specification. |
Billing Mode | Yes | Currently only supports monthly subscription - prepaid billing mode. |
Migrate to the cloud component | No | Since the cluster for adaptation and migration to the cloud requires a separate migration component, you need to purchase a dedicated 4.x cluster that supports seamless migration. You can toggle on the migrate to the cloud component switch when purchasing the dedicated cluster. Once selected, the cluster will install individual components to support seamless migration of self-built clusters to the cloud. RocketMQ 4.x generic clusters and the full 5.x series are not affected by the migration component and can directly use your previously purchased corresponding clusters. |
Region | Yes | Select the region closest to your business. Cloud products in different regions are not interconnected via private network, and the region cannot be changed after purchase. Please select carefully. For example, a CVM in the Guangzhou region cannot access a cluster in the Shanghai region via private network. If you need cross-region private network communication, for details, see Peering Connection. |
Deployment Mode | Yes | Supports two methods: single-AZ deployment and multi-AZ deployment. For multi-AZ deployment, you can select 2-3 AZs to perform deployment. |
Cluster Specifications | Yes | Select the appropriate cluster specifications based on your business needs. Exclusive clusters are sold by different node specifications, while generic clusters are sold by TPS range with fixed node specifications. |
Number of topics | Yes | Each cluster specification provides a certain free quota of topics. Buying extra topics incurs charges. |
Group count | Yes | The default ratio of Topic to Group is 1:10. Group quota is not billed. You can modify the number of topics to adjust it. |
Virtual Private Cloud (VPC) | Yes | Authorize binding the newly purchased cluster access point domain name to the VPC. |
public network access | No | Enabling public network bandwidth will incur an extra fee. Once activated, you can disable it on the Cluster Management page. |
Cluster Name | Yes | Enter cluster name, 3-64 characters, only comprised of digits, letters, "-", and "_". |
Tag | No | Tag is used to manage resources by category from different dimensions. For how to use, please see Tag Management. |
agreement term | Yes | Check "I have read and agree to the TDMQ for RocketMQ terms of service". |
3. Click Buy Now, wait for 3-5 minutes, and the cluster creation will be accomplished.
View cluster details
On the Cluster page, click the cluster ID to enter to its details page. In that page, you can inquire the following information:
Basic information of the cluster (cluster name/ID, region, creation time, description, and resource tag).
Cluster data statistics: Show the current cluster's send and receive TPS peak cap, message backlog, message storage space, messages produced per second, and messages consumed per second.
Access information: Displays the access point information of both private and public networks.
Cluster overview: Displays the quantities of various resources in the current cluster, the usage of resource quota, and the distribution of message types, and etc.
Top cluster resource consumption: Show the ranking of Groups and Topics occupying main resources in the current cluster, including message backlog of Groups, production/consumption rate of Topics, storage space occupied by Topics, production traffic throttling of Topics, and consumption throttling of Groups.
Notes:
Note: Top data collection and ranking for resource consumption have minute-level data latency. Therefore, the Top data shown is for reference only. For accurate rates and aggregated data, refer to the monitoring display.
Adjusting Message Retention Time
5.x Basic Version/Professional Edition and 4.x Dedicated Cluster/Generic Cluster allow users to modify the message retention time based on storage usage metrics and business peak situation after creation completion. On the cluster list page, click Edit and adjust the message retention period on the Cluster Information Editing Page.
5.x Professional Edition/Platinum Edition clusters support setting retention time at Topic granularity. For specific operations, refer to Topic Management.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback