Failed to prepare shard for recovery – How to solve this Elasticsearch error

Opster Team

July-20, Version: 1.7-8.0

Before you begin reading this guide, we recommend you try running the Elasticsearch Error Check-Up which analyzes 2 JSON files to detect many configuration errors.

To easily locate the root cause and resolve this issue try AutoOps for Elasticsearch & OpenSearch. It diagnoses problems by analyzing hundreds of metrics collected by a lightweight agent and offers guidance for resolving them.

This guide will help you check for common problems that cause the log ” failed to prepare shard for recovery ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: recovery, indices and shard.

Log Context

Log “failed to prepare shard for recovery”classname  is We extracted the following from Elasticsearch source code for those seeking an in-depth context :

actionName = PeerRecoverySourceService.Actions.START_RECOVERY;
 } catch (final Exception e) {
 // this will be logged as warning later on...
 logger.trace("unexpected error while preparing shard for peer recovery; failing recovery"; e);
 new RecoveryFailedException(recoveryTarget.state(); "failed to prepare shard for recovery"; e); true);
 logger.trace("{} starting recovery from {}"; startRequest.shardId(); startRequest.sourceNode());
 } else {
 startRequest = preExistingRequest;


Watch product tour

Try AutoOps to find & fix Elasticsearch problems

Analyze Your Cluster
Skip to content