Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Footnote

Yes, double default, not a typo. The default setting, for the default value of the field.

A directory assignment to Uuid.ZERO conveys that the log directory is not yet known, the hosting Broker will eventually determine the hosting log directory and use AssignReplicasToDirs to update this the assignment.

RPC requests

BrokerRegistrationRequest will include the following two new fields:

...

{
"apiKey": <TBD>,
"type": "response",
"name": "AssignReplicasToDirsResponse",
"validVersions": "0",
"flexibleVersions": "0+",
"fields": [
{ "name": "ThrottleTimeMs", "type": "int32", "versions": "0+",
"about": "The duration in milliseconds for which the request was throttled due to a quota violation, or zero if the request did not violate any quota." },
{ "name": "ErrorCode", "type": "int16", "versions": "0+",
"about": "The top level response error code" },
{ "name": "Directories", "type": "[]DirectoryData", "versions": "0+", "fields": [
{ "name": "Id", "type": "uuid", "versions": "0+", "about": "The ID of the directory" },
{ "name": "Topics", "type": "[]TopicData", "versions": "0+", "fields": [
{ "name": "Name", "type": "string", "versions": "0+", "entityType": "topicName",
"about": "The name of the assigned topic" },
{ "name": "Partitions", "type": "[]PartitionData", "versions": "0+", "fields": [
{ "name": "PartitionIndex", "type": "int32", "versions": "0+",
"about": "The partition index" },
{ "name": "ErrorCode", "type": "int16", "versions": "0+",
"about": "The partition level error code" }
]}
]}
]}
]
}

A AssignReplicasToDirs request including an assignment to Uuid.ZERO conveys that the Broker is wanting to correct a replica assignment into a offline log directory, which cannot be identified.

Proposed changes

Metrics

MBean nameDescription
kafka.server:type=KafkaServer,name=NumMismatchingReplicaToLogDirAssignmentsThe number of replicas hosted by the broker that are either missing a log directory assignment in the cluster metadata or are currently found in a different log directory. 

...