配置参数介绍
更新时间：2025-08-21
概述
创建集群时，可以使用默认配置或者使用自定义创建的集群配置，其中涉及到的参数信息如下所示。
- 更新模式分为静态模式和动态模式，当发起集群配置变更时，如果涉及到的变更参数包含了静态模式的参数，则会触发集群的重启操作，如果仅涉及动态模式的参数，则不会触发集群的重启操作。
- 参数如果是必选，则在创建集群配置时必须设置该参数。并且集群如果是使用默认配置，必选参数也会使用对应的默认值设置到集群中。
| 参数名称 | 描述 | 更新模式 | 默认值 | 是否必选 |
|---|---|---|---|---|
| auto.create.topics.enable | 是否允许自动创建 topic | 静态模式 | false | 是 |
| log.retention.hours | 消息保留时长（小时） | 静态模式 | 168 | 是 |
| log.retention.bytes | 单个分区日志保留大小（byte） | 动态模式 | -1 | 是 |
| offsets.retention.minutes | 消费组 offset 记录保留时长（分钟） | 静态模式 | 10080 | 是 |
| auto.leader.rebalance.enable | 是否开启分区 leader 自动均衡 | 静态模式 | true | 是 |
| num.partitions | topic 默认分区数 | 静态模式 | 3 | 是 |
| default.replication.factor | topic 默认副本数 | 静态模式 | 2 | 是 |
| delete.topic.enable | 是否允许删除 topic | 静态模式 | true | 是 |
| log.cleanup.policy | 日志清理策略 | 动态模式 | delete | 是 |
| message.max.bytes | 单条消息的最大值（byte） | 动态模式 | 1048588 | 是 |
| replica.fetch.max.bytes | 副本同步时消息的最大大小（byte） | 静态模式 | 1048576 | 是 |
| log.message.timestamp.type | 消息中的时间戳类型 | 动态模式 | CreateTime | 是 |
| min.insync.replicas | 当生产者将acks设置为all(或者-1)时，消息必须成功写入该配置的副本数时才能被视为写入成功 | 动态模式 | 1 | 是 |
| zookeeper.session.timeout.ms | Zookeeper session超时时间（ms） | 静态模式 | 18000 | 否 |
| zookeeper.connection.timeout.ms | 客户端等待与Zookeeper建立连接的最长时间（ms） | 静态模式 | 18000 | 否 |
| unclean.leader.election.enable | 是否允许不在ISR中的副本作为最后手段来选举为Leader | 动态模式 | false | 否 |
| log.cleaner.delete.retention.ms | 日志清理格式为compact时，压缩后日志删除的保留时长（ms） | 动态模式 | 86400000 | 否 |
| transaction.max.timeout.ms | 事务允许的最大超时时间 | 静态模式 | 900000 | 否 |
| queued.max.requests | 数据平面允许的排队请求大小，超过后会阻塞网络线程 | 静态模式 | 500 | 否 |
| offsets.commit.timeout.ms | offset延迟提交的时间，直到offset所有的副本都收到该提交，或者达到该值后超时（ms） | 静态模式 | 5000 | 否 |
| log.retention.check.interval.ms | 日志清理器检查是否有日志符合删除条件的频率（ms） | 静态模式 | 300000 | 否 |
| log.segment.delete.delay.ms | 日志文件被标记删除后，还需等待多久才会被真正的删除（ms） | 动态模式 | 60000 | 否 |