In a Kafka cluster, one of the brokers serves as the controller, which is responsible for managing the states of partitions and replicas and for performing administrative tasks like reassigning partitions. The following describes the states of partitions and replicas, and the kind of operations going through the controller.
PartitionStateChange:
...
NewPartition: After creation, the partition is in the NewPartition state. In this state, the partition should have replicas assigned to it, but no leader/isr yet.
- OnlinePartition: Once a leader is elected for a partition, it is in the OnlinePartition state.
OfflinePartition: If, after successful leader election, the leader for partition dies, then the partition moves to the OfflinePartition state.
...
- nothing other than marking partition state as Offline
- nothing other than marking the partition state as NonExistentPartition
ReplicaStateChange:
- NewReplica: When replicas are created during topic creation or partition reassignment. In this state, a replica can only get become follower state change request.
- OnlineReplica: Once a replica is started and part of the assigned replicas for its partition, it is in this state. In this state, it can get either become leader or become follower state change requests.
- OfflineReplica : If a replica dies, it moves to this state. This happens when the broker hosting the replica is down.
- NonExistentReplica: If a replica is deleted, it is moved to this state.
Valid state transitions are:
- send LeaderAndIsr request with current leader and isr to the new replica and UpdateMetadata request for the partition to every live broker
- add the new replica to the assigned replica list if needed
- send LeaderAndIsr request with current leader and isr to the new replica and UpdateMetadata request for the partition to every live broker
- send StopReplicaRequest to the replica (w/o deletion)
- remove this replica from the isr and send LeaderAndIsr request (with new isr) to the leader replica and UpdateMetadata request for the partition to every live broker.
- send StopReplicaRequest to the replica (with deletion)
KafkaController Operations:
- call onNewPartitionCreation
- new partitions -> NewPartition
- all replicas of new partitions -> NewReplica
- new partitions -> OnlinePartition
- all replicas of new partitions -> OnlineReplica
- partitions w/o leader -> OfflinePartition
- partitions in OfflinePartition and NewPartition -> OnlinePartition (with OfflinePartitionLeaderSelector)
- each replica on the failed broker -> OfflineReplica
- send UpdateMetadata requests for all partitions to newly started brokers
- replicas on the newly started broker -> OnlineReplica
- partitions in OfflinePartition and NewPartition -> OnlinePartition (with OfflinePartitionLeaderSelector)
- for partitions with replicas on newly started brokers, call onPartitionReassignment to complete any outstanding partition reassignment
...
AR leader/isr
{1,2,3} 1/{1,2,3} (initial state)
{1,2,3,4,5,6} 4/{1,2,3,4,5,6} (step 7)
...