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 Check-Up which can resolve issues that cause many errors.

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.

Advanced users might want to skip right to the common problems section in each concept or try running the Check-Up to analyze Elasticsearch configuration and help resolve this error.

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

Watch how AutoOps finds & fixes Elasticsearch problems

Analyze Your Cluster
Skip to content