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

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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.
PaulRMellor marked this conversation as resolved.
Show resolved Hide resolved
Rebalances help with running a more balanced Kafka cluster that uses brokers more efficiently.
PaulRMellor marked this conversation as resolved.
Show resolved Hide resolved

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--CPU, disk, network load--and generating optimization proposals (that you can approve or reject) for balanced partition assignments based on configurable optimization goals.
PaulRMellor marked this conversation as resolved.
Show resolved Hide resolved

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.

535 changes: 491 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