conduktor.io ↗

Kafka DescribeCluster Request Wire Format v2 — Binary Protocol Layout

What is DescribeCluster?

Returns the authoritative list of brokers, the active controller, and cluster-level authorized operations via AdminClient.describeCluster(). Unlike Metadata, this can filter by endpoint type (broker vs controller), which matters in KRaft mode where controllers may not be brokers.

Wire Diagram

Request Header · flexible
message_size int32 · 4B
api_key int16 · 2B
api_version int16 · 2B
correlation_id int32 · 4B
client_id string (compact)
tagged var
DescribeClusterRequest v2
IncludeClusterAuthorizedOperations bool · 1B
EndpointType int8 · 1B
IncludeFencedBrokers bool · 1B
tagged var

Schema & Example

Schema
{
  "IncludeClusterAuthorizedOperations": bool,
  "EndpointType": int8,
  "IncludeFencedBrokers": bool
}
Example
{
  "IncludeClusterAuthorizedOperations": 2,
  "EndpointType": 1,
  "IncludeFencedBrokers": true
}