A group contains producers or consumers that produce or consume messages of the same type based on the same logic. To use ApsaraMQ for RocketMQ to produce or consume messages, you must create groups to identify producer instances or consumer instances of the same type. This topic describes how to create and delete a group in the ApsaraMQ for RocketMQ console. This topic also describes how to view the details of a group.
Limits
Groups cannot be used across instances. For example, a group that you create on Instance A cannot be used on Instance B.
A group ID must be specified for each consumer. You do not need to specify a group ID for each producer.
Create a group
Log on to the ApsaraMQ for RocketMQ console. In the left-side navigation pane, click Instances.
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.
In the left-side navigation pane, click Groups.
On the Groups page, click Create Group.
In the Create Group panel, follow the on-screen instructions to configure the parameters and click OK.
View the list of groups
Log on to the ApsaraMQ for RocketMQ console. In the left-side navigation pane, click Instances.
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.
In the left-side navigation pane, click Groups.
On the Groups page, view the groups that are created on the instance.
View the details of a group
On the Groups page, find the group that you want to manage and click Details in the Actions column.
On the Group Details page, view the details of the group.
View the running information of a group
On the Groups page, find the group that you want to manage and click Details in the Actions column.
On the Group Details page, click the Running Information tab.
Modify the information about a group
On the Groups page, find the group that you want to manage and click Details in the Actions column.
On the Group Details page, click the Basic Information tab. In the upper-right corner of the Basic Information section of the tab, click Edit.
In the Modify Group panel, follow the on-screen instructions to configure the parameters and click OK.
Delete a group
After you delete a group, the consumer instances identified by the ID of the group stop receiving messages. The resources in the group are also deleted and cannot be restored. Exercise caution when you delete a group.
On the Groups page, find the group that you want to manage and click Details in the Actions column.
On the Group Details page, click the Basic Information tab. In the upper-right corner of the Basic Information section of the tab, click Delete Group.
In the Note message, click OK.
Reset the consumer offset of a group
On the Groups page, find the group that you want to manage and click Details in the Actions column.
On the Group Details page, click the Basic Information tab. In the upper-right corner of the Basic Information section of the tab, click Reset Consumer Offset.
In the Reset Consumer Offset panel, select a reset method based on your business requirements and click OK.
If you select Start Consumption from Latest Offset, all accumulated messages of the group are cleared in the specified topic. This operation takes effect after approximately 2 to 3 minutes. Do not repeat the operation. Before the reset operation takes effect, all consumers in the application stop consuming messages. If your business is latency-sensitive, proceed with caution.
If you select Start Consumption from Latest Offset, the consumers of the group skip all accumulated messages in the topic and start consumption from the latest offset.
If you select Start Consumption from Offset Corresponding to Specified Point in Time, a time picker appears. After you select a point in time from the time picker, consumers consume messages that are sent after the selected point in time, regardless of whether the messages are previously consumed.
In the Note message, click OK.
View the dashboard
The dashboard displays the producer overview, billing metrics, and throttling metrics of a specific instance. For more information, see Dashboard.
On the Groups page, find the group that you want to manage and click Details in the Actions column.
On the Group Details page, click the Dashboard tab.
More operations
For information about how to export and import group data, see Export and import group data.
References
You can aslo call the following API operations to manage groups:
