Skip to content

Commit e5d6b89

Browse files
committed
Add common causes for unassigned shards
1 parent b8409b1 commit e5d6b89

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

troubleshoot/elasticsearch/diagnose-unassigned-shards.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -237,3 +237,26 @@ 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 https://www.youtube.com/watch?v=5z3n2VgusLE[this video] 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+
Run the cluster reroute API to retry allocation, 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`, then 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 https://www.youtube.com/watch?v=6OAg9IyXFO4[this video] for a walkthrough of troubleshooting `no_valid_shard_copy`.
261+
262+

0 commit comments

Comments
 (0)