知识条目 / Elasticsearch
Elasticsearch 集群变红或变黄、分片未分配如何处理?
先用 cluster health 与 cat shards 定位未分配原因,再针对节点离线、磁盘水位、分配规则或副本数处理。
红色表示至少一个主分片未分配,黄色表示副本未分配。未分配原因通常记录在 cluster allocation explain 中,是判断处理方向的最可信依据。
处理步骤
- 确认健康与范围查看 cluster health 与 cat shards,确定未分配的是主分片还是副本、涉及哪些索引。
- 读取分配解释对未分配分片执行 allocation explain,查看具体原因,如节点离线、磁盘水位、分配过滤或副本数过高。
- 针对性恢复恢复节点、清理磁盘或调整副本数/分配规则;主分片缺失且无副本时应从快照恢复。
- 防复发配置磁盘水位告警、节点离线告警与快照策略,避免单节点故障直接导致红色。
示例
GET _cluster/health
GET _cat/shards?v&h=index,shard,prirep,state,unassigned.reason
GET _cluster/allocation/explain
{
"index": "orders",
"shard": 0,
"primary": true
}
不要通过反复 reroute 强行分配主分片;主分片数据缺失时应优先使用快照恢复。
关键词
elasticsearch · red · yellow · unassigned · 分片 · 副本 · cluster health