Status

Current state: "Under Discussion"

Discussion thread: here

JIRA: KAFKA-19639

Motivation

In Kafka, there are some configurations that historically had different meanings but now provide the same functionality. Because of this overlap, users may find it confusing that different configuration names exist for the same setting. To reduce confusion and improve consistency, we should deprecate these redundant configurations and align them under a single configuration.

Public Interfaces

• org.apache.kafka.server.config.ServerLogConfigs
• org.apache.kafka.server.config.ServerConfigs

Proposed Changes

log.dirs & log.dir

Compatibility, Deprecation, and Migration Plan

1. We will add the `@Deprecated` annotation to these configurations. If users set any of them, Kafka 4.0 will print a warning message.

2. These deprecated configurations will be fully removed in Kafka 5.0.

Test Plan

The unit tests and integration tests should be updated to use the non-deprecated configurations, and all tests must pass.

Rejected Alternatives

n/a