Skip to content

Commit 316b747

Browse files
authored
Add common causes for unassigned shards (#796)
1 parent 195a112 commit 316b747

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

troubleshoot/elasticsearch/diagnose-unassigned-shards.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,3 +237,24 @@ See [this video](https://www.youtube.com/watch?v=v2mbeSd1vTQ) for a walkthrough
237237
If you’re using Elastic Cloud Hosted, then you can use AutoOps to monitor your cluster. AutoOps significantly simplifies cluster management with performance recommendations, resource utilization visibility, real-time issue detection and resolution paths. For more information, refer to [Monitor with AutoOps](/deploy-manage/monitor/autoops.md).
238238

239239
::::
240+
241+
## Common issues
242+
243+
The following sections provide advice for resolving some of the common causes for unassigned shards.
244+
245+
### Conflicting settings
246+
247+
A primary shard might be unassigned due to conflicting settings.
248+
View [this video](https://www.youtube.com/watch?v=5z3n2VgusLE) for a walkthrough of troubleshooting a node and index setting mismatch.
249+
250+
### Maximum number of retries exceeded [maximum-retries-exceeded]
251+
252+
When Elasticsearch is unable to allocate a shard, it will attempt to retry allocation up to the maximum number of retries allowed.
253+
After this, Elasticsearch will stop attempting to allocate the shard in order to prevent infinite retries which may impact cluster performance.
254+
You can use an API to [reroute the cluster](https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-cluster-reroute), which will allocate the shard if the issue preventing allocation has been resolved.
255+
256+
### No valid shard copy [no-shard-copy]
257+
258+
If a shard is unassigned with an allocation status of `no_valid_shard_copy`, you should make sure that all nodes are in the cluster. If all the nodes containing in-sync copies of a shard are lost, then you can recover the data for the shard.
259+
260+
View [this video](https://www.youtube.com/watch?v=6OAg9IyXFO4) for a walkthrough of troubleshooting `no_valid_shard_copy`.

0 commit comments

Comments
 (0)