管理kafka
主题操作
1.在集群里创建一个主题需要用到3个参数。这些参数是必须提供的,尽管有些已经有broker级别的默认值。
主题名字,想要创建的主题的名字,主题名字可以包含字母,数字,下划线以及英文状态下破折号和句号。
复制系数,主题的副本数量
分区,主题的分区数量
指定主题配置
可以在创建时显式地指定复制系数或者对配置进行覆盖,通过向kafka-topic.sh 传递 --config参数来实现的。
主题创建的格式
kafka-topics.sh --zookeeper <zookeeper connect> --create --topic <string> --relipcation-fact <integer> -- partition <integer>
如果为集群指定了基于机架信息的副本分配策略,那么分区的副本会分布在不同的架构上。如果不需要基于架构信息的分配策略,可以指定参数 --disable-rack-aware
增加分区
kafak-topics.sh --zookeeper <zookeeper connect> --alter --topic <String> --partitions <integer>
只能增加分区,不能删除分区,如果删除分区,会导致数据不一致。
删除主题
如果一个主题不再使用,只要它还存在集群里面,就会占用一定数量的磁盘空间和文件句柄,把它删除就可以释放被占用的资源。为了能删除主题,broker的delete.topic.enable 参数必须设置为true,如果该参数被设置为false,删除主题的请求会被忽略。
kafka-topics.sh --zookeeper <zookeeper connect> --delete --topic <String>
列出集群里的所有主题
可以使用主题工具列出集群里的所有主题。每个主题占用一行输出,主题之间没有特定的顺序。
kafka-topic.sh --zookeeper <zookeeper connect> --list
列出主题详细信息
kafka-topic.sh --zookeeper <zookeeper connect> --describe
使用topics-with-overrides 参数可以找出所有包含覆盖配置的主题,它只会列出包含了与集群不一样的主题
有两个参数可用于找出有问题的分区。
使用--under-replicated-partitions 参数可以列出所有包含不同步副本的分区。
使用 --unavailable-partitions 参数可以列出所有没有首领的分区,这些分区已经处于离线状态,对于生产者和消费者来说是不可用的。
消费者群组
在kafka里,有两个地方保存着消费者群组的信息。对于旧版本的消费来说,它们的信息保存在Zookeeper上。对于新版本的消费者来说,它们的信息保存在broker上,kafka-consumer-group.sh 工具可以用于列出上述两种消费者群组。它也可以用于删除消费者群组和偏移量信息,不过这个功能仅限于旧版本的消费者群组(信息保存在Zookeeper上),在对于旧版本的消费者仅限操作时,需要通过--zookeeper参数来指定Zookeeper的地址;对于新的 则需要指定 --bootstrap-server参数来指定broker的主机名和端口。
列出旧版本的消费者群组
kafka-consumer-groups.sh --zookeeper <zookeeper connect> --list
列出新版本的消费者群组
kafka-consumer-grous.sh --new-consumer --bootstrap-server <kafka connect> --list
列出的任意群组来说 使用 --describe 代替 --list.
消费者群组的详细信息
Group 消费者群组的名字
Topic 正在被读取的主题名字
Partition 正在被读取的分区ID
Current-offset 消费者群组最近提交的偏移量,也就是说在分区里去读取的当前位置。
log-end-offset 当前高水位偏移量,也就是最近一被读取消息的偏移量,同时也是最近一个提交到集群的偏移量
lag 消费者的current-offset 和broker的log-end-offset之间的差距
owner 消费者群组里正在读取该分区的消费者。这个一个消费者的id,不一定包含消费者的主机名。
消费群组
只有旧版本的消费者客户端才支持删除群组的操作。删除群组操作将从zookeeper上移除整个群组,包括所有已保存的偏移量。
kafka-consumer-groups.sh --zookeeper <zookeeper connect> --delete --group <String>
该命令也可以用于不删除整个群组的情况下删除单个主题的偏移量,再次强调,在进行删除操作之前,需要先关闭消费者,或者不要让它们读取即将被删除的主题。
kafka-consumer-groups.sh --zookeeper <zookeeper connect> --delete --group <String> --topic <String>
偏移量管理
1.导出偏移量
kafka-run-class.sh kafka.tools.ExportZkOffsets --zkconnect <zookeeper connect> --group <String> --output -file <String>
2.导入偏移量
先关闭消费者,如果消费者活跃状态,那么可能会将导入的偏移量被覆盖
kafka-run-class.sh kafka.tools.ImportZkOffsets --zkconnet <zookeeper connect> --input-file <String>
覆盖主题的默认配置
kafka-configs.sh --zookepper <zookepper connect> --alter --entity-type topic --entity-name <topic name> --and-config <key>=<value>,<key>=<value>
覆盖客户端的默认配置
kafka-configs.sh --zookeeper <zookeeper connect> --alter --entity clients --entity-name <client id> and -config <key>=<value>,<key>=<value>
列出被覆盖的配置
kafka-config.sh --zookeeper <zookeeper connect> --describe --entity-type topics --entity-name my-topic
移除被覆盖的配置
删除主题的某一个配置
kafka-configs.sh --zookeeper <zookeeper connect> -alter --entity-type topics --entity-name <topic name> --delete-config <参数名>
分区管理
自动首领再均衡
kafka-preferred-replica-election.sh --zookeeper<zookeeper connect>
修改分区副本
使用kafka-reassign-partitions.sh
这个工具分为步来修改分区
1.根据broker清单和主题清单生产一组迁移步骤
2.执行这些迁移步骤。
3.第三步是可选的,可以使用生成的迁移步骤验证分区重分配的进度和完成情况。
获取json
kafak-reassgin-partitions.sh --zookeeper<zookeeper connect> --generate --topic-to-move-json-file topics.json --broker -list 0,1
修改执行json
kafka-reassgin-partitions.sh --zookeeper<zookeeper connect> --execute --reassignment-json-file topic.json
显示重新分区的情况
kafka-reassgin-partitions.sh --zookeeper<zookeeper connect> --verify --reassignment-json-file topic.json
修改复制系数 从上面步骤中获取json,修改复制系数,执行
转储日志片段
kafka-run-class.sh kafka.tools.DumplogSegments --files <log name>
验证索引文件的正确性使用 --index-sanity-check
验证副本
kafka-replica-verfycation.sh --broker-list <kafka connect>,<kafka connect> --topic-while-list <主题名>
消费者和生产者借助kafka-console-consumer.sh 和kafka-console-producer.sh
指定待读取的主题3个可用的参数 --topic --whilelist --blacklist 后面两个跟着一个正则表达式。
使用旧版消费者读取单个主题
kafka-console-consumer.sh --zookeeper <zookepper connect> --topic <tipic name>
控制台消费者其他常用配置如下:
--formatter className 指定消息格式化器的类名,用于解码消息 默认值是kafka.tools.DefaultFormatter
--form-beginning 指定从最旧的偏移量开始读取数据,否则从最新的偏移量开始读取。
--max-message Num 指定在推出之前最多读取NUM个消息。
--partition NUM 指定只读取ID 为NUM的分区(需要新版本的消费者)。
读取偏移量主题 使用这个格式化器读取kafka.coordinator.GroupMetadataManager$OFFsetsMessageFormatter
kafka-console-consumer.sh --zookeeper <zookeeper connect> --topic __consumer_offsets --formatter kafka.coordinator.GroupMetadataManager$OFFsetsMessageFormatter
控制台生产者
向主题生成两个消息
kafka-console-prodecer.sh --broker-list <kafka connect> --topic <topic name>
客户端ACL
命令行工具kafka-acls.sh可以用于处理客户端访问控制相关的问题。
取消分配重分配
1.发起重分配请求
2.集群控制器将分区添加到broker上
3.新的broker开始复制分区,直到副本达到同步状态
4.集群控制器从分区副本清单里移除旧的broker.
手动删除主题
1.关闭集群里所有的broker
2.删除zookeeper路径/broker/topics/TOPISCNAME,注意要先删除节点下的子节点。
3.删除每个broker的分区目录,这些目录的名字可能是TOPICNAME-NUM 其中NU是指定分区的ID.
4.重启所有的broker.
1.关闭集群里所有的broker
2.删除zookeeper路径/broker/topics/TOPISCNAME,注意要先删除节点下的子节点。
3.删除每个broker的分区目录,这些目录的名字可能是TOPICNAME-NUM 其中NU是指定分区的ID.
4.重启所有的broker.