From 24da36583223e9b4427bef8d2e6a1a53c395f6a8 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Wed, 1 Jul 2026 14:32:30 +0800 Subject: [PATCH 1/7] Create empty translation PR From 2c3c598597fc1fea50bf948f44d0f21272bc784a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 1 Jul 2026 06:34:07 +0000 Subject: [PATCH 2/7] Auto-sync: Update Chinese docs from English PR Synced from: https://github.com/pingcap/docs/pull/23035 Target PR: https://github.com/pingcap/docs-cn/pull/21754 AI Provider: azure Co-authored-by: github-actions[bot] --- tikv-configuration-file.md | 62 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 765a885cd758..05cc96c6a1e6 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2745,6 +2745,68 @@ Raft Engine 相关的配置项。 + `conservative`：此策略会优先确保系统资源被充分利用，允许低优先级任务根据需要充分使用系统可用资源，因此对高优先级任务的性能影响更大。 + 默认值：`moderate` +### `bg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本引入 + ++ 指定开始对后台任务进行限流时的 CPU 使用率百分比阈值。后台任务是指被标记为后台资源组的任务，包括 `import`、`br`、`ddl` 和 `stats` 任务类型（参见[后台任务类型](/tidb-resource-control-background-tasks.md#background-parameters)）。当 CPU 使用率达到该值时，TiKV 开始减少分配给后台任务的资源预算。随着 CPU 使用率从该阈值升高并接近 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-new-in-v857-and-v900)，该预算会从配置的上限按线性方式缩减，最低降至 1 个 CPU 核心。 ++ 默认值：`60.0` ++ 单位：百分比 (%) + +### `fg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本引入 + ++ 指定完全激活前台流量保护时的 CPU 使用率百分比阈值。当 CPU 使用率达到该值时，后台任务会被完全限流到其最低下限，后台使用率预算也会被限制在该值。该阈值必须大于 [`bg-cpu-throttle-threshold`](#bg-cpu-throttle-threshold-new-in-v857-and-v900)。 ++ 默认值：`70.0` ++ 单位：百分比 (%) + +### `bg-compaction-pressure-threshold` v8.5.7 和 v9.0.0 版本引入 + ++ 指定开始对后台写 I/O 进行限流时的阈值，该阈值表示为 [`storage.flow-control.soft-pending-compaction-bytes-limit`](#soft-pending-compaction-bytes-limit) 的百分比。低于该阈值时，后台写 I/O 会逐步增加至 [`bg-write-io-ceiling`](#bg-write-io-ceiling-new-in-v857-and-v900)。达到或超过该阈值时，随着 compaction 压力接近 100%，TiKV 会将后台写 I/O 按线性方式逐步降低至 [`bg-write-io-floor`](#bg-write-io-floor-new-in-v857-and-v900)。 ++ 默认值：`70.0` ++ 单位：百分比 (%) + +### `bg-write-io-ceiling` v8.5.7 和 v9.0.0 版本引入 + ++ 指定当 compaction 压力低于 [`bg-compaction-pressure-threshold`](#bg-compaction-pressure-threshold-new-in-v857-and-v900) 时，后台任务允许的最大写 I/O 速率。 ++ 默认值：`"100GB"` ++ 单位：字节每秒 + +### `bg-write-io-floor` v8.5.7 和 v9.0.0 版本引入 + ++ 指定即使在最大 compaction 压力下也能保证分配给后台任务的最小写 I/O 速率。该下限可防止后台任务被完全饿死。 ++ 默认值：`"10MB"` ++ 单位：字节每秒 + +### `enable-fair-scheduling` v8.5.7 和 v9.0.0 版本引入 + ++ 控制是否为读请求启用基于 RU 的两阶段公平调度。启用后，当前 RU 消耗速率超过其历史基线的资源组会被放入统一读线程池队列中的较低优先级阶段，从而在不硬性拒绝请求的情况下保护持续性工作负载免受流量突增影响。 ++ 默认值：`false` + +### `enable-read-admission-control` v8.5.7 和 v9.0.0 版本引入 + ++ 控制是否为读请求启用准入控制。启用后，当 CPU 使用率超过 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-new-in-v857-and-v900) 时，来自超出基线资源组的读请求会被延迟，或以 `SchedTooBusy` 拒绝。该配置仅在同时启用 [`enable-fair-scheduling`](#enable-fair-scheduling-new-in-v857-and-v900) 时生效。 ++ 默认值：`false` + +### `enable-write-admission-control` v8.5.7 和 v9.0.0 版本引入 + ++ 控制是否为写请求启用准入控制。启用后，当 CPU 使用率超过 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-new-in-v857-and-v900) 时，来自超出基线资源组的写请求会被延迟，或以 `SchedTooBusy` 拒绝。该配置仅在同时启用 [`enable-fair-scheduling`](#enable-fair-scheduling-new-in-v857-and-v900) 时生效。 ++ 默认值：`false` + +### `historical-usage-window-mins` v8.5.7 和 v9.0.0 版本引入 + ++ 指定 TiKV 用于计算各资源组历史 RU 基线的滑动时间窗口大小（单位：分钟）。较大的窗口可以平滑短期突发流量，而较小的窗口会使基线对近期使用情况更敏感。有效范围：`2-60`。**你必须重启 TiKV 才能使对此配置的更改生效。** ++ 默认值：`15` ++ 单位：分钟 + +### `baseline-burst-pct` v8.5.7 和 v9.0.0 版本引入 + ++ 指定资源组的历史 RU 基线之上可保留的余量百分比，超过该值后 TiKV 会认为该资源组“超出基线”。例如，如果将该值设置为 `20.0`，则资源组的历史 RU 速率必须超过 1.2×，公平调度才会降低其优先级，或准入控制才会对其进行限制。 ++ 默认值：`20.0` ++ 单位：百分比 (%) + +### `admission-max-delayed-count` v8.5.7 和 v9.0.0 版本引入 + ++ 指定 TiKV 在准入控制延迟队列中可保留的最大并发请求数（读写合计）。达到该限制后，TiKV 会立即拒绝额外的超出基线请求，而不是继续延迟它们。将该值设置为 `0` 表示并发延迟数不受限制。 ++ 默认值：`10000` + ## split [Load Base Split](/configure-load-base-split.md) 相关的配置项。 From 784ecc445151860efb2734159b175716c706fede Mon Sep 17 00:00:00 2001 From: lilin90 Date: Wed, 1 Jul 2026 14:51:08 +0800 Subject: [PATCH 3/7] Update wording for consistency --- tikv-configuration-file.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 05cc96c6a1e6..daff9bf421b3 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2745,64 +2745,64 @@ Raft Engine 相关的配置项。 + `conservative`：此策略会优先确保系统资源被充分利用，允许低优先级任务根据需要充分使用系统可用资源，因此对高优先级任务的性能影响更大。 + 默认值：`moderate` -### `bg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本引入 +### `bg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本开始引入 + 指定开始对后台任务进行限流时的 CPU 使用率百分比阈值。后台任务是指被标记为后台资源组的任务，包括 `import`、`br`、`ddl` 和 `stats` 任务类型（参见[后台任务类型](/tidb-resource-control-background-tasks.md#background-parameters)）。当 CPU 使用率达到该值时，TiKV 开始减少分配给后台任务的资源预算。随着 CPU 使用率从该阈值升高并接近 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-new-in-v857-and-v900)，该预算会从配置的上限按线性方式缩减，最低降至 1 个 CPU 核心。 + 默认值：`60.0` + 单位：百分比 (%) -### `fg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本引入 +### `fg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本开始引入 + 指定完全激活前台流量保护时的 CPU 使用率百分比阈值。当 CPU 使用率达到该值时，后台任务会被完全限流到其最低下限，后台使用率预算也会被限制在该值。该阈值必须大于 [`bg-cpu-throttle-threshold`](#bg-cpu-throttle-threshold-new-in-v857-and-v900)。 + 默认值：`70.0` + 单位：百分比 (%) -### `bg-compaction-pressure-threshold` v8.5.7 和 v9.0.0 版本引入 +### `bg-compaction-pressure-threshold` v8.5.7 和 v9.0.0 版本开始引入 + 指定开始对后台写 I/O 进行限流时的阈值，该阈值表示为 [`storage.flow-control.soft-pending-compaction-bytes-limit`](#soft-pending-compaction-bytes-limit) 的百分比。低于该阈值时，后台写 I/O 会逐步增加至 [`bg-write-io-ceiling`](#bg-write-io-ceiling-new-in-v857-and-v900)。达到或超过该阈值时，随着 compaction 压力接近 100%，TiKV 会将后台写 I/O 按线性方式逐步降低至 [`bg-write-io-floor`](#bg-write-io-floor-new-in-v857-and-v900)。 + 默认值：`70.0` + 单位：百分比 (%) -### `bg-write-io-ceiling` v8.5.7 和 v9.0.0 版本引入 +### `bg-write-io-ceiling` v8.5.7 和 v9.0.0 版本开始引入 + 指定当 compaction 压力低于 [`bg-compaction-pressure-threshold`](#bg-compaction-pressure-threshold-new-in-v857-and-v900) 时，后台任务允许的最大写 I/O 速率。 + 默认值：`"100GB"` + 单位：字节每秒 -### `bg-write-io-floor` v8.5.7 和 v9.0.0 版本引入 +### `bg-write-io-floor` v8.5.7 和 v9.0.0 版本开始引入 + 指定即使在最大 compaction 压力下也能保证分配给后台任务的最小写 I/O 速率。该下限可防止后台任务被完全饿死。 + 默认值：`"10MB"` + 单位：字节每秒 -### `enable-fair-scheduling` v8.5.7 和 v9.0.0 版本引入 +### `enable-fair-scheduling` v8.5.7 和 v9.0.0 版本开始引入 + 控制是否为读请求启用基于 RU 的两阶段公平调度。启用后，当前 RU 消耗速率超过其历史基线的资源组会被放入统一读线程池队列中的较低优先级阶段，从而在不硬性拒绝请求的情况下保护持续性工作负载免受流量突增影响。 + 默认值：`false` -### `enable-read-admission-control` v8.5.7 和 v9.0.0 版本引入 +### `enable-read-admission-control` v8.5.7 和 v9.0.0 版本开始引入 + 控制是否为读请求启用准入控制。启用后，当 CPU 使用率超过 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-new-in-v857-and-v900) 时，来自超出基线资源组的读请求会被延迟，或以 `SchedTooBusy` 拒绝。该配置仅在同时启用 [`enable-fair-scheduling`](#enable-fair-scheduling-new-in-v857-and-v900) 时生效。 + 默认值：`false` -### `enable-write-admission-control` v8.5.7 和 v9.0.0 版本引入 +### `enable-write-admission-control` v8.5.7 和 v9.0.0 版本开始引入 + 控制是否为写请求启用准入控制。启用后，当 CPU 使用率超过 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-new-in-v857-and-v900) 时，来自超出基线资源组的写请求会被延迟，或以 `SchedTooBusy` 拒绝。该配置仅在同时启用 [`enable-fair-scheduling`](#enable-fair-scheduling-new-in-v857-and-v900) 时生效。 + 默认值：`false` -### `historical-usage-window-mins` v8.5.7 和 v9.0.0 版本引入 +### `historical-usage-window-mins` v8.5.7 和 v9.0.0 版本开始引入 + 指定 TiKV 用于计算各资源组历史 RU 基线的滑动时间窗口大小（单位：分钟）。较大的窗口可以平滑短期突发流量，而较小的窗口会使基线对近期使用情况更敏感。有效范围：`2-60`。**你必须重启 TiKV 才能使对此配置的更改生效。** + 默认值：`15` + 单位：分钟 -### `baseline-burst-pct` v8.5.7 和 v9.0.0 版本引入 +### `baseline-burst-pct` v8.5.7 和 v9.0.0 版本开始引入 + 指定资源组的历史 RU 基线之上可保留的余量百分比，超过该值后 TiKV 会认为该资源组“超出基线”。例如，如果将该值设置为 `20.0`，则资源组的历史 RU 速率必须超过 1.2×，公平调度才会降低其优先级，或准入控制才会对其进行限制。 + 默认值：`20.0` + 单位：百分比 (%) -### `admission-max-delayed-count` v8.5.7 和 v9.0.0 版本引入 +### `admission-max-delayed-count` v8.5.7 和 v9.0.0 版本开始引入 + 指定 TiKV 在准入控制延迟队列中可保留的最大并发请求数（读写合计）。达到该限制后，TiKV 会立即拒绝额外的超出基线请求，而不是继续延迟它们。将该值设置为 `0` 表示并发延迟数不受限制。 + 默认值：`10000` From 6aec69aca056e44d2336852c1a8bfe435a9ce8ad Mon Sep 17 00:00:00 2001 From: lilin90 Date: Wed, 1 Jul 2026 15:34:49 +0800 Subject: [PATCH 4/7] Update anchor links --- tikv-configuration-file.md | 32 +++++++++++++++++--------------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index daff9bf421b3..e7ee307d3eb0 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2746,63 +2746,65 @@ Raft Engine 相关的配置项。 + 默认值：`moderate` ### `bg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本开始引入 +### `bg-cpu-throttle-threshold` 从 v8.5.7 和 v9.0.0 版本开始引入 -+ 指定开始对后台任务进行限流时的 CPU 使用率百分比阈值。后台任务是指被标记为后台资源组的任务，包括 `import`、`br`、`ddl` 和 `stats` 任务类型（参见[后台任务类型](/tidb-resource-control-background-tasks.md#background-parameters)）。当 CPU 使用率达到该值时，TiKV 开始减少分配给后台任务的资源预算。随着 CPU 使用率从该阈值升高并接近 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-new-in-v857-and-v900)，该预算会从配置的上限按线性方式缩减，最低降至 1 个 CPU 核心。 ++ 指定开始对后台任务进行限流时的 CPU 使用率百分比阈值。后台任务是指被标记为后台资源组的任务，包括 `import`、`br`、`ddl` 和 `stats` 任务类型（参见[后台任务类型](/tidb-resource-control-background-tasks.md#background-parameters)）。当 CPU 使用率达到该值时，TiKV 开始减少分配给后台任务的资源预算。随着 CPU 使用率从该阈值升高并接近 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-从-v857-和-v900-版本开始引入)，该预算会从配置的上限按线性方式缩减，最低降至 1 个 CPU 核心。 + 默认值：`60.0` + 单位：百分比 (%) ### `fg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本开始引入 +### `fg-cpu-throttle-threshold` 从 v8.5.7 和 v9.0.0 版本开始引入 -+ 指定完全激活前台流量保护时的 CPU 使用率百分比阈值。当 CPU 使用率达到该值时，后台任务会被完全限流到其最低下限，后台使用率预算也会被限制在该值。该阈值必须大于 [`bg-cpu-throttle-threshold`](#bg-cpu-throttle-threshold-new-in-v857-and-v900)。 ++ 指定完全激活前台流量保护时的 CPU 使用率百分比阈值。当 CPU 使用率达到该值时，后台任务会被完全限流到其最低下限，后台使用率预算也会被限制在该值。该阈值必须大于 [`bg-cpu-throttle-threshold`](#bg-cpu-throttle-threshold-从-v857-和-v900-版本开始引入)。 + 默认值：`70.0` + 单位：百分比 (%) -### `bg-compaction-pressure-threshold` v8.5.7 和 v9.0.0 版本开始引入 +### `bg-compaction-pressure-threshold` 从 v8.5.7 和 v9.0.0 版本开始引入 -+ 指定开始对后台写 I/O 进行限流时的阈值，该阈值表示为 [`storage.flow-control.soft-pending-compaction-bytes-limit`](#soft-pending-compaction-bytes-limit) 的百分比。低于该阈值时，后台写 I/O 会逐步增加至 [`bg-write-io-ceiling`](#bg-write-io-ceiling-new-in-v857-and-v900)。达到或超过该阈值时，随着 compaction 压力接近 100%，TiKV 会将后台写 I/O 按线性方式逐步降低至 [`bg-write-io-floor`](#bg-write-io-floor-new-in-v857-and-v900)。 ++ 指定开始对后台写 I/O 进行限流时的阈值，该阈值表示为 [`storage.flow-control.soft-pending-compaction-bytes-limit`](#soft-pending-compaction-bytes-limit) 的百分比。低于该阈值时，后台写 I/O 会逐步增加至 [`bg-write-io-ceiling`](#bg-write-io-ceiling-从-v857-和-v900-版本开始引入)。达到或超过该阈值时，随着 compaction 压力接近 100%，TiKV 会将后台写 I/O 按线性方式逐步降低至 [`bg-write-io-floor`](#bg-write-io-floor-从-v857-和-v900-版本开始引入)。 + 默认值：`70.0` + 单位：百分比 (%) -### `bg-write-io-ceiling` v8.5.7 和 v9.0.0 版本开始引入 +### `bg-write-io-ceiling` 从 v8.5.7 和 v9.0.0 版本开始引入 -+ 指定当 compaction 压力低于 [`bg-compaction-pressure-threshold`](#bg-compaction-pressure-threshold-new-in-v857-and-v900) 时，后台任务允许的最大写 I/O 速率。 ++ 指定当 compaction 压力低于 [`bg-compaction-pressure-threshold`](#bg-compaction-pressure-threshold-从-v857-和-v900-版本开始引入) 时，后台任务允许的最大写 I/O 速率。 + 默认值：`"100GB"` + 单位：字节每秒 -### `bg-write-io-floor` v8.5.7 和 v9.0.0 版本开始引入 +### `bg-write-io-floor` 从 v8.5.7 和 v9.0.0 版本开始引入 + 指定即使在最大 compaction 压力下也能保证分配给后台任务的最小写 I/O 速率。该下限可防止后台任务被完全饿死。 + 默认值：`"10MB"` + 单位：字节每秒 -### `enable-fair-scheduling` v8.5.7 和 v9.0.0 版本开始引入 +### `enable-fair-scheduling` 从 v8.5.7 和 v9.0.0 版本开始引入 + 控制是否为读请求启用基于 RU 的两阶段公平调度。启用后，当前 RU 消耗速率超过其历史基线的资源组会被放入统一读线程池队列中的较低优先级阶段，从而在不硬性拒绝请求的情况下保护持续性工作负载免受流量突增影响。 + 默认值：`false` -### `enable-read-admission-control` v8.5.7 和 v9.0.0 版本开始引入 +### `enable-read-admission-control` 从 v8.5.7 和 v9.0.0 版本开始引入 -+ 控制是否为读请求启用准入控制。启用后，当 CPU 使用率超过 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-new-in-v857-and-v900) 时，来自超出基线资源组的读请求会被延迟，或以 `SchedTooBusy` 拒绝。该配置仅在同时启用 [`enable-fair-scheduling`](#enable-fair-scheduling-new-in-v857-and-v900) 时生效。 ++ 控制是否为读请求启用准入控制。启用后，当 CPU 使用率超过 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-从-v857-和-v900-版本开始引入) 时，来自超出基线资源组的读请求会被延迟，或以 `SchedTooBusy` 拒绝。该配置仅在同时启用 [`enable-fair-scheduling`](#enable-fair-scheduling-从-v857-和-v900-版本开始引入) 时生效。 + 默认值：`false` -### `enable-write-admission-control` v8.5.7 和 v9.0.0 版本开始引入 +### `enable-write-admission-control` 从 v8.5.7 和 v9.0.0 版本开始引入 -+ 控制是否为写请求启用准入控制。启用后，当 CPU 使用率超过 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-new-in-v857-and-v900) 时，来自超出基线资源组的写请求会被延迟，或以 `SchedTooBusy` 拒绝。该配置仅在同时启用 [`enable-fair-scheduling`](#enable-fair-scheduling-new-in-v857-and-v900) 时生效。 ++ 控制是否为写请求启用准入控制。启用后，当 CPU 使用率超过 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-从-v857-和-v900-版本开始引入) 时，来自超出基线资源组的写请求会被延迟，或以 `SchedTooBusy` 拒绝。该配置仅在同时启用 [`enable-fair-scheduling`](#enable-fair-scheduling-从-v857-和-v900-版本开始引入) 时生效。 + 默认值：`false` -### `historical-usage-window-mins` v8.5.7 和 v9.0.0 版本开始引入 +### `historical-usage-window-mins` 从 v8.5.7 和 v9.0.0 版本开始引入 + 指定 TiKV 用于计算各资源组历史 RU 基线的滑动时间窗口大小（单位：分钟）。较大的窗口可以平滑短期突发流量，而较小的窗口会使基线对近期使用情况更敏感。有效范围：`2-60`。**你必须重启 TiKV 才能使对此配置的更改生效。** + 默认值：`15` + 单位：分钟 -### `baseline-burst-pct` v8.5.7 和 v9.0.0 版本开始引入 +### `baseline-burst-pct` 从 v8.5.7 和 v9.0.0 版本开始引入 + 指定资源组的历史 RU 基线之上可保留的余量百分比，超过该值后 TiKV 会认为该资源组“超出基线”。例如，如果将该值设置为 `20.0`，则资源组的历史 RU 速率必须超过 1.2×，公平调度才会降低其优先级，或准入控制才会对其进行限制。 + 默认值：`20.0` + 单位：百分比 (%) -### `admission-max-delayed-count` v8.5.7 和 v9.0.0 版本开始引入 +### `admission-max-delayed-count` 从 v8.5.7 和 v9.0.0 版本开始引入 + 指定 TiKV 在准入控制延迟队列中可保留的最大并发请求数（读写合计）。达到该限制后，TiKV 会立即拒绝额外的超出基线请求，而不是继续延迟它们。将该值设置为 `0` 表示并发延迟数不受限制。 + 默认值：`10000` From 65f2128cbac3c49972f4330135165c7006d2657f Mon Sep 17 00:00:00 2001 From: lilin90 Date: Wed, 1 Jul 2026 15:35:17 +0800 Subject: [PATCH 5/7] Update tikv-configuration-file.md --- tikv-configuration-file.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index e7ee307d3eb0..ee777fd19aaa 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2745,14 +2745,12 @@ Raft Engine 相关的配置项。 + `conservative`：此策略会优先确保系统资源被充分利用，允许低优先级任务根据需要充分使用系统可用资源，因此对高优先级任务的性能影响更大。 + 默认值：`moderate` -### `bg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本开始引入 ### `bg-cpu-throttle-threshold` 从 v8.5.7 和 v9.0.0 版本开始引入 + 指定开始对后台任务进行限流时的 CPU 使用率百分比阈值。后台任务是指被标记为后台资源组的任务，包括 `import`、`br`、`ddl` 和 `stats` 任务类型（参见[后台任务类型](/tidb-resource-control-background-tasks.md#background-parameters)）。当 CPU 使用率达到该值时，TiKV 开始减少分配给后台任务的资源预算。随着 CPU 使用率从该阈值升高并接近 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-从-v857-和-v900-版本开始引入)，该预算会从配置的上限按线性方式缩减，最低降至 1 个 CPU 核心。 + 默认值：`60.0` + 单位：百分比 (%) -### `fg-cpu-throttle-threshold` v8.5.7 和 v9.0.0 版本开始引入 ### `fg-cpu-throttle-threshold` 从 v8.5.7 和 v9.0.0 版本开始引入 + 指定完全激活前台流量保护时的 CPU 使用率百分比阈值。当 CPU 使用率达到该值时，后台任务会被完全限流到其最低下限，后台使用率预算也会被限制在该值。该阈值必须大于 [`bg-cpu-throttle-threshold`](#bg-cpu-throttle-threshold-从-v857-和-v900-版本开始引入)。 From b3f0ae6f8418d871f2c7fb440435355d6f472626 Mon Sep 17 00:00:00 2001 From: lilin90 Date: Wed, 1 Jul 2026 15:41:09 +0800 Subject: [PATCH 6/7] Update anchor link --- tikv-configuration-file.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index ee777fd19aaa..6822ce3dcb08 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2747,7 +2747,7 @@ Raft Engine 相关的配置项。 ### `bg-cpu-throttle-threshold` 从 v8.5.7 和 v9.0.0 版本开始引入 -+ 指定开始对后台任务进行限流时的 CPU 使用率百分比阈值。后台任务是指被标记为后台资源组的任务，包括 `import`、`br`、`ddl` 和 `stats` 任务类型（参见[后台任务类型](/tidb-resource-control-background-tasks.md#background-parameters)）。当 CPU 使用率达到该值时，TiKV 开始减少分配给后台任务的资源预算。随着 CPU 使用率从该阈值升高并接近 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-从-v857-和-v900-版本开始引入)，该预算会从配置的上限按线性方式缩减，最低降至 1 个 CPU 核心。 ++ 指定开始对后台任务进行限流时的 CPU 使用率百分比阈值。后台任务是指被标记为后台资源组的任务，包括 `import`、`br`、`ddl` 和 `stats` 任务类型（参见[后台任务类型](/tidb-resource-control-background-tasks.md#background-参数说明)）。当 CPU 使用率达到该值时，TiKV 开始减少分配给后台任务的资源预算。随着 CPU 使用率从该阈值升高并接近 [`fg-cpu-throttle-threshold`](#fg-cpu-throttle-threshold-从-v857-和-v900-版本开始引入)，该预算会从配置的上限按线性方式缩减，最低降至 1 个 CPU 核心。 + 默认值：`60.0` + 单位：百分比 (%) From e2047bdcdb10041dbe3da9d00a4c5a7f97f2ac8c Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Fri, 3 Jul 2026 15:44:35 +0800 Subject: [PATCH 7/7] Refine wording --- tikv-configuration-file.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/tikv-configuration-file.md b/tikv-configuration-file.md index 6822ce3dcb08..e28cd8e8e615 100644 --- a/tikv-configuration-file.md +++ b/tikv-configuration-file.md @@ -2767,13 +2767,13 @@ Raft Engine 相关的配置项。 + 指定当 compaction 压力低于 [`bg-compaction-pressure-threshold`](#bg-compaction-pressure-threshold-从-v857-和-v900-版本开始引入) 时，后台任务允许的最大写 I/O 速率。 + 默认值：`"100GB"` -+ 单位：字节每秒 ++ 单位：字节/秒 ### `bg-write-io-floor` 从 v8.5.7 和 v9.0.0 版本开始引入 -+ 指定即使在最大 compaction 压力下也能保证分配给后台任务的最小写 I/O 速率。该下限可防止后台任务被完全饿死。 ++ 指定即使在最大 compaction 压力下也能保证分配给后台任务的最小写 I/O 速率，防止后台任务因写 I/O 不足而完全无法执行。 + 默认值：`"10MB"` -+ 单位：字节每秒 ++ 单位：字节/秒 ### `enable-fair-scheduling` 从 v8.5.7 和 v9.0.0 版本开始引入 @@ -2792,7 +2792,7 @@ Raft Engine 相关的配置项。 ### `historical-usage-window-mins` 从 v8.5.7 和 v9.0.0 版本开始引入 -+ 指定 TiKV 用于计算各资源组历史 RU 基线的滑动时间窗口大小（单位：分钟）。较大的窗口可以平滑短期突发流量，而较小的窗口会使基线对近期使用情况更敏感。有效范围：`2-60`。**你必须重启 TiKV 才能使对此配置的更改生效。** ++ 指定 TiKV 用于计算各资源组历史 RU 基线的滑动时间窗口大小（单位：分钟）。较大的窗口可以平滑短期突发流量，而较小的窗口会使基线对近期使用情况更敏感。取值范围：`2-60`。**修改此配置后，需要重启 TiKV 才能生效。** + 默认值：`15` + 单位：分钟