12.9. 最適化プロポーザルの生成

手順

1. コンソール用にフォーマットされたドライラン最適化プロポーザルを生成するには、POST リクエストを /rebalance エンドポイントに送信します。

   • 設定された default.goals を使用するには、以下を実行します。

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

     Copy to Clipboard Toggle word wrap

     キャッシュされた最適化プロポーザルは即座に返されます。

     注記

     NotEnoughValidWindows が返された場合、Cruise Control は最適化プロポーザルを生成するために十分なメトリクスデータを記録していません。数分待ってからリクエストを再送信します。

   • 設定された default.goals ではなく、ユーザー提供の最適化ゴールを指定するには、goals パラメーターに 1 つ以上のゴールを指定します。

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

     Copy to Clipboard Toggle word wrap

     指定されたゴールを満たしている場合、キャッシュされた最適化プロポーザルは即座に返されます。それ以外の場合は、提供されたゴールを使用して新しい最適化プロポーザルが生成されます。計算には時間がかかります。この動作を強制するには、リクエストに ignore_proposal_cache=true パラメーターを追加します。

   • 設定済みのハードゴールすべてが含まれないユーザー提供の最適化ゴールを指定するには、skip_hard_goal_check=true パラメーターをリクエストに追加します。

     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

2. 応答に含まれる最適化プロポーザルを確認します。プロパティーは、保留中のクラスターリバランス操作を記述します。

   プロポーザルには、提案された最適化の概要、各デフォルトの最適化ゴールの概要、およびプロポーザルの実行後に予想されるクラスター状態が含まれます。

   以下の情報に特に注意してください。

   • Cluster load after rebalance の概要。要件を満たす場合には、概要を使用して、提案された変更の影響を評価する必要があります。
   • n inter-broker replica (y MB) moves はブローカー間でネットワークを介して移動されるデータ量を示します。値が高いほど、リバランス中の Kafka クラスターへの潜在的なパフォーマンスの影響が大きくなります。
   • n intra-broker replica (y MB) moves は、ブローカー内部で (ディスク間) でどれだけのデータを移動させるかを示します。値が大きいほど、個々のブローカーに対する潜在的なパフォーマンスの影響は大きくなります (ただし n inter-broker replica (y MB) moves の影響よりも小さい)。
   • リーダーシップ移動の数。これは、リバランス中のクラスターのパフォーマンスにほとんど影響しません。