跳到主要内容

参考资料

官方资源​

配置项拿不准、行为对不上时，按这个顺序翻：先查官方配置文档，再看 KIP 里的设计原委，最后去社区找有没有人踩过同样的坑。

  • Apache Kafka 官网：项目主页，下载地址、版本发布节奏、生态项目入口都在这一页，判断「现在该用哪个版本」先从这看。
  • Kafka 官方文档：唯一权威口径，快速上手、配置项全表、设计文档、协议说明四部分都在这里，配置默认值以它为准。
  • Kafka GitHub 仓库：源码和 Release Notes 的出处，想知道某个版本改了什么、某个参数是不是废弃了，直接看 release notes 最准。
  • Confluent 文档：商业发行版的文档，写得更偏实践，KRaft 迁移、监控指标、客户端调优这些主题的解释往往比官方文档好读。

设计与提案​

  • Kafka Improvement Proposals（KIP）：所有重要特性的设计提案，搞不清「为什么要这么设计」时看这个，比如 KRaft、幂等生产者、增量协作式再均衡都有对应 KIP。
  • Kafka 协议文档：客户端与服务端的二进制协议说明，自己写客户端或排查版本兼容问题时才需要翻。

社区与工具​

  • Kafka 官方邮件列表与 Slack：遇到疑似 bug 或者设计层面的疑问，这里是能找到 committer 的地方。
  • kafka-lag-exporter：把消费组 lag 导出成 Prometheus 指标的工具，第 5 篇的 lag 监控方案就是基于它。
  • kafka_exporter：轻量级指标导出器，一个二进制就能把 Broker 和消费组指标暴露成 /metrics，小环境够用。
  • Strimzi：Kubernetes 上的 Kafka Operator，想在 K8s 里跑 Kafka 时基本绕不开它，文档里有大量生产实践。
查文档的小习惯

看到某个参数不确定默认值时，别信博客——不同版本默认值改过好几次（session.timeout.ms、linger.ms 都变过）。打开官方文档对应版本的配置页，或者直接在 Broker 上用 kafka-configs.sh --describe 看当前生效值，这两个来源才可靠。