Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(refactor): updates the cruise control rebalance concepts #10810

Merged
merged 11 commits into from
Nov 15, 2024
Merged
Original file line number Diff line number Diff line change
Expand Up @@ -5,17 +5,21 @@
[id='cruise-control-concepts-{context}']
= Using Cruise Control for cluster rebalancing

include::../../modules/cruise-control/con-cruise-control-description.adoc[leveloffset=+1]
[role="_abstract"]
Cruise Control is an open-source system for Kafka that monitors broker loads and rebalances partitions to optimize use of resources across the cluster.
Rebalances help with running a more balanced Kafka cluster that uses brokers more efficiently.

NOTE: Strimzi provides xref:config-examples-{context}[example configuration files for Cruise Control].

include::../../modules/cruise-control/con-cruise-control-overview.adoc[leveloffset=+1]
As Kafka clusters evolve, some brokers may become overloaded while others remain underutilized.
Cruise Control addresses this imbalance by modeling resource utilization at the replica level--including, CPU, disk, network load--and generating optimization proposals (which you can approve or reject) for balanced partition assignments based on configurable optimization goals.

include::../../modules/cruise-control/con-optimization-goals.adoc[leveloffset=+1]
Optimization proposals are configured and generated using a `KafkaRebalance` resource.
You can configure the resource using an annotation so that optimization proposals are approved automatically or manually.

include::../../modules/cruise-control/con-optimization-proposals.adoc[leveloffset=+1]
NOTE: Strimzi provides xref:config-examples-{context}[example configuration files for Cruise Control].

include::../../modules/cruise-control/con-rebalance-performance.adoc[leveloffset=+1]
//overview and concepts
include::../../modules/cruise-control/con-cruise-control-overview.adoc[leveloffset=+1]
include::../../modules/cruise-control/con-rebalance-performance.adoc[leveloffset=+2]

include::../../modules/cruise-control/proc-configuring-deploying-cruise-control.adoc[leveloffset=+1]

Expand Down

This file was deleted.

539 changes: 495 additions & 44 deletions documentation/modules/cruise-control/con-cruise-control-overview.adoc

Large diffs are not rendered by default.

222 changes: 0 additions & 222 deletions documentation/modules/cruise-control/con-optimization-goals.adoc

This file was deleted.

Loading
Loading