Topic Configs

These dynamic per-topic configs are accepted by AlterConfigs / IncrementalAlterConfigs. Unknown keys are rejected with INVALID_CONFIG.

KeyTypeDefaultKIPDescription
retention.mslong (ms)Retention time before log segments become eligible for deletion.
retention.byteslong (bytes)Maximum partition size before old segments are deleted.
segment.bytesint (bytes)Target size of a single log segment file.
cleanup.policystringdeletedelete, compact, or compact,delete.
compression.typestringproducerBroker-side compression codec for the topic.
min.insync.replicasint (>=1)1With acks=all, the minimum in-sync replicas required to accept a write; otherwise NOT_ENOUGH_REPLICAS (19).
unclean.leader.election.enablebooleanfalseKIP-841Allow electing an out-of-ISR replica as leader on ISR-empty failover (possible data loss).
unclean.recovery.strategystringNoneKIP-966Offset-aware unclean recovery: None, Balanced, or Aggressive. Supersedes unclean.leader.election.enable.
remote.storage.enablebooleanfalseKIP-405Opt this topic into tiered (remote) storage.
local.retention.mslong (ms)KIP-405Local-tier retention time for tiered partitions.
local.retention.byteslong (bytes)KIP-405Local-tier retention size budget for tiered partitions.
leader.replication.throttled.replicasstringKIP-73Replica list throttled on the leader side during reassignment.
follower.replication.throttled.replicasstringKIP-73Replica list throttled on the follower side during reassignment.