WARNING: Version 1.6 of Elasticsearch has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Index Modules
editIndex Modules
editIndex Modules are modules created per index and control all aspects related to an index. Since those modules lifecycle are tied to an index, all the relevant modules settings can be provided when creating an index (and it is actually the recommended way to configure an index).
Index Settings
editThere are specific index level settings that are not associated with any specific module. These include:
-
index.compound_format
-
[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Should the compound file format be used (boolean setting). The compound format was created to reduce the number of open file handles when using file based storage. However, by default it is set to
false
as the non-compound format gives better performance. It is important that OS is configured to give Elasticsearch “enough” file handles. See File Descriptors.Alternatively,
compound_format
can be set to a number between0
and1
, where0
meansfalse
,1
meanstrue
and a number inbetween represents a percentage: if the merged segment is less than this percentage of the total index, then it is written in compound format, otherwise it is written in non-compound format. -
index.compound_on_flush
-
[preview]
This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
Should a new segment (create by indexing, not by merging) be written
in compound format or non-compound format? Defaults to
true
. This is a dynamic setting. -
index.refresh_interval
-
A time setting controlling how often the
refresh operation will be executed. Defaults to
1s
. Can be set to-1
in order to disable it. -
index.shard.check_on_startup
-
[preview]
This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
Should shard consistency be checked upon opening.
When
true
, the shard will be checked, preventing it from being open in case some segments appear to be corrupted. Whenfix
, the shard will also be checked but segments that were reported as corrupted will be automatically removed. Default value isfalse
, which doesn’t check shards.
Checking shards may take a lot of time on large indices.
Setting index.shard.check_on_startup
to fix
may result in data loss,
use with caution.