# 查看索引状态

URL: https://caijiao.org/elasticsearch/02.basic/04.index-status
Source: docs/elasticsearch/02.basic/04.index-status.md
Description: 本章介绍如何查看 Elasticsearch 中索引的状态、健康信息及详细配置，帮助监控和管理集群数据状况。

了解索引的运行状态和配置信息是保证 Elasticsearch 集群健康和性能的关键。通过多种 API，可以查询索引的基本信息、健康状况及统计数据。

## 1. 查看所有索引列表

```http
GET /_cat/indices?v
````

返回当前集群所有索引的列表及基本信息，包括状态、文档数、存储大小等。

## 2. 查看指定索引详细信息

```http
GET /my-index
```

获取 `my-index` 索引的详细元数据，包括映射、设置和状态。

## 3. 查看索引健康状态

```http
GET /_cluster/health/my-index?level=indices
```

返回指定索引的健康状态，如 `green`（正常）、`yellow`（副本未分配）和 `red`（不可用）。

## 4. 查看索引统计信息

```http
GET /my-index/_stats
```

获取索引的详细统计数据，包括文档数量、存储大小、查询性能指标等。

## 5. 常用状态字段解释

| 字段         | 含义                       |
| ---------- | ------------------------ |
| status     | 索引状态（open/close）         |
| health     | 索引健康状况（green/yellow/red） |
| pri        | 主分片数量                    |
| rep        | 副本分片数量                   |
| docs.count | 文档总数                     |
| store.size | 索引存储大小                   |

---

通过持续监控索引状态，可以及时发现集群问题，保障 Elasticsearch 平稳运行与高效查询。