(DOC +) Add resolutions to Allocation Explain examples (#108263)

* (DOC +) Add resolutions to Allocation Explain examples * Update docs/reference/cluster/allocation-explain.asciidoc Co-authored-by: shainaraskas <[email protected]> * Update docs/reference/cluster/allocation-explain.asciidoc Co-authored-by: shainaraskas <[email protected]> * Update docs/reference/cluster/allocation-explain.asciidoc Co-authored-by: David Turner <[email protected]> --------- Co-authored-by: shainaraskas <[email protected]> Co-authored-by: David Turner <[email protected]>
elastic · May 22, 2024 · 582c6c0 · 582c6c0
1 parent 4d3ca2d
commit 582c6c0
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/docs/reference/cluster/allocation-explain.asciidoc b/docs/reference/cluster/allocation-explain.asciidoc
@@ -156,7 +156,7 @@ node.
 <3> Whether to allocate the shard.
 <4> Whether to allocate the shard to the particular node.
 <5> The decider which led to the `no` decision for the node.
-<6> An explanation as to why the decider returned a `no` decision, with a helpful hint pointing to the setting that led to the decision.
+<6> An explanation as to why the decider returned a `no` decision, with a helpful hint pointing to the setting that led to the decision. In this example, a newly created index has <<indices-get-settings,an index setting>> that requires that it only be allocated to a node named `nonexistent_node`, which does not exist, so the index is unable to allocate.
 
 The following response contains an allocation explanation for an unassigned
 primary shard that was previously allocated.
@@ -180,6 +180,8 @@ primary shard that was previously allocated.
 ----
 // NOTCONSOLE
 
+TIP: If a shard is unassigned with an allocation status of `no_valid_shard_copy`, then you should <<fix-cluster-status-recover-nodes,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 <<fix-cluster-status-restore,recover the data for the shard>>.
+
 ===== Unassigned replica shard
 
 The following response contains an allocation explanation for a replica that's