A group identifies a set of producers or consumers that share the same message processing logic. Create a group for each type of producer or consumer instance before you produce or consume messages in ApsaraMQ for RocketMQ.
Limits
| Limit | Description |
|---|---|
| Instance isolation | Groups cannot be shared across instances. A group created on one instance is not available on another. |
| Group ID requirement | Each consumer requires a group ID. Producers do not require a group ID. |
Common navigation
The following steps apply to all operations on this page unless otherwise specified.
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.
Create a group
On the Groups page, click Create Group.
In the Create Group panel, configure the parameters and click OK.
View groups
On the Groups page, view all groups created on the instance.
View group details
On the Groups page, find the target group and click Details in the Actions column.
On the Group Details page, view the group details. The following tabs are available:
Basic Information: View or edit the group configuration.
Running Information: View the running status of the group.
Dashboard: View the producer overview, billing metrics, and throttling metrics. For more information, see Dashboard.
Modify a group
On the Groups page, find the target group 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, click Edit.
In the Modify Group panel, configure the parameters and click OK.
Reset the consumer offset
On the Groups page, find the target group 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, click Reset Consumer Offset.
In the Reset Consumer Offset panel, select a reset method and click OK.
Reset method Behavior Start Consumption from Latest Offset Consumers skip all accumulated messages in the topic and start consuming from the latest offset. Start Consumption from Offset Corresponding to Specified Point in Time A time picker appears. Consumers consume messages sent after the selected time, regardless of whether the messages were previously consumed. WarningWarning: If you select Start Consumption from Latest Offset, all accumulated messages for the group in the specified topic are cleared. The operation takes effect in approximately 2 to 3 minutes. Do not repeat the operation during this period. All consumers in the application stop consuming messages until the reset takes effect. Proceed with caution if your business is latency-sensitive.
In the Note message, click OK.
Delete a group
Deleting a group stops all consumer instances identified by the group ID from receiving messages. All resources in the group are permanently deleted and cannot be restored.
On the Groups page, find the target group 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, click Delete Group.
In the Note message, click OK.
Export and import group data
For more information, see Export and import group data.
API operations
You can also call the following API operations to manage groups:
| Operation | Description |
|---|---|
| CreateConsumerGroup | Create a consumer group. |
| UpdateConsumerGroup | Update a consumer group. |
| DeleteConsumerGroup | Delete a consumer group. |
| ListConsumerGroups | List consumer groups. |
| GetConsumerGroup | Query the details of a consumer group. |