diff --git a/src/current/v24.1/admission-control.md b/src/current/v24.1/admission-control.md index df357eb349d..e57a49b142a 100644 --- a/src/current/v24.1/admission-control.md +++ b/src/current/v24.1/admission-control.md @@ -135,7 +135,7 @@ COMMIT; ## Considerations -To prevent unnecessary queuing in admission control CPU queues, set the `goschedstats.always_use_short_sample_period.enabled` [cluster setting]({% link {{ page.version.version }}/cluster-settings.md %}) to `true` for any production cluster. +To prevent unnecessary queuing in admission control CPU queues, set the `goschedstats.always_use_short_sample_period.enabled` [cluster setting]({% link {{ page.version.version }}/cluster-settings.md %}#setting-goschedstats-always-use-short-sample-period-enabled) to `true` for any [production cluster]({% link {{ page.version.version }}/recommended-production-settings.md %}). [Client connections]({% link {{ page.version.version }}/connection-parameters.md %}) are not managed by the admission control subsystem. Too many connections per [gateway node]({% link {{ page.version.version }}/architecture/sql-layer.md %}#gateway-node) can also lead to cluster overload. diff --git a/src/current/v24.1/cluster-settings.md b/src/current/v24.1/cluster-settings.md index 8bb83a25a09..1d4f9ce0a72 100644 --- a/src/current/v24.1/cluster-settings.md +++ b/src/current/v24.1/cluster-settings.md @@ -28,6 +28,18 @@ These cluster settings have a broad impact on CockroachDB internals and affect a {% remote_include https://raw.githubusercontent.com/cockroachdb/cockroach/{{ page.release_info.crdb_branch_name }}/docs/generated/settings/settings.html %} + + +
goschedstats.always_use_short_sample_period.enabled |
+ boolean | +false | +When set to true, the system uses a shorter sampling period of runnable queue lengths. This setting should always be enabled for production clusters to help prevent unnecessary queuing in the admission control subsystem. | +Advanced/Self-Hosted | +