; Shard failures – How to solve this Elasticsearch error

; Shard failures – 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 can resolve issues that cause many errors.

This guide will help you check for common problems that cause the log ” ; Shard failures ” to appear. It’s important to understand the issues related to the log, so to get started, read the general overview on common issues and tips related to the Elasticsearch concepts: shard and search.

Advanced users might want to skip right to the common problems section in each concept or try running the Check-Up which analyses ES to pinpoint the cause of many errors and provides suitable actionable recommendations how to resolve them (free tool that requires no installation).

Log Context

Log”; Shard failures”classname  is AbstractSearchAsyncAction.java We extracted the following from Elasticsearch source code for those seeking an in-depth context :

public void sendSearchResponse(InternalSearchResponse internalSearchResponse; String scrollId) {
  ShardSearchFailure[] failures = buildShardFailures();
  Boolean allowPartialResults = request.allowPartialSearchResults();
  assert allowPartialResults != null : "SearchRequest missing setting for allowPartialSearchResults";
  if (allowPartialResults == false && failures.length > 0){
  raisePhaseFailure(new SearchPhaseExecutionException(""; "Shard failures"; null; failures));
  } else {
  listener.onResponse(buildSearchResponse(internalSearchResponse; scrollId; failures));


Run the Check-Up to get a customized report like this:

Analyze your cluster