# 集群健康(Cluster Health) 集群健康API允許獲取一個非常簡單的關于該集群的健康狀態.比如,在一個只有一臺節點且有5個主分片和1個副本分片的集群可能是這樣的: ~~~ GET _cluster/health ~~~ 返回結果 ~~~ { "cluster_name" : "testcluster", "status" : "yellow", "timed_out" : false, "number_of_nodes" : 1, "number_of_data_nodes" : 1, "active_primary_shards" : 5, "active_shards" : 5, "relocating_shards" : 0, "initializing_shards" : 0, "unassigned_shards" : 5, "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": 50.0 } ~~~ 該API同樣能通過指定多個索引來獲取多個索引的健康狀態信息 ~~~ GET /_cluster/health/test1,test2 ~~~ 集群健康狀態有: green,yellow或者red.指的是分片級別的狀態,red狀態代表有指定的分片沒有分配,yellow狀態意味著集群里的主分片分配了但是副本分片沒有分配,green狀態意味著所有的分片都已經分配了.索引級別的狀態受到最壞的分片狀態影響.集群狀態是受到索引狀態的影響.該API的主要優點之一是能夠等待集群達到一定的高水位標志健康水平.比如,下面的例子將會等待50秒鐘直到集群達到yellow狀態(如果集群在50秒內達到green或yellow狀態),就會及時返回 ~~~ GET /_cluster/health?wait_for_status=yellow&timeout=50s ~~~ 請求參數 集群健康API接收如下的參數列表: * `level`,`cluster`,?`indices`?或?`shards`中的一個值.用來控制返回集群健康信息結果的級別.默認為`cluster` * `wait_for_status` `green`,?`yellow`?或?`red`中的一個值. 該請求會等待(提供的指定時間參數)直到集群請求變成指定的狀態值或更好的狀態.比如 green > yellow > red .默認的時候不需要等待任何狀態. * `wait_for_no_relocating_shards` 一個布爾類型的值,用來控制當集群沒有分片分配的時候是否等待.默認為false,意味著分片分配不需要等待 * `wait_for_active_shards` 該參數用來控制集群分片數量大于或等于該值才會返回結果,設置為"all"則意味著集群中所有分片都是激活的,設置為"0"則意味著不需要等待,默認為0 * `wait_for_nodes` 該參數是用來指定讓集群可用節點數量大于或等于該值的時候才會返回結果,該值的設置可用是 >N , =N.或者用另一種方式ge(N),gt(N),le(N)或lt(N). * `timeout` 一個時間參數用來設置wait_for_XXX的時間值,默認為30S * `local` 如果為true則返回本地節點信息而不提供從主節點來的狀態，默認為false 如下面的例子是從分片級別獲取集群健康狀態: ~~~ GET /_cluster/health/twitter?level=shards ~~~