tencent cloud


Group Management

Last updated: 2023-05-16 11:13:47


    A group is used to identify a type of consumers, which usually consume the same type of messages and use the same message subscription logic.
    This document describes how to create, delete, and query a queue in the TDMQ for RocketMQ console.


    You have created a namespace.
    You have created a message producer and consumer based on the SDK provided by TDMQ, and they run properly.


    Creating a group

    1. Log in to the TDMQ console, select the region, and click the ID of the target cluster to enter the cluster's basic information page.
    2. Click the Group tab at the top, select a namespace, and click Create to enter the Create Group page.
    3. Enter the group information.
    Group Name: enter the group name, which cannot be modified after creation and can contain 3–64 letters, digits, hyphens, and underscores.
    Protocol Type: HTTP and TCP are supported.
    Group Remarks: enter the group remarks.
    4. Click Submit.
    In order to ensure the stability of the online cluster and avoid metadata redundancy in the console, TDMQ for RocketMQ has disabled the configuration of automatic group creation at the end of February 2023. When starting the consumer client, you need to create the corresponding group in the console first.

    Viewing consumer details

    1. In the group list, click Consumer Details in the Operation column to enter the subscription list.
    2. After expanding the list, you can view the group's basic information, client addresses, and subscriptions.
    Basic info
    Consumption Mode: cluster mode or broadcast mode.
    Cluster consumption: if the cluster consumption mode is used, any message only needs to be processed by any consumer in the cluster.
    Broadcast consumption: if the broadcast consumption mode is used, each message will be pushed to all registered consumers in the cluster to ensure that the message is consumed by each consumer at least once.
    Client Protocol: TCP and HTTP are supported.
    Message Retention: total number of retained messages.
    Consumer Type: ACTIVELY or PASSIVELY.
    Client Address: The list of connected clients. Click View Details in the Operation column of the client to view consumer details.
    Subscription: The list of topics subscribed to by this group and the subscription attribute.

    Setting an offset

    1. In the group list, click Reset offset in the Operation column of the target group.
    2. In the pop-up window, you can choose the latest offset or the specified time point to set the topic's consumption offset (that is, specify from where the consumers under the subscription start to consume messages).
    3. Click Submit.
    TDMQ for RocketMQ supports resetting the consumption offset for offline groups only in the push consumption mode; otherwise, the reset will fail.

    Editing a group

    1. In the group list, click Edit in the Operation column of the target group.
    2. In the pop-up window, edit the group information.
    3. Click Submit.

    Deleting a group

    Batch deletion: In the group list, select all the groups that need to be deleted, and click Batch Delete in the upper left corner. Then, in the pop-up window, click Submit to complete the deletion.
    Single deletion: In the group list, find the group that needs to be deleted, and click Delete in the Operation column. Then, in the pop-up window, click Submit to complete the deletion.
    After a group is deleted, consumers identified by the group will immediately stop receiving messages, and all the configurations under it will be cleared and cannot be recovered; therefore, caution should be exercised with this operation.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support