查询分片分配

此 API 提供集群中每个数据节点的分片分配情况和磁盘使用状态的快照视图。

API #

GET /_cat/allocation
GET /_cat/allocation/{nodes}

API 的作用 #

返回集群中各个节点的分片分配信息，包括：

• 分片数量：每个节点上分配的分片总数
• 磁盘使用：索引数据占用的磁盘空间
• 磁盘状态：已用、可用、总容量和使用百分比
• 节点信息：节点名称、IP 地址和主机名

此 API 是监控集群健康状况和磁盘使用情况的重要工具，特别适合用于集群运维和容量规划。

API 的参数 #

路由参数 #

查询字符串参数 #

返回的字段信息 #

请求示例 #

# 基本查询，显示所有数据节点的分配情况
GET /_cat/allocation

# 显示列头
GET /_cat/allocation?v

# 查询指定节点
GET /_cat/allocation/node1,node2

# 使用 JSON 格式返回
GET /_cat/allocation?format=json

# 只显示特定列
GET /_cat/allocation?h=shards,disk.indices,node

# 按磁盘使用百分比降序排列
GET /_cat/allocation?s=disk.percent:desc

# 显示帮助信息
GET /_cat/allocation?help

# 设置字节单位为 GB
GET /_cat/allocation?bytes=gb

响应示例 #

文本格式（默认） #

shards disk.indices disk.used disk.avail disk.total disk.percent host ip       node
    15        45gb       60gb       140gb       200gb           30 node1 10.0.1.1 data-node-1
    12        38gb       50gb       150gb       200gb           25 node2 10.0.1.2 data-node-2
    18        52gb       68gb       132gb       200gb           34 node3 10.0.1.3 data-node-3

JSON 格式 #

[
  {
    "shards": "15",
    "disk.indices": "45gb",
    "disk.used": "60gb",
    "disk.avail": "140gb",
    "disk.total": "200gb",
    "disk.percent": "30",
    "host": "node1",
    "ip": "10.0.1.1",
    "node": "data-node-1"
  },
  {
    "shards": "12",
    "disk.indices": "38gb",
    "disk.used": "50gb",
    "disk.avail": "150gb",
    "disk.total": "200gb",
    "disk.percent": "25",
    "host": "node2",
    "ip": "10.0.1.2",
    "node": "data-node-2"
  }
]

帮助信息 #

shards    | s                     | number of shards on the node
disk.indices| di, diskIndices     | disk used by ES indices
disk.used  | du, diskUsed         | disk used (total, including non-ES)
disk.avail | da, diskAvail        | disk available
disk.total | dt, diskTotal        | total disk space
disk.percent| dp, diskPercent     | percent disk used
host       | h                    | host name
ip         |                      | ip address
node       | n                    | node name

使用场景 #

1. 容量规划：监控磁盘使用情况，预测存储需求
2. 负载均衡：检查分片在节点间的分布是否均匀
3. 磁盘告警：及时发现磁盘使用率过高的节点
4. 节点扩容：确定需要添加新节点的时机
5. 问题排查：诊断分片分配不均或磁盘空间问题

特殊情况说明 #

未分配分片 #

如果存在未分配的分片，会显示一行特殊信息：

• node 列显示 UNASSIGNED
• shards 列显示未分配分片数量
• 磁盘相关列显示 - 或 null

非数据节点 #

对于非数据节点（如 master-only 节点）：

• disk.indices 显示 0
• 磁盘相关列可能显示 - 或 null
• 除非明确指定，否则默认不显示

磁盘水位线 #

Easysearch 使用磁盘水位线来决定分片分配：

最佳实践 #

1. 定期监控：定期检查磁盘使用情况，避免磁盘满载
2. 设置告警：对 disk.percent 设置告警阈值（如 80%）
3. 均衡分布：确保分片均匀分布在各节点
4. 预留空间：建议保持至少 15-20% 的可用磁盘空间
5. 及时扩容：当多个节点接近水位线时，考虑添加新节点

注意事项 #

1. 默认只显示数据节点（data:true）
2. 磁盘使用包括所有数据，不仅仅是 ES 索引数据
3. local=true 时可能返回过时信息，但响应更快
4. 磁盘使用百分比基于总磁盘容量，包括非 ES 数据

相关文档 #

• 查询分片
• 查询集群健康
• 查询文档数量
• 查询节点信息