This article describes how to create, delete, and search for a group in the Message Queue for Apache RocketMQ console.

Background information

A group is a type of producers or consumers that produce or consume messages of the same type and publish or subscribe to messages based on the same logic. To use Message Queue for Apache RocketMQ for messaging, you must create groups to identify producers or consumers of the same type.

Usage notes

  • Each group ID in an instance must be unique. Groups in different instances can share the same ID.
  • A group ID must start with GID_ or GID- and must be 7 to 64 characters in length. It can contain only letters, digits, hyphens (-), and underscores (_).
  • A group ID is required for consumers but is optional for producers.

Create a group

  1. Log on to the Message Queue for Apache RocketMQ console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region, such as China (Hangzhou).
  4. On the Instances page, click the name of the instance that you want to manage. The Instance Details page appears.
  5. In the left-side navigation pane, click Groups.
  6. On the Groups page, select a protocol for client SDKs and click Create Group.
    Message Queue for Apache RocketMQ supports TCP and HTTP for client SDKs.
    Notice Once specified, clients must use SDKs over the specific protocol to send or receive messages. For example, if you select TCP for a group, the clients that are identified by the group ID cannot use SDKs over HTTP to send or receive messages.
  7. In the panel that appears, set the Group ID and Description parameters and click OK.Create a group
    On the Groups page, you can view the group that you have created.

Delete a group

Notice After you delete a group ID, the consumers that are identified by the group ID stop receiving messages. Resources in the group are also deleted and cannot be restored. Exercise caution when you perform this operation.
  1. Log on to the Message Queue for Apache RocketMQ console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region, such as China (Hangzhou).
  4. On the Instances page, click the name of the instance that you want to manage. The Instance Details page appears.
  5. In the left-side navigation pane, click Groups.
  6. On the Groups page, find the group that you want to delete, click More in the Actions column, and then select Delete from the drop-down list.
  7. In the message that appears, click OK.
    On the Groups page, you can no longer view the instance that you have deleted.

Search for a group

  1. Log on to the Message Queue for Apache RocketMQ console.
  2. In the left-side navigation pane, click Instances.
  3. In the top navigation bar, select a region, such as China (Hangzhou).
  4. On the Instances page, click the name of the instance that you want to manage. The Instance Details page appears.
  5. In the left-side navigation pane, click Groups.
  6. On the Groups page, find the group that you want to view and click the group ID or click Details in the Actions column. The Group Details page appears.
    On the Group Details page, you can view the details of the group.

Perform other operations

On the Groups page, you can perform other related operations.

  1. In the left-side navigation pane, click Groups.
  2. On the Groups page, find the group that you want to manage, click More in the Actions column, and then select one of the following options from the drop-down list:
  • Quick Access: View the references that Message Queue for Apache RocketMQ provides for SDKs for multiple programming languages.
  • Reset Consumer Offset: Reset consumer offsets to skip the accumulated or undesired messages and restart consumption. You can also consume messages after a specified point in time regardless of whether the messages before this point in time have been consumed. For more information, see Reset consumer offsets.
  • Cloud Monitor: View the monitoring data of message production or consumption in the group.
  • Message Consumption Chart: View the total number of consumed messages in the group. You can also view the transactions per second (TPS) of message consumption.

References

You can call the following API operations to manage groups: