Kafka Partition Assignment Visualizer

See how partition replicas and leadership actually sit across your brokers. Replica counts can be perfectly even while one broker leads everything, and leadership is what carries the traffic.

Give a rack per broker id and every partition is checked for spreading across them. Leave it empty to skip that check. Rack placement is applied when a topic is created and is not maintained afterwards, so a reassignment can quietly undo it.

Paste below, or drop a file anywhere on this panel

Or drop a file anywhere on this panel. Nothing is uploaded: the analysis runs in this tab.

The answer appears here

Paste on the left and press Visualize. Nothing leaves this tab.

Examples

Real input you can load into the tool above. Each one shows a different thing going wrong, because that is what the tool is for.

Leader skew and shrunk ISR

Every leader on one broker, plus a partition below its replication factor

Topic: orders	Partition: 0	Leader: 1	Replicas: 1,2,3	Isr: 1,2
Topic: orders	Partition: 1	Leader: 1	Replicas: 1,2	Isr: 1

A healthy topic

Leaders spread and every ISR full, for comparison

Topic: orders	Partition: 0	Leader: 1	Replicas: 1,2,3	Isr: 1,2,3
Topic: orders	Partition: 1	Leader: 2	Replicas: 2,3,1	Isr: 2,3,1
Topic: orders	Partition: 2	Leader: 3	Replicas: 3,1,2	Isr: 3,1,2

Common mistakes

These are the ones that fail silently. The config is accepted, nothing raises an error, and the consequence arrives later.

  1. Leaving every leader on one broker

    Leaders take all the client traffic. Concentrated leaders mean one broker saturated and the rest idle.

    Instead:Run the preferred leader election, and check auto.leader.rebalance.enable.

  2. Ignoring a shrunk ISR

    A partition with fewer in-sync replicas than min.insync.replicas rejects acks=all writes, and the producer error names the topic rather than the cause.

    Instead:Alert on UnderMinIsrPartitionCount.

  3. Assigning replicas without rack awareness

    Without broker.rack, replicas can land in one failure domain and a single rack loss takes the partition offline.

    Instead:Set broker.rack and reassign.

Replica count is not the load, leadership is

A cluster can be perfectly even on replicas and badly uneven on leadership, and only the second one decides where the traffic goes.

Leadership follows the first replica in each list

Every produce and every consumer fetch for a partition goes to that partition's leader. The first entry in a replica list is the preferred leader, and a preferred leader election puts leadership back exactly there, so the spread of first replicas is what leadership settles to whatever it happens to be right now. A reassignment that distributes replica sets evenly while starting every list with the same broker gives you an even-looking cluster that fails at one machine.

# even replicas, terrible leadership
0: [1,2,3]
1: [1,3,2]
2: [1,2,3]
  -> broker 1 holds 3 replicas, same as the others,
     and leads all three partitions

Preferred and current leadership are different numbers

After a broker restart, leadership has moved to other replicas and does not come back on its own until auto.leader.rebalance.enable acts on its own schedule, or until you run a preferred election. Paste a kafka-topics --describe output and both columns appear side by side, which is the quickest way to see how much a preferred election would actually change.

kafka-leader-election.sh --bootstrap-server broker:9092 \
  --election-type preferred --all-topic-partitions

Rack awareness is applied at creation, not maintained

With broker.rack set, Kafka spreads a new topic's replicas across racks. A manual reassignment can undo that and nothing recomputes it or complains. A partition whose replicas share a rack loses every copy when that rack does, and with min.insync.replicas=2 it stops accepting writes the moment the rack goes rather than degrading. Give this page a broker-to-rack mapping and it checks every partition against the racks available.

Under-replicated is a different problem from unbalanced

A replica outside the ISR does not count toward acks=all and cannot be elected leader without unclean election. If the in-sync count falls below min.insync.replicas the partition refuses writes, which is the setting working as intended and looks like a producer fault. Worth fixing the lag before touching any configuration, because lowering min.insync.replicas to restore writes trades away exactly the durability it was set for.

What this reads

Either a reassignment JSON, the kind kafka-reassign-partitions takes and produces, or the output of kafka-topics --describe. The second carries current leaders and ISR and so gives a fuller answer. Racks go in the box above as id=rack pairs. Nothing here contacts a cluster: it reads what you paste.

More kafka tools

Kafka Confluent Wire Format Decoder The five junk bytes in front of your payload Kafka Key to Partition Mapper Which partition does this key land on? Kafka Topic Name Validator Legal, risky, or 249 characters too long? Kafka Replication Safety Checker How many brokers can you lose Kafka Producer Config Linter Will it start, and will it lose a record? Kafka Message Payload Decoder The first five bytes are usually not data Kafka Connect Source Connector Generator tasks.max is a ceiling, not a count Kafka Connect Sink Connector Generator A dead letter queue with no context headers is a pile of records Kafka Connect SMT Chain Builder The order is the transforms list Kafka MirrorMaker 2 Config Generator It renames every topic by default Kafka Partition Reassignment Generator The throttle is not optional Strimzi Kafka Resource Generator Without the cluster label, nothing happens Kafka mTLS Config Generator The certificate is the identity Kafka Schema Registry Config Generator The compatibility direction is your deployment order Kafka Exactly-Once Config Generator Half of it is worse than none Kafka Broker and KRaft Config Generator The internal topics that break a one-broker cluster Kafka Quota Generator Byte rates are per broker, not per cluster Kafka Streams Config Generator application.id is four things at once Kafka Connect Worker Config Generator Security three times, or the tasks fail Kafka Retention and Unit Converter log.retention.hours does not take milliseconds Kafka Timestamp Converter Two sentinels and two meanings Kafka .properties to YAML Converter Dotted keys stay flat Kafka Streams Internal Topic Predictor Create them before Streams does Kafka ACL Generator The grant you forgot is on another resource type Kafka Topic Config Generator min.insync.replicas is the one that matters Kafka client.properties Generator The file every CLI tool asks for Kafka Producer Config Generator No password field, on purpose Kafka Consumer Config Generator The commit mode decides the semantics Kafka Disk and Retention Calculator retention.bytes is per partition Kafka Partition Count Calculator The number you can never reduce Kafka Cluster Sizing Calculator The traffic no client metric shows Kafka Consumer Lag Catch-Up Calculator Whether it ever clears, not just when Kafka Producer Batching Calculator linger.ms=0 still batches Kafka Segment and Index Sizing Why retention.ms is a lower bound Kafka Rebalance Duration Estimator What a rolling restart really costs Kafka Cost Estimator Your rates, so nothing goes stale Kafka Config Explorer by Version The answer depends on the release Kafka Default Config Reference What moved under a config you never edited Kafka OAuth Bearer Token Decoder Will Kafka accept it, and can it refresh Kafka Record Header Viewer Headers are a list, not a map Kafka Topic Regex Subscription Tester Kafka matches the whole name Kafka ACL Permission Matrix Viewer DENY beats every ALLOW Kafka Connect Config Validator The mistakes that raise no error Kafka Consumer Group Id Validator Which broker coordinates the group Kafka Consumer Assignment Visualizer The three assignors disagree Kafka ZooKeeper to KRaft Config Converter The authorizer class nobody changes Kafka Config to Strimzi Half of it belongs elsewhere Kafka Docker Compose Generator (KRaft) Reachable from inside and outside Kafka JAAS Config Decoder The line that stops SASL working Kafka CRC32C Calculator Which CRC, over which bytes Kafka Config Upgrade Checker What breaks when you upgrade Kafka Kafka Config Diff Which change actually changed something Kafka Consumer Config Linter Why the group rebalances, and where the records went Kafka Avro Schema Validator The defaults Avro accepts and rejects Kafka Schema Compatibility Checker What the registry will say, before you ask it Kafka Avro Schema Diff Which direction each change breaks Kafka Compression Comparison Measured on your bytes Kafka Delivery Semantics Exactly-once has a consumer half Kafka ksqlDB Query Builder It looks like SQL and the rules are not Kafka Connect SMT Predicate Tester negate reads backwards Kafka Streams Topology Viewer Count the repartitions Kafka Connect Pipeline Visualizer The order things really run in Kafka Protobuf Binary Decoder Works without the .proto Kafka Protobuf JSON Converter Why your JSON does not round-trip Kafka Protobuf to Avro Schema What does not survive the conversion Kafka Avro Binary Decoder Wrong schema, no error Kafka Avro JSON Converter Why the console producer rejects your line Kafka Avro Sample Data Generator Records that actually serialize Kafka JSON to Avro Schema What JSON cannot tell you Kafka JSON Schema to Avro What does not survive the conversion Kafka SASL JAAS Generator One login module, four syntaxes Kafka CLI Command Builder kcat is librdkafka, not Kafka

Elsewhere on the site