首页/数据/NoSQL 速查/_cat/shards 检查分片分布
本包目录(322 条)
MongoDB99 条
Elasticsearch89 条
ClickHouse56 条时序与列式28 条选型与架构50 条

_cat/shards 检查分片分布

_cat/shards 列出每个索引的每个分片状态、所在节点、文档数与存储量;排查未分配分片与分布倾斜时的首站接口。

NoSQL 速查数据更新于 2026-10-12
接口GET /_cat/shards?v 或 GET /_cat/shards/<index>?v
关键列shard、prirep(p/r)、state、docs、store、node、unassigned.reason
过滤state=unassigned 只看未分配,s=state 排序

示例

示例
GET /_cat/shards?v&s=state
GET /_cat/shards/logs-2024?v&h=index,shard,prirep,state,docs,store,node,unassigned.reason
state 取值包括 STARTED、INITIALIZING、RELOCATING、UNASSIGNED;UNASSIGNED 时跟着看 unassigned.reason 与 allocation explain。

易错点

  • 同一个主分片与其副本会各占一行,统计索引分片数别把 r 行算进去
  • STARTED 不代表健康:副本所在节点磁盘吃紧时状态可能仍是 STARTED

数据来源与参考

  • Elasticsearch Guide: cat shards API
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌