Apache Kafka Operations
Apache Kafka operations covers the day-to-day management of Kafka clusters: broker configuration, partition rebalancing, replication tuning, monitoring, upgrades, and capacity planning to keep a distributed event-streaming platform running reliably under production workloads.
itDistributed systems, messaging, and integration | OpenSkills.info
Course pathWalk it in order
Look it upDip in anytime
Go furtherLeaves this page
Don't Panic
Don't Panic — Apache Kafka Operations
Apache Kafka is a distributed log system that lets producers write records and consumers read them at their own pace. Its operational trick is that several things must remain healthy at once: the metadata that describes the cluster, the replicas that keep records safe, and the offsets that show whether consumers have caught up. This is why a green process list is a pleasant sight, but not a complete argument.
The furniture is arranged in two rooms. Controllers keep the metadata room in order through a quorum, while brokers store partition replicas and serve client traffic. One replica leads each partition. Followers copy it. The in-sync replica set, or ISR, is the current group of copies Kafka considers synchronized. Lose controller majority and metadata decisions stop. Lose too much ISR and an all-acknowledgment write should fail rather than quietly become less durable. The cluster is being annoyingly honest.
Topics are not empty labels on a shelf. A topic's partition count, replication factor, retention, cleanup policy, and limits are a contract for a workload. Adding partitions is one-way, may change future key placement, and does not redistribute old records. Adding a broker also does not spread old replicas about out of civic-mindedness. That is a reassignment, which is a data-copy operation with a proposal, review, throttle, verification, and a saved rollback input.
Then come the offsets. A consumer group records its progress separately from the log. Lag is the gap between that progress and a partition's end, not a universal measure of panic. Ten thousand records can be seconds for one workload and hours for another. Pair it with throughput, processing latency, rebalance activity, and the age of required work. An offset reset is replay, so stop active consumers, preview the target, check retention, and make sure repeated side effects are safe.
Operations works best as a series of small proofs. Start with zero-state signals: offline partitions, offline log directories, under-minimum-ISR partitions, unclean elections, and metadata errors should be zero. Then watch the pressure signals around them: under-replication, queues, latency, network idle time, lag, and controller delay. The dashboard is not a fortune teller. It is the part of the system willing to answer questions.
For the complete map, read the Intro for the control and data planes, Slides for the change and failure paths, Cheatsheet for commands and JMX names, and Reference for the exact Kafka documentation. The practice reference and exercise turn the one-way partition rule into a safe lab observation.
Where this skill leads
Relevant careers
See how this topic contributes to broader role-level skill maps.
Sources
- https://kafka.apache.org/43/operations/kraft/
Supports
- Broker, controller, and combined process roles
- Controller majority and three-controller or five-controller failure tolerance
- Static and dynamic quorum configuration and membership operations
- Metadata quorum inspection and debugging tools
- https://kafka.apache.org/43/operations/basic-kafka-operations/
Supports
- Topic creation, modification, description, and deletion
- One-way partition expansion and its key-placement effects
- Graceful shutdown and preferred leader election
- Consumer-group inspection and offset-reset preconditions
- Partition reassignment generate, execute, verify, rollback, and throttle workflow
- Rack-aware placement and broker expansion behavior
- https://kafka.apache.org/43/operations/monitoring/
Supports
- Offline log directory, offline partition, under-replicated, and under-minimum-ISR metrics
- Controller, metadata error, queue, throughput, and network metrics
- Consumer records-lag-max semantics
- Preferred replica imbalance and election metrics
- https://kafka.apache.org/43/configuration/broker-configs/
Supports
- Essential KRaft broker settings and update modes
- Data log directories, listeners, and advertised listener behavior
- Unclean leader election data-loss risk
- Broker-wide replication, storage, quota, and shutdown settings
- https://kafka.apache.org/43/configuration/topic-configs/
Supports
- Minimum in-sync replicas with all acknowledgments
- Retention, cleanup, compaction, and record-size settings
- Per-topic configuration as an override of server defaults
- https://kafka.apache.org/43/operations/eligible-leader-replicas/
Supports
- Eligible Leader Replica behavior and election order
- Default enablement on new clusters from Kafka 4.1
- Interaction with minimum in-sync replica configuration
- https://kafka.apache.org/43/security/encryption-and-authentication-using-ssl/
Supports
- TLS transport encryption and certificate-based authentication
- Client and broker trust and key material
- Client authentication settings and encrypted listener configuration
- https://kafka.apache.org/43/security/authentication-using-sasl/
Supports
- Supported SASL mechanisms
- SASL over plaintext or encrypted transport
- Broker, inter-broker, and client authentication configuration
- https://kafka.apache.org/43/security/authorization-and-acls/
Supports
- KRaft StandardAuthorizer configuration
- ACL principals, hosts, operations, resources, and patterns
- ACL command-line listing, addition, and removal
- Default behavior for resources without matching ACLs
- https://kafka.apache.org/43/operations/hardware-and-os/
Supports
- Memory, disk-throughput, filesystem, and page-cache considerations
- Multiple data directories and disk-balancing tradeoffs
- Recovery and flush behavior
- https://kafka.apache.org/43/getting-started/upgrade/
Supports
- Kafka 4.3 rolling broker upgrade sequence
- Behavior and performance verification before feature finalization
- Release-version upgrade command and downgrade constraints
- https://github.com/apache/kafka/blob/trunk/docs/operations/basic-kafka-operations.md
Supports
- Primary source Markdown for operational commands and procedures
- https://github.com/apache/kafka/blob/trunk/docs/operations/monitoring.md
Supports
- Primary source Markdown for JMX metric names and meanings
- https://kafka.apache.org/43/getting-started/quickstart/
Supports
- Local Kafka cluster setup and command-line producer and consumer examples
- https://kafka.apache.org/community/downloads/
Supports
- Kafka 0.8.0, 1.0.0, 2.0.0, 2.8.0, and 3.0.0 release dates
- Early access self-managed quorum support in Kafka 2.8.0
- KRaft metadata snapshot improvements in Kafka 3.0.0
- https://kafka.apache.org/08/documentation/
Supports
- Kafka 0.8 documentation for replicated brokers and partitions
- https://kafka.apache.org/blog/2023/06/15/apache-kafka-3.5.0-release-announcement/
Supports
- ZooKeeper deprecation and the early-access KRaft migration path in Kafka 3.5.0
- https://kafka.apache.org/blog/2024/11/06/apache-kafka-3.9.0-release-announcement/
Supports
- Dynamic KRaft controller membership and the final major ZooKeeper-mode release
- https://kafka.apache.org/blog/2025/03/18/apache-kafka-4.0.0-release-announcement/
Supports
- Kafka 4.0 operation without ZooKeeper and KRaft as the default model
- https://engineering.linkedin.com/apache-kafka/how-we_re-improving-and-advancing-kafka-linkedin
Supports
- Practitioner monitoring of consumer applications keeping up with incoming messages
- Rack-aware placement and Kafka failure testing at scale
- https://kafka.apache.org/
Supports
- Apache Kafka self-managed distribution and official documentation
- https://www.confluent.io/confluent-cloud/
Supports
- Confluent Cloud managed Kafka clusters, monitoring, security, and replication capabilities
- https://docs.aws.amazon.com/msk/
Supports
- Amazon Managed Streaming for Apache Kafka documentation
- https://aiven.io/docs/products/kafka
Supports
- Aiven managed Kafka service, deployment models, tiers, and managed replication
- https://www.ibm.com/products/event-automation/event-streams
Supports
- IBM Event Streams product information
- https://www.redpanda.com/
Supports
- Redpanda Kafka-compatible platform information
- https://strimzi.io/
Supports
- Strimzi operator-based Kafka deployment information
