首页/数据/数据工程与 ETL 速查/kafka-topics.sh 查看主题详情
Kafka64 条

kafka-topics.sh 查看主题详情

describe 输出分区分布、Leader、副本与 ISR,还可按 under-replicated/unavailable 过滤,是副本类故障排查的常用入口命令。

用途查看分区、Leader、Replicas、ISR 与生效配置
过滤--under-replicated-partitions、--unavailable-partitions、--at-min-isr-partitions
配置--topics-with-overrides 只看有覆盖配置的主题

常用查询

常用查询
kafka-topics.sh --bootstrap-server localhost:9092 --describe --topic orders
kafka-topics.sh --bootstrap-server localhost:9092 --describe --under-replicated-partitions
kafka-topics.sh --bootstrap-server localhost:9092 --describe --unavailable-partitions
kafka-topics.sh --bootstrap-server localhost:9092 --describe --topics-with-overrides
输出里 Isr 列表短于 Replicas 说明有副本掉队;结合 Broker 日志与磁盘指标继续定位。

易错点

  • 分区很多时 describe 输出量大,先接 grep/awk 聚合再人工看
  • Isr 与 Replicas 顺序不固定,脚本解析要按集合处理而非位置

数据来源与参考

  • Apache Kafka 官方文档:kafka-topics.sh describe 输出说明
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌