可观测性与稳定性 / 系统课时

为什么会出现 Unassigned Shard

为什么会出现 Unassigned Shard

当集群出现 unassigned 分片时,关键不是立刻执行强制分配,而是先找出“哪个分片、为什么不能落到任何节点”。本篇用健康状态、分片列表和 allocation explain,把节点数量、磁盘、分配规则与副本需求串成一条可验证的排障路径。

学习目标

  • 找到具体的未分配主分片或副本分片。
  • 读懂 allocation explain 中真正阻止分配的决策。
  • 根据节点、磁盘、规则和副本需求选择对应修复方向。

先确认是哪一个分片没有分配

yellow 通常表示主分片都已分配,但至少一个副本未分配;red 则表示至少一个主分片未分配。先定位具体索引和分片,再解释原因,避免只根据颜色猜测。

下面的命令以某个已知索引和分片为例。把 <HOST>、<PORT>、<INDEX> 和 <SHARD> 替换为实际值。

bash
HOST="<HOST>"
PORT="<PORT>"
INDEX="<INDEX>"
SHARD="<SHARD>"

curl -sS "http://${HOST}:${PORT}/_cluster/health?filter_path=status,unassigned_shards"
curl -sS "http://${HOST}:${PORT}/_cat/shards/${INDEX}?v&h=index,shard,prirep,state,node,unassigned.reason"
curl -sS -X POST "http://${HOST}:${PORT}/_cluster/allocation/explain?filter_path=index,shard,primary,current_state,can_allocate,allocate_explanation,node_allocation_decisions.node_name,node_allocation_decisions.node_decision,node_allocation_decisions.deciders" \
  -H "Content-Type: application/json" \
  -d "{\"index\":\"${INDEX}\",\"shard\":${SHARD},\"primary\":false}"

预期结果

text
第一条响应可看到 status 与 unassigned_shards。
第二条输出中,目标副本分片的 state 为 UNASSIGNED。
第三条响应会给出 can_allocate、allocate_explanation,以及各候选节点的 node_decision/deciders。
实际节点名、原因文本和数量会因集群状态不同而变化。

如果目标是主分片,把请求体中的 primary 改为 true。如果不知道具体分片,也可以先通过 _cat/shards 找到 UNASSIGNED 行。

四类常见阻塞条件

Unassigned Shard 的四类分配阻塞原因

一个分片副本不能与同一分片的主副本放在同一节点。因此,主分片加两个副本至少需要三个符合分配条件的节点;节点总数很多,但若规则只允许部分节点承载该索引,仍可能未分配。

磁盘也是常见原因。启用磁盘分配阈值后,节点达到水位限制时,disk_threshold 决策器会拒绝继续分配。此时重点是释放空间、扩容或调整数据布局,而不是绕过限制硬塞分片。

分配规则包括索引级的 index.routing.allocation.*,以及集群级过滤、机架或可用区 awareness。规则本身可能没有写错,但节点标签变化、节点下线后,原本满足规则的目标节点可能已经不存在。

副本需求要与拓扑匹配。例如单节点开发环境若配置 number_of_replicas: 1,副本必然长期未分配;生产环境则通常应补足故障域,而不是为了变绿直接取消副本。

不要先用强制分配掩盖根因

allocation explain 的价值在于告诉你“为什么所有候选节点都被拒绝”。若 node_decision 普遍为 no,应查看对应 deciders;若只是节点短暂离线,则还要结合节点恢复过程判断是否需要操作。

修复后重新执行 _cluster/health 与 _cat/shards。真正完成的标准不是命令返回成功,而是目标分片从 UNASSIGNED 进入分配状态,并且导致拒绝的条件已经消失。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为什么会出现 Unassigned Shard

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通