diff --git a/website/content/docs/configuration/storage/raft.mdx b/website/content/docs/configuration/storage/raft.mdx index e184ab49d9..0356341e37 100644 --- a/website/content/docs/configuration/storage/raft.mdx +++ b/website/content/docs/configuration/storage/raft.mdx @@ -52,22 +52,23 @@ set [`disable_mlock`](/vault/docs/configuration#disable_mlock) to `true`, and to GUID during initialization and writes the value to `data/node-id` in the directory specified by the `path` parameter. -- `performance_multiplier` `(integer: 0)` - An integer multiplier used by - servers to scale key Raft timing parameters, where each increment translates to approximately 1 – 2 seconds of delay. For example, setting the multiplier to "3" translates to 3 – 6 seconds of total delay. Tuning the multiplier affects the time it +- `performance_multiplier` `(integer: 5)` - An integer multiplier used by + servers to scale key Raft timing parameters, where each increment translates + to approximately 1 – 2 seconds of delay. For example, setting the multiplier + to "3" translates to 3 – 6 seconds of total delay. Tuning the multiplier affects the time it takes Vault to detect leader failures and to perform leader elections, at the expense of requiring more network and CPU resources for better performance. Omitting this value or setting it to 0 uses default timing described below. Lower values are used to tighten timing and increase sensitivity while higher values relax timings and reduce sensitivity. - -By default, Vault uses a balanced timing value of 5, which is suitable for most -platforms and scenarios. You should only adjust the timing value when platform -telemetry indicators that a change is needed or different timing is required due -to the overall reliability your platform (network, etc.). - -Setting the timing value to 1 configures Raft to its highest performance (lowest -delay) mode. The maximum allowed value is 10. + By default, Vault uses a balanced timing value of 5, which is suitable for most + platforms and scenarios. You should only adjust the timing value when platform + telemetry indicators that a change is needed or different timing is required due + to the overall reliability your platform (network, etc.). + + Setting the timing value to 1 configures Raft to its highest performance (lowest + delay) mode. The maximum allowed value is 10. - `trailing_logs` `(integer: 10000)` - This controls how many log entries are left in the log store on disk after a snapshot is made. This should only be