ControllerEventManager

ControllerEventManager is responsible for processing ControllerEvents (off the controller event queue).

ControllerEventManager allows for emitting ControllerEvents (with optional clearing the event queue first).

ControllerEventManager is created exclusively for the KafkaController (when KafkaServer is requested to start up).

When started, ControllerEventManager simply requests the ControllerEventThread to start processing ControllerEvents.

ControllerEventManager is started when KafkaController is started up.

ControllerEventManager.png
Figure 1. ControllerEventManager is Created and Started With KafkaController

ControllerEventManager is in one of the possible ControllerStates.

Note
The state of ControllerEventManager is exactly the state of the owning KafkaController.
Table 1. ControllerEventManager’s Internal Properties (e.g. Registries and Counters)
Name Description

queue

Controller event queue

queue is a Java java.util.concurrent.LinkedBlockingQueue (i.e. an optionally-bounded blocking queue based on linked nodes that orders elements in first-in-first-out fashion) of ControllerEvents.

_state

thread

ControllerEventThread with controller-event-thread thread name

Creating ControllerEventManager Instance

ControllerEventManager takes the following when created:

  • Controller ID (i.e. the broker.id of the broker)

  • rateAndTimeMetrics collection (Map[ControllerState, KafkaTimer])

  • eventProcessedListener (ControllerEvent ⇒ Unit)

  • controllerMovedListener (() ⇒ Unit)

ControllerEventManager initializes the internal registries and counters.

Emitting (Enqueuing) Controller Event — put Method

put(event: ControllerEvent): Unit

put simply inserts the ControllerEvent at the end of the controller event queue.

Note

put is used when:

  • ControllerEventManager is requested to clearAndPut

  • KafkaController is requested to do its operation and emits various events

Starting ControllerEventManager (and ControllerEventThread) — start Method

start(): Unit
Note
ControllerEventThread is a ShutdownableThread that triggers doWork() method when started.
Note
start is used exclusively when KafkaController is requested to start up (when KafkaServer is requested to start).

clearAndPut Method

clearAndPut(event: ControllerEvent): Unit

clearAndPut simply clears the controller event queue and enqueues the controller event.

Note

clearAndPut is used when:

  • ControllerEventManager is requested to close

  • KafkaController is requested to startup (and registers a StateChangeHandler that emits a Expire event when beforeInitializingSession)

Closing Up — close Method

close(): Unit

close simply clears the event queue and emits a ShutdownEventThread event.

In the end, close waits until the shutdown is complete. You should see the following INFO message in the logs:

Shutdown completed
Note
close is used exclusively when KafkaController is requested to shutdown.

results matching ""

    No results matching ""