Updated on 2025-08-21 GMT+08:00

Deleting a Kafka Consumer Group

You can delete a consumer group in either of the following ways:

  • On the console.
  • Use Kafka CLI. (Ensure that the Kafka instance version is the same as the CLI version.)

Video Tutorial

This video shows how to delete Kafka consumer groups.

Notes and Constraints

  • If auto.create.groups.enable is set to true, the consumer group status is EMPTY, and no offset has been submitted, the system automatically deletes the consumer group 10 minutes later.
  • If auto.create.groups.enable is set to false, the system does not automatically delete consumer groups. You can manually delete them.
  • If a consumer group has never committed an offset, the group will be deleted after the Kafka instance restarts.
  • Deleting a consumer group loses the consumption offset. Re-consumption or repeated consumption may occur.

Prerequisite

The status of the consumer group to be deleted is EMPTY.

Deleting a Consumer Group

A consumer group can be deleted on the Kafka console or on a client.

  1. Log in to the Kafka console.
  2. Click in the upper left corner to select the region where your instance is located.
  3. Click the desired instance to go to the instance details page.
  4. In the navigation pane, choose Instance > Consumer Groups.
  5. Delete consumer groups using either of the following methods:

    • Select one or more consumer groups and click Delete Consumer Group above the consumer group list.
    • In the row containing the consumer group to be deleted, click Delete.
    • Click the consumer group to be deleted. The consumer group details page is displayed. Click Delete in the upper right corner.

  6. In the displayed Delete Consumer Group dialog box, click OK.

    The consumer groups are deleted when they are no longer displayed in the consumer group list.

The following uses Linux as an example.

  • For a Kafka instance with ciphertext access disabled, run the following command in the /bin directory of the Kafka client:
    ./kafka-consumer-groups.sh --bootstrap-server {connection-address} --delete --group {group-name}
    Table 1 Consumer group deletion parameters

    Parameter

    Description

    connection-address

    Connection address of a Kafka instance. To obtain the address, choose Overview > Connection.

    group-name

    Consumer group name.

    Example:

    [root@ecs-kafka bin]# ./kafka-consumer-groups.sh --bootstrap-server 192.168.xx.xx:9092,192.168.xx.xx:9092,192.168.xx.xx:9092 --delete --group group-01
    Deletion of requested consumer groups ('group-01') was successful.
    [root@ecs-kafka bin]#
  • For a Kafka instance with ciphertext access enabled, do as follows:
    1. (Optional) If the SSL certificate has been configured, skip this step and go to 2. Otherwise, do as follows:

      Create the ssl-user-config.properties file in the /config directory of the Kafka client and add the SSL certificate configurations by referring to 3.

    2. In the /bin directory of the Kafka client, run the following command:
      ./kafka-consumer-groups.sh --bootstrap-server {connection-address} --delete --group {group-name} --command-config ../config/{ssl-user-config.properties}
      Table 2 Consumer group deletion parameters

      Parameter

      Description

      connection-address

      Connection address of a Kafka instance. To obtain the address, choose Overview > Connection.

      group-name

      Consumer group name.

      ssl-user-config.properties

      Configuration file name. This file contains username, password, and SSL certificate information.

      Example:

      [root@ecs-kafka bin]# ./kafka-consumer-groups.sh --bootstrap-server 192.168.xx.xx:9093,192.168.xx.xx:9093,192.168.xx.xx:9093 --delete --group group-02 --command-config ../config/ssl-user-config.properties
      Deletion of requested consumer groups ('group-02') was successful.
      [root@ecs-kafka bin]#

Related Document

To delete a consumer group by calling an API, see Deleting a Specified Consumer Group.