11[[recovery]]
22=== Indices Recovery
33
4- <<cat-recovery, Peer recovery>> syncs data from a primary shard to a new or
4+ Peer recovery syncs data from a primary shard to a new or
55existing shard copy.
66
77Peer recovery automatically occurs when {es}:
88
99* Recreates a shard lost during node failure
1010* Relocates a shard to another node due to a cluster rebalance or changes to the
1111<<modules-cluster, shard allocation settings>>
12- * Restores a <<modules-snapshots, snapshot>>
12+
13+ You can view a list of in-progress and completed recoveries using the
14+ <<cat-recovery, cat recovery API>>.
1315
1416[float]
1517==== Peer recovery settings
16- You can use the following _expert_ settings to manage resources for peer
17- recoveries. These settings apply to all peer recoveries, including
18- those related to shard relocation or snapshot restoration.
1918
20- `indices.recovery.max_bytes_per_sec`::
19+ `indices.recovery.max_bytes_per_sec` (<<cluster-update-settings,Dynamic>>) ::
2120Limits total inbound and outbound recovery traffic for each node.
2221Defaults to `40mb`.
2322+
@@ -28,12 +27,14 @@ this limit.
2827If this limit is too high, ongoing recoveries may consume an excess
2928of bandwidth and other resources, which can destabilize the cluster.
3029
31- `indices.recovery.max_concurrent_file_chunks`::
30+ [float]
31+ ==== Expert peer recovery settings
32+ You can use the following _expert_ setting to manage resources for peer
33+ recoveries.
34+
35+ `indices.recovery.max_concurrent_file_chunks` (<<cluster-update-settings,Dynamic>>, Expert)::
3236Number of file chunk requests sent in parallel for each recovery. Defaults to
3337`2`.
3438+
3539You can increase the value of this setting when the recovery of a single shard
36- is not reaching the traffic limit set by `indices.recovery.max_bytes_per_sec`.
37-
38- You can use the <<cluster-update-settings, Cluster Update Settings>> API to
39- view and change these settings for a live cluster.
40+ is not reaching the traffic limit set by `indices.recovery.max_bytes_per_sec`.
0 commit comments