Skip to content

Commit ac5c67a

Browse files
authored
Clarify that red/yellow health must be addressed (#109090) (#109119)
We don't expect a cluster to run with `yellow` health for an extended period of time, but it's not clear from these docs that it's important to bring the cluster back to `green` health ASAP. This commit clarifies these docs.
1 parent 9ebd6e6 commit ac5c67a

File tree

1 file changed

+20
-5
lines changed

1 file changed

+20
-5
lines changed

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

Lines changed: 20 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,24 @@
11
[[red-yellow-cluster-status]]
2-
=== Red or yellow cluster status
3-
4-
A red or yellow cluster status indicates one or more shards are missing or
5-
unallocated. These unassigned shards increase your risk of data loss and can
6-
degrade cluster performance.
2+
=== Red or yellow cluster health status
3+
4+
A red or yellow cluster health status indicates one or more shards are not assigned to
5+
a node.
6+
7+
* **Red health status**: The cluster has some unassigned primary shards, which
8+
means that some operations such as searches and indexing may fail.
9+
* **Yellow health status**: The cluster has no unassigned primary shards but some
10+
unassigned replica shards. This increases your risk of data loss and can degrade
11+
cluster performance.
12+
13+
When your cluster has a red or yellow health status, it will continue to process
14+
searches and indexing where possible, but may delay certain management and
15+
cleanup activities until the cluster returns to green health status. For instance,
16+
some <<index-lifecycle-management,{ilm-init}>> actions require the index on which they
17+
operate to have a green health status.
18+
19+
In many cases, your cluster will recover to green health status automatically.
20+
If the cluster doesn't automatically recover, then you must <<fix-red-yellow-cluster-status,manually address>>
21+
the remaining problems so management and cleanup activities can proceed.
722

823
[discrete]
924
[[diagnose-cluster-status]]

0 commit comments

Comments
 (0)