13.9. 生成优化建议

流程

1. 使用对 /rebalance、/add_broker 或 /remove_broker 端点的 POST 请求来生成优化建议。

   使用默认目标到 /rebalance 的请求示例

   curl -v -X POST 'cruise-control-server:9090/kafkacruisecontrol/rebalance'

   Copy to Clipboard Toggle word wrap

   缓存的优化提议会立即返回。

   注意

   如果返回 NotEnoughValidWindows，Cruise Control 尚未记录足够的指标数据，以生成优化器。等待几分钟，然后重新发送请求。

   使用指定目标向 /rebalance 的请求示例

   curl -v -X POST 'cruise-control-server:9090/kafkacruisecontrol/rebalance?goals=RackAwareGoal,ReplicaCapacityGoal'

   Copy to Clipboard Toggle word wrap

   如果请求满足提供的目标，则立即返回缓存的优化提议。否则，会使用提供的目标生成新的优化方案；这需要更长的时间来计算。您可以通过在请求中添加 ignore_proposal_cache=true 参数来强制实施此行为。

   使用指定目标向 /rebalance 的请求示例，而无需硬目标

   curl -v -X POST 'cruise-control-server:9090/kafkacruisecontrol/rebalance?goals=RackAwareGoal,ReplicaCapacityGoal,ReplicaDistributionGoal&skip_hard_goal_check=true'

   Copy to Clipboard Toggle word wrap

   包含指定代理的 /add_broker 请求示例

   curl -v -X POST 'cruise-control-server:9090/kafkacruisecontrol/add_broker?brokerid=3,4'

   Copy to Clipboard Toggle word wrap

   请求仅包含新代理的 ID。例如，此请求添加 ID 为 3 和 4 的代理。在重新平衡时，副本会从现有代理移到新代理中。

   排除指定代理的 /remove_broker 请求示例

   curl -v -X POST 'cruise-control-server:9090/kafkacruisecontrol/remove_broker?brokerid=3,4'

   Copy to Clipboard Toggle word wrap

   请求仅包含被排除的代理 ID。例如，此请求排除 ID 为 3 和 4 的代理。在重新平衡时，副本会从要删除的代理移到其他现有代理中。

   注意

   如果要删除的代理包含排除主题，则副本仍会移动。

2. 查看响应中包含的优化提议。属性描述待处理的集群重新平衡操作。

   提议包含所提出优化的高级概述，以及各个默认优化目标的总结，以及执行过程后的预期集群状态。

   请特别注意以下信息：

   • 在 重新平衡概述后集群负载。如果满足您的要求，您应该使用高级别概述来评估所提议更改的影响。
   • n inter-broker replica (y MB) moves 表示在代理间移动的数据量。值越大，重新平衡过程中对 Kafka 集群的潜在性能影响越大。
   • n intra-broker replica (y MB) moves 表示代理本身（生成磁盘）中多少数据。数值越大，对各个代理的潜在性能影响越大（尽管小于 n inter-broker replica (y MB) moves）。
   • 领导机移动的数量。这在重新平衡过程中对集群的性能有可忽略的影响。