This is an automated cherry-pick of #18378

Signed-off-by: ti-chi-bot <[email protected]>

pd-control.md

@@ -977,6 +977,7 @@ Encoding 格式示例：
 >> scheduler config evict-leader-scheduler        // v4.0.0 起，展示该调度器具体在哪些 store 上
 >> scheduler config evict-leader-scheduler add-store 2    // 为 store 2 添加 leader 驱逐调度
 >> scheduler config evict-leader-scheduler delete-store 2 // 为 store 2 移除 leader 驱逐调度
+<<<<<<< HEAD
 >> scheduler add shuffle-leader-scheduler         // 随机交换不同 store 上的 leader
 >> scheduler add shuffle-region-scheduler         // 随机调度不同 store 上的 Region
 >> scheduler add evict-slow-store-scheduler       // 当有且仅有一个 slow store 时将该 store 上的所有 Region 的 leader 驱逐出去
@@ -986,6 +987,42 @@ Encoding 格式示例：
 >> scheduler resume balance-region-scheduler      // 继续运行 balance-region 调度器
 >> scheduler resume all                           // 继续运行所有的调度器
 >> scheduler config balance-hot-region-scheduler  // 显示 balance-hot-region 调度器的配置
+=======
+>> scheduler add evict-slow-store-scheduler               // 当有且仅有一个 slow store 时将该 store 上的所有 Region 的 leader 驱逐出去
+>> scheduler remove grant-leader-scheduler-1              // 把对应的调度器删掉，`-1` 对应 store ID
+>> scheduler pause balance-region-scheduler 10            // 暂停运行 balance-region 调度器 10 秒
+>> scheduler pause all 10                                 // 暂停运行所有的调度器 10 秒
+>> scheduler resume balance-region-scheduler              // 继续运行 balance-region 调度器
+>> scheduler resume all                                   // 继续运行所有的调度器
+>> scheduler config balance-hot-region-scheduler          // 显示 balance-hot-region 调度器的配置
+>> scheduler describe balance-region-scheduler            // 显示 balance-region 的运行状态和相应的诊断信息
+```
+
+### `scheduler describe balance-region-scheduler`
+
+用于查看 `balance-region-scheduler` 的运行状态和相应的诊断信息。
+
+从 TiDB v6.3.0 起，PD 为 `balance-region-scheduler` 和 `balance-leader-scheduler` 提供了运行状态和简要诊断信息的功能，其余 scheduler 和 checker 暂未支持。你可以通过 `pd-ctl` 修改 [`enable-diagnostic`](/pd-configuration-file.md#enable-diagnostic-从-v630-版本开始引入) 配置项开启该功能。
+
+调度器运行状态有以下几种类型：
+
+- `disabled`：表示当前调度器不可用或被移除。
+- `paused`：表示当前调度器暂停工作。
+- `scheduling`：表示当前调度器正在生成调度。
+- `pending`：表示当前调度器无法产生调度。`pending` 状态的调度器，会返回一个概览信息，来帮助用户诊断。概览信息包含了 store 的一些状态信息，解释了它们为什么不能被选中进行调度。
+- `normal`：表示当前调度器无需进行调度。
+
+### `scheduler config balance-leader-scheduler`
+
+用于查看和控制 `balance-leader-scheduler` 策略。
+
+从 TiDB v6.0.0 起，PD 为 `balance-leader-scheduler` 引入了 `Batch` 参数，用于控制 balance-leader 执行任务的速度。你可以通过 pd-ctl 修改 `balance-leader batch` 配置项设置该功能。
+
+在 v6.0.0 前，PD 不带有该配置（即 `balance-leader batch=1`）。在 v6.0.0 或更高版本中，`balance-leader batch` 的默认值为 `4`。如果你想为该配置项设置大于 `4` 的值，你需要同时调大 [`scheduler-max-waiting-operator`](#config-show--set-option-value--placement-rules)（默认值 `5`）。同时调大两个配置项后，你才能体验预期的加速效果。
+
+```bash
+scheduler config balance-leader-scheduler set batch 3  // 将 balance-leader 调度器可以批量执行的算子大小设置为 3
+>>>>>>> def910d5d8 (pd: remove shuffle schedulers (#18378))
 ```
 
 ### `scheduler config balance-hot-region-scheduler`