Kafka运维实战 14 - kafka消费者组消费进度（Lag）深入理解【实战】

💻 Kafka运维实战 (17篇)

- [什么是消费者 Lag](#什么是消费者 Lag)
- - 举例说明：
  - [Lag 的意义：](#Lag 的意义：)
- [Lag 监控和查询](#Lag 监控和查询)
- - kafka-consumer-groups
  - - 基本语法
    - 常用命令示例
    - [1. 查看单个消费者组的详细信息（最常用）](#1. 查看单个消费者组的详细信息（最常用）)
    - [2. 列出所有消费者组（只显示名称）](#2. 列出所有消费者组（只显示名称）)
    - [3. 列出所有消费者组（有详情信息，可以通过grep过滤topic和消费者组对应信息）](#3. 列出所有消费者组（有详情信息，可以通过grep过滤topic和消费者组对应信息）)
    - [4. 查看消费者组成员信息](#4. 查看消费者组成员信息)
  - [Golang 代码实现 Lag 监控](#Golang 代码实现 Lag 监控)

什么是消费者 Lag

在消息队列系统（如 Kafka）中，消费者 Lag（也称为 "滞后量"） 是衡量消费者（或消费者组）处理消息进度的核心指标，它表示尚未被消费的消息数量。

具体来说，Lag 的计算方式是：

Lag = 分区当前最大偏移量（Max Offset） - 消费者已提交的偏移量（Committed Offset）

最大偏移量（Max Offset）：分区中最新一条消息的位置（即已经生产的消息总量标识）。
已提交偏移量（Committed Offset）：消费者组已经成功处理并提交的最新消息位置（即已经消费完成的进度标识）。

通常来说，Lag 的单位是消息数，而且我们一般是在主题这个级别上讨论 Lag 的，但实际上，Kafka 监控 Lag 的层级是在分区上的。如果要计算主题级别的，你需要手动汇总所有主题分区的 Lag，将它们累加起来，合并成最终的 Lag 值。

举例说明：

假设某个分区的消息偏移量是从 0 开始递增的：

目前分区中最新的消息偏移量是 100（即已生产了 101 条消息，0~100）。
消费者组已提交的偏移量是 80（即已处理完 0~80 的消息）。

此时，Lag = 100 - 80 = 20，意味着还有 20 条消息（81~100）未被消费。

Lag 的意义：

Lag = 0：表示消费者完全跟上了消息生产速度，没有未处理的消息。
Lag 增大：说明消费者处理速度慢于消息生产速度，出现了消息积压，可能导致业务延迟。
Lag 长期不为 0：可能是消费者能力不足、逻辑阻塞或系统异常的信号，需要排查。

Lag 监控和查询

kafka-consumer-groups

kafka-consumer-groups 脚本是 Kafka 为我们提供的最直接的监控消费者消费进度的工具。

kafka-consumer-groups.sh 是 Kafka 自带的命令行工具，用于管理和查询消费者组（Consumer Group）的信息，包括消费进度（Lag）、位移（Offset）、成员信息等。它是排查消费问题的常用工具，适用于快速诊断消费者组状态。

基本语法

bash 复制代码

kafka-consumer-groups.sh --bootstrap-server <kafka-broker地址> [选项]

核心参数说明：

--bootstrap-server：指定 Kafka 集群的 broker 地址（如 localhost:9092 或多个地址用逗号分隔），必须指定。
--group：指定消费者组名称（操作单个组时使用）。
--all-groups：操作所有消费者组（如查询所有组的信息）。
--describe：查看消费者组的详细信息（包括每个分区的位移和 Lag）。

常用命令示例

1. 查看单个消费者组的详细信息（最常用）

bash 复制代码

kafka-consumer-groups.sh --bootstrap-server localhost:9092 --describe --group my-consumer-group

输出示例及解读：

复制代码

GROUP           TOPIC           PARTITION  CURRENT-OFFSET  LOG-END-OFFSET  LAG             CONSUMER-ID                                     HOST            CLIENT-ID
my-consumer-group test-topic      0          80              100             20              consumer-1-abc123                              /192.168.1.1    consumer-1
my-consumer-group test-topic      1          50              50              0               consumer-2-def456                              /192.168.1.2    consumer-2

字段含义：

GROUP：消费者组名称。
TOPIC：消费的主题名称。
PARTITION：主题的分区编号。
CURRENT-OFFSET：消费者组已提交的位移（已处理到的位置）。
LOG-END-OFFSET：分区最新的消息位移（已生产的最新位置）。
LAG：未消费的消息数量（LOG-END-OFFSET - CURRENT-OFFSET）。
CONSUMER-ID/HOST/CLIENT-ID：当前消费该分区的消费者信息。

2. 列出所有消费者组（只显示名称）

bash 复制代码

kafka-consumer-groups.sh --bootstrap-server localhost:9092 --list

输出示例：

复制代码

my-consumer-group
order-service-group
user-tracking-group

3. 列出所有消费者组（有详情信息，可以通过grep过滤topic和消费者组对应信息）

bash 复制代码

kafka-consumer-groups.sh --bootstrap-server localhost:9092 --describe --all-groups

bash 复制代码

./bin/kafka-consumer-groups.sh --bootstrap-server 192.168.37.10:9092   --all-groups --describe 2>/dev/null  | grep -v GROUP |awk '{size[$1" "$2]+=$6} END{for(i in size) if(size[i]>300) {print "    消费.对应Tpic "i,"的积压数为:"size[i]}}'

实现效果

4. 查看消费者组成员信息

bash 复制代码

kafka-consumer-groups.sh --bootstrap-server localhost:9092 \
  --describe --group my-consumer-group \
  --members

输出消费者组内的成员列表、分配的分区等信息，用于确认组内消费者是否正常在线。

Golang 代码实现 Lag 监控

填坑，待完善！

Kafka运维实战 14 - kafka消费者组消费进度（Lag）深入理解【实战】

目录

什么是消费者 Lag

举例说明：

Lag 的意义：

Lag 监控和查询

kafka-consumer-groups

基本语法

常用命令示例

1. 查看单个消费者组的详细信息（最常用）

2. 列出所有消费者组（只显示名称）

3. 列出所有消费者组（有详情信息，可以通过grep过滤topic和消费者组对应信息）

4. 查看消费者组成员信息

Golang 代码实现 Lag 监控