# Cluster Allocation Explain API 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html) 譯文鏈接 : [http://www.apache.wiki/display/Elasticsearch/Cluster+Allocation+Explain+API](http://www.apache.wiki/display/Elasticsearch/Cluster+Allocation+Explain+API) 貢獻者 : [那伊抹微笑](/display/~wangyangting) **cluster allocation explanation API** 的目的是幫助回答這個問題 “為什么這個分片沒有被分配”。為了說明分片的分配（未分配狀態），發出一個這樣的請求 :? ``` $ curl -XGET 'http://localhost:9200/_cluster/allocation/explain' -d'{ "index": "myindex", "shard": 0, "primary": false }' ``` 指定您希望查看的說明的 **index** 和 **shard** 的 **id**，和 **primary** 標記一樣來指出是否 **explain** 一個主或者副本分片。 該響應如下 :? ``` { "shard" : { "index" : "myindex", "index_uuid" : "KnW0-zELRs6PK84l0r38ZA", "id" : 0, "primary" : false }, "assigned" : false, ① "shard_state_fetch_pending": false, ② "unassigned_info" : { "reason" : "INDEX_CREATED", ③ "at" : "2016-03-22T20:04:23.620Z" }, "allocation_delay_ms" : 0, ④ "remaining_delay_ms" : 0, ⑤ "nodes" : { "V-Spi0AyRZ6ZvKbaI3691w" : { "node_name" : "H5dfFeA", "node_attributes" : { ⑥ "bar" : "baz" }, "store" : { "shard_copy" : "NONE" ⑦ }, "final_decision" : "NO", ⑧ "final_explanation" : "the shard cannot be assigned because one or more allocation decider returns a 'NO' decision", "weight" : 0.06666675, ⑨ "decisions" : [ { ⑩ "decider" : "filter", "decision" : "NO", "explanation" : "node does not match index include filters [foo:\"bar\"]" } ] }, "Qc6VL8c5RWaw1qXZ0Rg57g" : { "node_name" : "bGG90GE", "node_attributes" : { "bar" : "baz", "foo" : "bar" }, "store" : { "shard_copy" : "AVAILABLE" }, "final_decision" : "NO", "final_explanation" : "the shard cannot be assigned because one or more allocation decider returns a 'NO' decision", "weight" : -1.3833332, "decisions" : [ { "decider" : "same_shard", "decision" : "NO", "explanation" : "the shard cannot be allocated on the same node id [Qc6VL8c5RWaw1qXZ0Rg57g] on which it already exists" } ] }, "PzdyMZGXQdGhqTJHF_hGgA" : { "node_name" : "DKDM97B", "node_attributes" : { }, "store" : { "shard_copy" : "NONE" }, "final_decision" : "NO", "final_explanation" : "the shard cannot be assigned because one or more allocation decider returns a 'NO' decision", "weight" : 2.3166666, "decisions" : [ { "decider" : "filter", "decision" : "NO", "explanation" : "node does not match index include filters [foo:\"bar\"]" } ] } } } ``` | 編號 | 描述 | | --- | --- | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-1) | Whether the shard is assigned or unassigned | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-2) | Whether information about the shard is still being fetched | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-3) | Reason for the shard originally becoming unassigned | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-4) | Configured delay before the shard can be allocated | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-5) | Remaining delay before the shard can be allocated | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-6) | User-added attributes the node has | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-7) | The shard copy information for this node and error (if applicable) | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-8) | Final decision and explanation of whether the shard can be allocated to this node | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-9) | Weight for how much the allocator would like to allocate the shard to this node | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO138-10) | List of node decisions factoring into final decision about the shard | 對于一個已經分配的分片來說，輸出與下面相似 :? ``` { "shard" : { "index" : "only-foo", "index_uuid" : "KnW0-zELRs6PK84l0r38ZA", "id" : 0, "primary" : true }, "assigned" : true, "assigned_node_id" : "Qc6VL8c5RWaw1qXZ0Rg57g", ① "shard_state_fetch_pending": false, "allocation_delay_ms" : 0, "remaining_delay_ms" : 0, "nodes" : { "V-Spi0AyRZ6ZvKbaI3691w" : { "node_name" : "bGG90GE", "node_attributes" : { "bar" : "baz" }, "store" : { "shard_copy" : "NONE" }, "final_decision" : "NO", "final_explanation" : "the shard cannot be assigned because one or more allocation decider returns a 'NO' decision", "weight" : 1.4499999, "decisions" : [ { "decider" : "filter", "decision" : "NO", "explanation" : "node does not match index include filters [foo:\"bar\"]" } ] }, "Qc6VL8c5RWaw1qXZ0Rg57g" : { "node_name" : "I8hydUG", "node_attributes" : { "bar" : "baz", "foo" : "bar" }, "store" : { "shard_copy" : "AVAILABLE" }, "final_decision" : "ALREADY_ASSIGNED", ② "final_explanation" : "the shard is already assigned to this node", "weight" : 0.0, "decisions" : [ { "decider" : "same_shard", "decision" : "NO", "explanation" : "the shard cannot be allocated on the same node id [Qc6VL8c5RWaw1qXZ0Rg57g] on which it already exists" } ] }, "PzdyMZGXQdGhqTJHF_hGgA" : { "node_name" : "H5dfFeA", "node_attributes" : { }, "store" : { "shard_copy" : "NONE" }, "final_decision" : "NO", "final_explanation" : "the shard cannot be assigned because one or more allocation decider returns a 'NO' decision", "weight" : 3.6999998, "decisions" : [ { "decider" : "filter", "decision" : "NO", "explanation" : "node does not match index include filters [foo:\"bar\"]" } ] } } } ``` | 編號 | 描述 | | --- | --- | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO139-1) | Node the shard is currently assigned to | | [](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/cluster-allocation-explain.html#CO139-2) | The decision is "ALREADY_ASSIGNED" because the shard is currently assigned to this node | 您也可以讓 **Elasticsearch explain** 第一個未分配分片的分配情況，它可以通過發送一個空的 **body** 來找到，例如 :? ``` $ curl -XGET 'http://localhost:9200/_cluster/allocation/explain' ``` 如果您想要去包含所有的那些我們考慮到的最終的決策的決定，該 _**`include_yes_decisions`?**_參數將返回所有的決策 :? ``` $ curl -XGET 'http://localhost:9200/_cluster/allocation/explain?include_yes_decisions=true' ``` 此外，通過設置 _**`include_disk_info`**_參數為 _**true**_，您可以返回通過集群信息服務返回收集到的信息，包括硬盤使用和分配大小。 ``` $ curl -XGET 'http://localhost:9200/_cluster/allocation/explain?include_disk_info=true' ```