20、Kafka 实战 - Kafka Consumer 重置 Offset

在Kafka Version为0.11.0.0之后,Consumer的Offset信息不再默认保存在Zookeeper上,而是选择用Topic的形式保存下来。在命令行中可以使用kafka-consumer-groups的脚本实现Offset的相关操作。

更新Offset的三个维度:

  • Topic的作用域
  • 重置策略
  • 执行方案

Topic的作用域

  • --all-topics:为consumer group下所有topic的所有分区调整位移)
  • --topic t1 --topic t2:为指定的若干个topic的所有分区调整位移
  • --topic t1:0,1,2:为指定的topic分区调整位移

重置策略

  • --to-earliest:把位移调整到分区当前最小位移
  • --to-latest:把位移调整到分区当前最新位移
  • --to-current:把位移调整到分区当前位移
  • --to-offset <offset>: 把位移调整到指定位移处
  • --shift-by N: 把位移调整到当前位移 + N处,注意N可以是负数,表示向前移动
  • --to-datetime <datetime>:把位移调整到大于给定时间的最早位移处,datetime格式是yyyy-MM-ddTHH:mm:ss.xxx,比如2017-08-04T00:00:00.000
  • --by-duration <duration>:把位移调整到距离当前时间指定间隔的位移处,duration格式是PnDTnHnMnS,比如PT0H5M0S
  • --from-file <file>:从CSV文件中读取调整策略

执行方案

什么参数都不加:只是打印出位移调整方案,不具体执行

  • --execute:执行真正的位移调整
  • --export:把位移调整方案按照CSV格式打印,方便用户成csv文件,供后续直接使用

注意事项

1、 consumergroup状态必须是inactive的,即不能是处于正在工作中的状态;
2、 不加执行方案,默认是只做打印操作;

常用示例

1、 更新到当前group最初的offset位置;

bin/kafka-consumer-groups.sh --bootstrap-server localhost:9092 --group test-group --reset-offsets --all-topics --to-earliest --execute

2、 更新到指定的offset位置;

bin/kafka-consumer-groups.sh --bootstrap-server localhost:9092 --group test-group --reset-offsets --all-topics --to-offset 500000 --execute

3、 更新到当前offset位置(解决offset的异常);

bin/kafka-consumer-groups.sh --bootstrap-server localhost:9092 --group test-group --reset-offsets --all-topics --to-current --execute

4、 offset位置按设置的值进行位移;

bin/kafka-consumer-groups.sh --bootstrap-server localhost:9092 --group test-group --reset-offsets --all-topics --shift-by -100000 --execute

5、 offset设置到指定时刻开始;

bin/kafka-consumer-groups.sh --bootstrap-server localhost:9092 --group test-group --reset-offsets --all-topics --to-datetime 2017-08-04T14:30:00.000