Cluster Health

Cluster Health API 允许获得关于集群健康的状态。

GET _cluster/health

curl -X GET "localhost:9200/_cluster/health?pretty"

{
  "cluster_name" : "d1a1cb4a025a4c7b89235909cb4c5717",
  "status" : "green",
  "timed_out" : false,
  "number_of_nodes" : 8,
  "number_of_data_nodes" : 5,
  "active_primary_shards" : 0,
  "active_shards" : 0,
  "relocating_shards" : 0,
  "initializing_shards" : 0,
  "unassigned_shards" : 0,
  "delayed_unassigned_shards" : 0,
  "number_of_pending_tasks" : 0,
  "number_of_in_flight_fetch" : 0,
  "task_max_waiting_in_queue_millis" : 0,
  "active_shards_percent_as_number" : 100.0
}

这个 API 也可以这样执行

GET /_cluster/health/test1,test2

集群健康状态为：绿色、黄色或红色。在分片级别，红色状态表示集群中未分配特定分片，黄色表示已分配主分片但未分配副本，绿色表示已分配所有分片。索引级别状态由最差的分片状态控制。集群状态由最差的索引状态控制。

参数设置

Cluster health API 接受以下请求参数：

wait_for_status：

green、yellow 或 red 中的一种。将等待（直到提供的超时）直到集群的状态更改为提供的或更好的状态，（green > yellow > red）。默认情况下，不会等待任何状态。
wait_for_no_relocating_shards:

一个布尔值，它控制是否等待（直到提供的超时）集群中没有重定位的分片。默认为 false，这意味着它不会等待重新定位分片。
wait_for_no_initializing_shards:

一个布尔值，它控制是否等待（直到提供的超时）集群中没有初始化的分片。默认为 false，这意味着它不会等待初始化分片。
wait_for_active_shards:

一个数字，控制等待多少活动分片，等待集群中的所有分片都处于活动状态。默认为 0。
wait_for_nodes:

请求会一直等待，直到指定数量的 N 个节点可用。它还接受 >=N、⇐N、>N 和 <N。或者可以使用 ge(N)、le(N)、gt(N) 和 lt(N) 表示法。
wait_for_events:

可以是immediate、urgent、high、normal、low、languid。等到所有当前排队的具有给定优先级的事件都被处理。
timeout:

一个基于时间的参数，如果提供了其中一个 wait_for_XXX，则控制等待多长时间。默认为 30 秒。
master_timeout:

一个基于时间的参数，控制在 master 尚未被发现或断开连接时等待多长时间。如果未提供，则使用与 timeout 相同的值。
local:

如果为 true，则返回本地节点信息，并且不提供来自主节点的状态。默认值：false。

GET /_cluster/health?wait_for_status=yellow&timeout=50s