Elasticsearch提供了猫系列API，也就是_cat接口，用简洁的表格形式展示集群的各类信息，其中_cat/indices是最常用的一个。它能一次性列出集群中所有索引的名称、健康状态、文档数、磁盘占用等关键指标，是日常巡检和问题排查的起点。本文将从基本用法、参数详解、输出字段含义和常见排查场景几个方面，把这个接口讲透。
_cat/indices的基本用法与返回字段解读
最简单的调用方式就是直接发送一个GET请求：
curl -X GET "localhost:9200/_cat/indices"
默认情况下返回结果没有表头，看起来像一堆乱数据。加上v参数即可显示列名：
curl -X GET "localhost:9200/_cat/indices?v"
返回示例大致如下：
health status index uuid pri rep docs.count docs.deleted store.size pri.store.size yellow open user-log-2024.03.01 A1b2C3d4E5f6G7h8I9j0 3 1 158230 0 835.2mb 835.2mb green open product-info B2c3D4e5F6g7H8i9J0k1 2 1 45200 12 120.5mb 60.2mb
几个核心字段值得逐一说明。health表示索引健康度，green代表主分片和副本分片都正常分配，yellow表示主分片正常但部分副本未分配，red则意味着有主分片丢失，数据不完整。status是索引的打开或关闭状态，closed状态的索引不占用内存资源但也不能读写。pri和rep分别代表主分片数和副本分片数。docs.count是文档总数，docs.deleted是标记删除尚未物理清理的文档数，这个数字很大时可以通过force merge释放空间。store.size是主副本加起来的总存储量，pri.store.size是仅主分片的存储量。
需要注意docs.count与store.size的关系。如果删除了大量文档但store.size没明显下降，属于正常现象，Lucene的段合并机制决定了删除是标记式的，旧段过期后会通过后台merge回收空间。判断一个索引的真实磁盘开销，应该以pri.store.size再乘以分片副本相关系数为基准，而不是只看store.size。
常用参数详解：h、format、s与通配符
默认输出列比较多，实际排查时往往只需要其中几列。用h参数可以指定输出哪些列，多个列名用逗号分隔：
curl -X GET "localhost:9200/_cat/indices?h=index,health,docs.count,store.size&v"
如果需要把结果交给脚本处理，表格文本并不好解析。此时用format=json输出JSON，再配合pretty参数即可得到结构化数据：
curl -X GET "localhost:9200/_cat/indices?format=pretty&h=index,docs.count,store.size"
排序用s参数，比如按存储空间降序排列，可以快速找出占用磁盘最多的索引：
curl -X GET "localhost:9200/_cat/indices?v&s=store.size:desc,index:asc"
索引数量多的时候，配合索引名通配符只查询关心的那批索引是更高效的做法。例如日志类索引通常按日期命名，查看三月份的所有索引：
curl -X GET "localhost:9200/_cat/indices/user-log-2024.03.*?v"
另外还有两个实用参数：bytes参数可以统一存储单位，比如bytes=b让所有尺寸以字节输出，方便脚本做数值比较；expand_wildcards参数控制通配符是否包含隐藏索引，排查由ILM或监控插件创建的以点开头的系统索引时会用到。
健康状态异常的排查思路与大集群注意事项
当看到health列出现yellow时，先不要慌。yellow只说明副本分片未分配，数据本身仍然是完整的，最常见的场景是单节点集群上索引设置了副本，节点数不够自然无法分配副本。确认方法是通过GET _cluster/health查看unassigned_shards数量，再用GET _cat/shards?v&h=index,shard,prirep,state,unassigned.reason查看具体是哪些分片未分配以及原因。如果是单节点测试环境，直接把副本数改成0即可恢复green。
如果出现red，说明有主分片丢失，属于需要立即处理的情况。常见原因包括节点宕机、磁盘水位触发保护、分片分配被延迟等。可以先看GET _cluster/allocation/explain的输出，它会明确告诉你分片为什么分不出去。
最后一点容易被忽视：在索引数量成千上万的大集群上，直接执行不带过滤条件的_cat/indices是有开销的，master节点需要汇总全部分片信息，可能造成接口响应缓慢甚至加重master负担。生产环境建议养成两个习惯：一是总是带上索引名或通配符缩小范围，二是监控脚本里加上bytes=b和明确的时间参数，必要时改用GET _cluster/health?level=indices这类更轻量的接口做周期性巡检。
掌握_cat/indices之后，可以顺藤摸瓜继续使用_cat/shards查看分片分布、_cat/allocation查看各节点磁盘水位，这几个接口组合起来基本覆盖了索引层面的日常运维需求。
Elasticsearch_cat/indices索引列表修改时间：2026-09-15 15:10:35