Help Center/ Distributed Message Service for RocketMQ/ User Guide/ Managing Consumer Groups/ Modifying RocketMQ Consumer Group Configurations
Updated on 2025-07-28 GMT+08:00

Modifying RocketMQ Consumer Group Configurations

After creating a consumer group, you can modify its configuration as required.

Prerequisite

  • A RocketMQ instance has been purchased.
  • A consumer group has been created.

Modifying RocketMQ Consumer Group Configurations

  1. Log in to the console.
  2. Click in the upper left corner to select a region.

    DMS for RocketMQ instances in different regions cannot communicate with each other over an intranet. Select a nearest location for low latency and fast access.

  3. Click and choose Middleware > Distributed Message Service for RocketMQ to open the console of DMS for RocketMQ.
  4. Click a RocketMQ instance to go to the instance details page.
  5. In the navigation pane, choose Instance > Consumer Groups.
  6. Modify consumer group parameters in either of the following ways:

    • In the row containing the consumer group whose parameters you want to modify, click Edit.
    • Click a consumer group and then click Edit in the upper right corner of the consumer group details page.

  7. Modify consumer group parameters by referring to Table 1.

    Table 1 Consumer group parameters

    Parameter

    Description

    Maximum Retries

    Maximum number of times that messages are resent upon consumption failures. For example, if this parameter is set to 3, a message can be delivered for a maximum of 4 times. One time is for delivering the original message, and 3 times are for redelivery.

    Value range: 1–16

    Modifying this parameter takes effect only after the consumer group is restarted. To avoid infinite retries, set a proper value as required. A large value may increase the system pressure.

    Broadcast

    Indicates whether messages are broadcast.

    If this option is enabled, each message is retrieved by all consumers in the consumer group. If this option is disabled, each message is retrieved by only one consumer in the consumer group.

    Orderly

    This parameter is mandatory for a RocketMQ 5.x instance.

    If this option is enabled, consumers consume messages in sequence.

    Orderly consumption ensures sequential consumption by message sending. In this case, earlier messages are consumed before later messages

    Description

    Description of the consumer group.

    0–200 characters

  8. Click OK.

Related Documents