如何使用kafka-consumer-groups工具列出Kafka空消费者组

kafka-consumer-groups 没有提供直接过滤空消费者组的专属参数，你可以通过组合工具自带的状态查询能力和基础文本过滤命令快速拿到结果，输出的空组口径和你提到的JMX空组计数指标完全一致。

具体操作 #

如果你是Linux/macOS环境，直接在终端执行以下命令即可输出所有空消费者组的名称：

kafka-consumer-groups.sh --bootstrap-server <你的Kafka集群broker连接地址> --list --state | grep -w 'Empty' | awk '{print $1}'

参数和命令逻辑说明：

• 把<你的Kafka集群broker连接地址>替换成实际的集群地址，多个broker用逗号分隔，比如192.168.1.10:9092,192.168.1.11:9092
• --list --state 会拉取集群内所有消费者组的名称、当前运行状态，其中状态为Empty的组就是空消费者组——这类组没有任何活跃注册的消费者，也没有绑定分区分配关系，和JMX指标kafka.coordinator.group:name=NumGroupsEmpty,type=GroupMetadataManager的统计规则完全对齐
• grep -w 'Empty' 做精确匹配，过滤掉状态为Stable、PreparingRebalance、Dead等其他类型的消费者组
• awk '{print $1}' 会裁剪掉每行末尾的状态字段，只输出第一列的消费者组名称，得到纯空组列表

Windows环境下没有内置grep、awk工具，可以直接执行不带管道过滤的基础命令：

kafka-consumer-groups.bat --bootstrap-server <你的Kafka集群broker连接地址> --list --state

拿到全量组和状态的输出结果后，手动筛选状态列标注为Empty的组即可。

内容的提问来源于stack exchange，提问作者samuelj