ApsaraMQ for RocketMQ:Manage groups

Limits

• Up to 1,000 groups per instance. Reuse or delete unused groups to stay within the limit. To increase this quota, contact ApsaraMQ for RocketMQ technical support.

• A group cannot be used across instances.

• ApsaraMQ for RocketMQ supports HTTP and TCP protocols for message consumption. Different groups can use different protocols, but all consumers within the same group should use the same protocol.

  • Mixed protocols within a group may cause consumption failures, message duplication, or message loss.

  • Protocol changes for a group take approximately 1 to 2 hours to take effect.

  • If the actual protocol differs from the one shown in the console, console data may be inaccurate but messaging is unaffected. Contact ApsaraMQ for RocketMQ technical support to update the displayed protocol.

• A group ID is required for each consumer but optional for producers.

Naming conventions for group IDs

• A group ID must be 2 to 64 characters in length and can contain letters, digits, hyphens (-), and underscores (_). Recommended prefix: GID_ or GID-.

• If the instance has a namespace, the group ID must be unique within that instance and cannot duplicate any existing group ID or topic name. Group IDs across different instances can be the same.

• If the instance has no namespace, the group ID must be globally unique across all instances and regions in your Alibaba Cloud account. It cannot duplicate any existing group ID or topic name.

Create a consumer group

1. Log on to the ApsaraMQ for RocketMQ console. In the left-side navigation pane, click Instances.

2. In the top navigation bar, select a region, such as China (Hangzhou). On the Instances page, click the name of the instance that you want to manage.

3. In the left-side navigation pane, click Groups.

4. On the Groups page, select a protocol for your client SDK and click Create Group.

   ApsaraMQ for RocketMQ supports TCP and HTTP for client SDKs.

5. In the panel that appears, set the Group ID and Description, and then click OK.

Delete a group

1. On the Instances page, click the name of the instance that you want to manage. In the left-side navigation pane of the page that appears, click Groups.

2. In the group list, find the group that you want to manage, click More in the Actions column, and then select Delete from the drop-down list.

3. In the message that appears, click OK.

View the details of a group

1. On the Instances page, click the name of the instance that you want to manage. In the left-side navigation pane of the page that appears, click Groups.

2. In the group list, find the target group and click its ID or Details in the Actions column to open the Group Details page.

More operations

The Groups page also supports these operations:

1. In the left-side navigation pane, click Groups.

2. In the group list, find the group that you want to manage, click More in the Actions column, and then select one of the following operations from the drop-down list:

• Quick Access: View ApsaraMQ for RocketMQ SDK references for multiple programming languages.

• Reset Consumer Offset: Reset the consumer offset to skip accumulated or undesired messages and start consumption from a new offset. You can also consume messages from a specific point in time, regardless of whether earlier messages were consumed. For more information, see Reset Consumer Offsets.

• Cloud Monitor: View production and consumption monitoring data for the group.

• Dashboard: View consumption metrics for the group.

References