From c0d24ac6afd61897a2e7e88d556a4fe6b6fee4be Mon Sep 17 00:00:00 2001 From: Andriy Redko Date: Fri, 8 Dec 2023 18:01:25 -0500 Subject: [PATCH] [DOC]Documentation - Enable merge on refresh and merge on commit in Opensearch 2.1.0+ (#5804) * [DOC]Documentation - Enable merge on refresh and merge on commit in Opensearch 2.1.0+ Signed-off-by: Andriy Redko * Update _install-and-configure/configuring-opensearch/index-settings.md Co-authored-by: Melissa Vagi Signed-off-by: Andriy Redko --------- Signed-off-by: Andriy Redko Signed-off-by: Andriy Redko Co-authored-by: Melissa Vagi --- .../configuring-opensearch/index-settings.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/_install-and-configure/configuring-opensearch/index-settings.md b/_install-and-configure/configuring-opensearch/index-settings.md index acc3631c..f88d0602 100644 --- a/_install-and-configure/configuring-opensearch/index-settings.md +++ b/_install-and-configure/configuring-opensearch/index-settings.md @@ -94,6 +94,13 @@ OpenSearch supports the following static index-level index settings: - `index.merge.policy` (String): This setting controls the merge policy for the Lucene segments. The available options are `tiered` and `log_byte_size`. The default is `tiered`, but for time-series data, such as log events, we recommend that you use the `log_byte_size` merge policy, which can improve query performance when conducting range queries on the `@timestamp` field. We recommend that you not change the merge policy of an existing index. Instead, configure this setting when creating a new index. +- `index.merge_on_flush.enabled` (Boolean): This setting controls Apache Lucene's merge-on-refresh feature that aims to reduce the number of segments by performing merges _on refresh_ (or in terms of OpenSearch, _on flush_). Default is `true`. + +- `index.merge_on_flush.max_full_flush_merge_wait_time` (Time unit): This setting sets the amount of time to wait for merges when `index.merge_on_flush.enabled` is enabled. Default is `10s`. + +- `index.merge_on_flush.policy` (default | merge-on-flush): This setting controls which merge policy should be used when `index.merge_on_flush.enabled` is enabled. Default is `default`. + + ### Updating a static index setting You can update a static index setting only on a closed index. The following example demonstrates updating the index codec setting.