Skip to content

Commit c32607d

Browse files
authored
[Doc] Troubleshoot Cluster State / Linkable subsections (#95468) (#95553)
👋🏼 howdy, team! Could we make these sub-sections sub-header link-able?
1 parent 11dd4f7 commit c32607d

File tree

1 file changed

+22
-7
lines changed

1 file changed

+22
-7
lines changed

docs/reference/troubleshooting/common-issues/red-yellow-cluster-status.asciidoc

Lines changed: 22 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,9 @@ GET _cluster/allocation/explain?filter_path=index,node_allocation_decisions.node
5959
A shard can become unassigned for several reasons. The following tips outline the
6060
most common causes and their solutions.
6161

62-
**Re-enable shard allocation**
62+
[discrete]
63+
[[fix-cluster-status-reenable-allocation]]
64+
===== Re-enable shard allocation
6365

6466
You typically disable allocation during a <<restart-cluster,restart>> or other
6567
cluster maintenance. If you forgot to re-enable allocation afterward, {es} will
@@ -76,7 +78,9 @@ PUT _cluster/settings
7678
}
7779
----
7880

79-
**Recover lost nodes**
81+
[discrete]
82+
[[fix-cluster-status-recover-nodes]]
83+
===== Recover lost nodes
8084

8185
Shards often become unassigned when a data node leaves the cluster. This can
8286
occur for several reasons, ranging from connectivity issues to hardware failure.
@@ -94,7 +98,9 @@ asynchronously in the background.
9498
POST _cluster/reroute?metric=none
9599
----
96100

97-
**Fix allocation settings**
101+
[discrete]
102+
[[fix-cluster-status-allocation-settings]]
103+
===== Fix allocation settings
98104

99105
Misconfigured allocation settings can result in an unassigned primary shard.
100106
These settings include:
@@ -117,7 +123,9 @@ GET _cluster/settings?flat_settings=true&include_defaults=true
117123
You can change the settings using the <<indices-update-settings,update index
118124
settings>> and <<cluster-update-settings,cluster update settings>> APIs.
119125

120-
**Allocate or reduce replicas**
126+
[discrete]
127+
[[fix-cluster-status-allocation-replicas]]
128+
===== Allocate or reduce replicas
121129

122130
To protect against hardware failure, {es} will not assign a replica to the same
123131
node as its primary shard. If no other data nodes are available to host the
@@ -138,7 +146,10 @@ PUT _settings
138146
----
139147
// TEST[s/^/PUT my-index\n/]
140148

141-
**Free up or increase disk space**
149+
150+
[discrete]
151+
[[fix-cluster-status-disk-space]]
152+
===== Free up or increase disk space
142153

143154
{es} uses a <<disk-based-shard-allocation,low disk watermark>> to ensure data
144155
nodes have enough disk space for incoming shards. By default, {es} does not
@@ -194,13 +205,17 @@ PUT _cluster/settings
194205
----
195206
// TEST[s/"30gb"/null/]
196207

197-
**Reduce JVM memory pressure**
208+
[discrete]
209+
[[fix-cluster-status-jvm]]
210+
===== Reduce JVM memory pressure
198211

199212
Shard allocation requires JVM heap memory. High JVM memory pressure can trigger
200213
<<circuit-breaker,circuit breakers>> that stop allocation and leave shards
201214
unassigned. See <<high-jvm-memory-pressure>>.
202215

203-
**Recover data for a lost primary shard**
216+
[discrete]
217+
[[fix-cluster-status-restore]]
218+
===== Recover data for a lost primary shard
204219

205220
If a node containing a primary shard is lost, {es} can typically replace it
206221
using a replica on another node. If you can't recover the node and replicas

0 commit comments

Comments
 (0)