Skip to content

Commit caed030

Browse files
committed
Explicitly recommend to forceMerge before freezing (#36376)
given the benchmark results on #34352 it's important to recommend users to `_force_merge` their indices to a single segment before freezing.
1 parent 468829f commit caed030

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

docs/reference/frozen-indices.asciidoc

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,17 @@ data structures on demand which can cause page faults and garbage collections, w
2929

3030
Since indices that are eligible for freezing are unlikely to change in the future, disk space can be optimized as described in <<tune-for-disk-usage>>.
3131

32+
It's highly recommended to <<indices-forcemerge,`_forcemerge`>> your indices prior to freezing to ensure that each shard has only a single
33+
segment on disk. This not only provides much better compression but also simplifies the data structures needed to service aggregation
34+
or sorted search requests.
35+
36+
[source,js]
37+
--------------------------------------------------
38+
POST /twitter/_forcemerge?max_num_segments=1
39+
--------------------------------------------------
40+
// CONSOLE
41+
// TEST[setup:twitter]
42+
3243
== Searching a frozen index
3344

3445
Frozen indices are throttled in order to limit memory consumptions per node. The number of concurrently loaded frozen indices per node is

0 commit comments

Comments
 (0)