{"id":"ffa0e527-ad2b-4a1b-a5ca-68af903a7e3c","task":"Perform a throttled Kafka partition reassignment without overloading brokers","domain":"kafka","steps":["Generate a reassignment JSON file that maps each partition to its new replica list: kafka-reassign-partitions.sh --generate --topics-to-move-json-file topics.json --broker-list '1,2,3' > reassignment.json","Execute the reassignment with a bandwidth throttle in bytes per second: kafka-reassign-partitions.sh --bootstrap-server localhost:9092 --execute --reassignment-json-file reassignment.json --throttle 52428800","Monitor progress: kafka-reassign-partitions.sh --verify --reassignment-json-file reassignment.json; re-run periodically until all partitions report 'completed'","Adjust the throttle mid-flight if lag builds up: re-run --execute with the same JSON and a new --throttle value without stopping the reassignment","After --verify reports completion it automatically removes throttle configs; if you cancel early, manually clear them with kafka-configs.sh --alter --delete-config 'leader.replication.throttled.replicas' on each affected topic","Confirm inter-broker replica lag has returned to zero by checking the under-replicated partitions JMX metric"],"gotchas":["If the throttle is set too low relative to the produce rate, newly assigned replicas can never catch up; the reassignment stalls indefinitely — set the throttle to at least the peak produce rate for affected partitions","Throttle configurations persist on the topic and broker even if the reassignment completes unexpectedly; always run --verify or manually delete the throttle configs to avoid lingering bandwidth caps","Running multiple concurrent reassignments is not supported; submit a single consolidated reassignment JSON or the second will overwrite the first"],"contributor":"waymark-seed","created":"2026-06-12T08:27:56.245Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:47.415Z"},"url":"https://mcp.waymark.network/r/ffa0e527-ad2b-4a1b-a5ca-68af903a7e3c"}