Elasticsearch：Elasticsearch執行個體FAQ

常見問題概覽

• 購買或退訂執行個體問題

  • 購買ES執行個體時選錯配置，如何處理？

  • ES購買頁的版本具體對應的是哪個版本？

  • 購買ES執行個體時，專用網路為空白，如何處理？

  • 購買ES執行個體時，已擁有對應的專用網路，但無法選擇虛擬交換器或虛擬交換器為空白，報錯vSwitch: may not be empty，如何解決？

  • 已購買的執行個體退訂後重新購買，執行個體的訪問地址會變嗎？

  • 如何釋放或退訂ES執行個體？

  • 我可以購買單機版的ES執行個體嗎？

  • 購買執行個體時，資源已經售罄怎麼辦？

  • 為什麼建議還在使用存量1核2 GiB規格的使用者儘快升級規格？

  • 購買ES後一直在建立中，如何處理？

  • ES叢集建立完成後，還需要單獨購買Kibana嗎？

  • 為什麼找不到已建立的執行個體？

  • 購買ES執行個體時，什麼情況下需要購買專有主節點和協調節點？

  • 購買ES執行個體時，輸入密碼的預設帳號是什嗎？

• 產品功能諮詢問題

  • 阿里雲ES支援版本升級或降級嗎？

  • ES支援通過SSH登入叢集修改配置嗎？

  • 6.7版本的Logstash和6.3版本的ES能夠相容嗎？

  • Quick BI支援ES資料來源嗎？

  • ES支援評分外掛程式嗎？

  • ES支援LDAP功能嗎？

  • ES有Java SDK嗎？

  • ES執行個體的核心版本在哪裡查看？

  • ES在使用過程中，什麼情況下可以使用強制重啟功能，使用該功能後會有什麼影響？

  • 如何確認ES的Log4j2漏洞已修複？

  • 如何?跨地區ES執行個體內網互連？

  • 如何在Elasticsearch叢集間遷移資料？

  • 開啟HTTPS協議是否需要購買協調節點？

  • ES單節點最大支援多少分區？

  • 以.monitoring-es開頭的索引是怎麼產生的？作用是什嗎？

  • ES資料盤開啟雲端硬碟加密，使用的密碼編譯演算法是什麼?

  • 阿里雲ES服務是否支援9300連接埠？

• 資料移轉與同步問題

  • 如何將MongoDB資料同步至阿里雲ES？

• 重啟執行個體問題

  • 重啟ES執行個體或節點需要多久？

  • 開啟或關閉ES執行個體的公網訪問時，會觸發執行個體重啟嗎？

  • 修改叢集訪問密碼，會觸發叢集重啟嗎？

  • 索引沒有副本，是否會影響叢集重啟？

  • 如何重啟角色節點（例如Kibana節點）或單個節點？

  • 重啟執行個體卡住了怎麼辦？

  • ES執行個體能設定定期重啟節點嗎？

• 叢集負載或狀態異常問題

  • 使用ES時，一部分節點的CPU和負載正常，另一部分處於空閑狀態，如何處理？

  • ES叢集狀態yellow，如何處理？

  • ES叢集負載高導致狀態red，如何處理？

  • 通過監控查看到或收到叢集警示，叢集CPU佔比過高，如何處理？

  • ES磁碟使用率過高，如何處理？

  • 通過監控查看到或收到叢集警示，ES記憶體佔比過高，如何處理？

  • shard分配不均，如何調整？

  • 叢集負載高，且主日誌報錯：java.lang.StackOverflowError for the entire cluster，如何處理？

  • 如何查詢JVM配置實際分配了多少記憶體？

• 叢集查詢與寫入問題

  • ES叢集查詢較長時間後返回結果，或不返回結果，如何處理？

  • 叢集寫入報錯Data too large... which is larger than the limit of，如何處理？

  • ES支援大量刪除索引嗎？

  • 建立索引時會偶現索引UUID衝突報錯（index uuid conflicted ），索引文檔寫不進去，怎麼辦？

  • 如何修改index.max_result_window（分頁查詢時查詢的最大文檔數量）？

  • ES更新資料時報錯：Rejecting mapping update to [] as the final mapping would have more than 1 type，如何處理？

  • 如何查詢索引中文檔的詳細內容？

  • 如何調整隊列大小？

  • 如何查詢或匯出指定時間段內的資料？

  • ES使用批量插入操作是否有數量限制？

  • Elasticsearch查詢結果與實際存在時間差，如何處理？

• 叢集配置與變更問題

  • 使用ES前，如何合理規劃叢集的資源和規格以及shard的大小和數量？

  • 如何查看ES執行個體的配置參數？

  • 變更集群配置會影響ES服務嗎？

  • 變更節點數後，叢集會自動重新規劃分區嗎？

  • ES支援變更雲端硬碟類型嗎？

  • ES支援將其他類型的節點變為冷資料節點嗎？

  • 升級了執行個體規格後，可以降低配置嗎，如何操作？

  • 業務量臨時突增，如何變更集群配置，來保證業務正常進行？

  • 升配叢集時，提示UpgradeVersionMustFromConsole如何處理？

  • 升級ES版本需要多長時間？

  • 升級ES版本會影響叢集服務嗎？

  • 升配叢集報錯或逾時，如何處理？

  • 叢集無法變更配置，如何處理？

  • ES支援修改JVM參數嗎？

  • 是否可以在叢集的YML檔案配置中，調整http.max_content_length和discovery.zen.ping_timeout值？

  • 我可以切換ES執行個體的VPC嗎？

  • ES執行個體變更雲端硬碟類型會導致已有的資料丟失嗎？

  • 叢集升配時，提示叢集不健康，但是叢集狀態確認是Green，如何處理？

  • ES可以直接升配CPU，避免資料移轉嗎？

  • 為什麼冷資料節點無法降配？

  • 縮容叢集資料節點時，出現“該操作會導致當前叢集資源（Disk/CPU/Memory）不足或shard分配異常”的報錯，如何處理？

  • 縮容叢集資料節點時，出現“叢集目前狀態異常或有未完成任務”的報錯，如何處理？

  • 縮容叢集資料節點時，出現“保留節點數需大於2”的報錯，如何處理？

  • 縮容叢集資料節點時，出現“當前ES叢集配置不支援該操作”的報錯，如何處理？

  • 使用auto_expand_replicas索引，導致資料移轉或者節點縮容失敗，如何處理？

  • ES如何清理緩衝？

  • 如何變更ES叢集的可用性區域？

• 外掛程式、分詞、同義字問題

  • 使用IK分詞器時，如何自訂擴充分詞詞典內容？

  • 使用IK分詞外掛程式時，提示ik startOffset報錯，如何處理？

  • 本地IK詞庫檔案丟失，可以在叢集管理頁面找回嗎？

  • 更新IK分詞詞庫後，如何使新的詞庫對之前的資料生效？

  • FullGC有標準值嗎？

  • 不使用的外掛程式可以卸載嗎？

  • ES的IK分詞外掛程式和開源版本的IK外掛程式的詞庫一致嗎？

  • 自訂外掛程式可以訪問外部網路嗎，例如讀取Github上的詞庫檔案？

  • 自訂外掛程式支援熱更新功能嗎？

  • analysis-aliws分詞是如何配置的，檔案的格式是什麼樣的？

  • ES同義字、IK分詞、AliNLP分詞有哪些區別？

  • ES IK分詞模式在哪裡配置？

  • 阿里雲ES支援哪些內建的中文分詞器？

  • 通過OSS熱更新詞典檔案，OSS側詞典檔案內容發生變化，ES側會自動更新嗎？

  • 阿里雲ES使用的IK分詞器是否支援遠程字典？

  • 阿里雲ES 7.10版本執行個體如何安裝向量檢索外掛程式（aliyun-knn）？

  • 安裝外掛程式重啟會影響叢集服務嗎？

• 日誌問題

  • ES支援設定.security日誌的儲存時間嗎？

  • ES如何將日誌儲存到本地？

  • 查看不到ES的查詢和更新日誌，如何處理？

  • 如何配置和查看ES執行個體的慢日誌？

  • 如何通過程式定期拉取ES的慢日誌？

  • 如何查有哪些用戶端在使用ES執行個體？

• 資料備份與恢複問題

  • ES執行個體的快照能恢複到其他版本的執行個體中嗎？

  • 備份ES資料時，提示叢集狀態不健康，如何處理？

  • 開啟了自動備份，但是沒有設定過OSS，是不是沒有備份成功？

  • 通過快照遷移（恢複）資料時，目標端顯示分區異常。通過分區恢複指令POST /_cluster/reroute?retry_failed=true依舊無法成功，且對應索引顯示異常，如何處理？

  • ES中的資料是否可以匯出到本地？

  • 如何?跨叢集恢複快照？

  • 阿里雲ES有哪些資料備份方案？

• 叢集監控警示問題

  • 如何配置X-Pack Watcher警示？

  • 出現GC記憶體無法分配的警示，如何處理？

  • 叢集狀態指標數值分別表示什麼意思？

  • 如何查看ES的磁碟使用方式？

  • CMS GC時報錯promotion failed，如何處理？

• 訪問叢集問題

  • 如何使用用戶端串連阿里雲ES叢集，與開源ES有什麼區別？

  • 通過用戶端訪問ES執行個體時，可以關閉Basic Auth（安全認證）嗎？

  • 阿里雲ECS和ES的VPC相同，但可用性區域不同，那ECS可以通過內網訪問ES嗎？

  • 如何配置ES的公網或私網訪問白名單？

  • 如何通過外網串連ES執行個體？

  • 無法訪問ES，報錯Failed to establish a new connection: [Errno 61] Connection refused

  • 重設密碼是否會影響ES訪問？

  • Elasticsearch-Head外掛程式5.0.0版本無法訪問阿里雲ES（所有版本），如何處理？

購買ES執行個體時選錯配置，如何處理？

以上未提到的配置，請在叢集升配頁面或者降配頁面進行查驗，詳情請參見升配叢集和降配叢集。

ES購買頁的版本具體對應的是哪個版本？

購買時，如果您已擁有自建叢集，建議您選擇相近的版本，比如小版本相近；如果沒有自建叢集，建議您選擇最新版本。

購買ES執行個體時，專用網路為空白，如何處理？

請參見查看RAM使用者資訊，檢查是否已經為RAM使用者授予了擷取Virtual Private Cloud（Virtual Private Cloud）列表的許可權。如果沒有授權，請參見建立自訂權限原則，為RAM使用者授權。

購買ES執行個體時，已擁有對應的專用網路，但無法選擇虛擬交換器或虛擬交換器為空白，報錯vSwitch: may not be empty，如何解決？

此報錯是由於您選擇的可用性區域下沒有可用的虛擬交換器。需要回到購買頁的叢集配置頁面，查看所選的可用性區域，同時進入專用網路控制台下的交換器頁面，確認對應可用性區域下是否有可用的交換器。如果沒有需要建立，建立方式請參見搭建IPv4專用網路。

已購買的執行個體退訂後重新購買，執行個體的訪問地址會變嗎？

會變化。建議您購買新執行個體後，先修改對應的用戶端代碼，再退訂舊執行個體，保證業務不間斷。

如何釋放或退訂ES執行個體？

• 隨用隨付和已到期的訂用帳戶執行個體，釋放請參見釋放執行個體。

• 未到期的訂用帳戶執行個體：

在控制台頂部功能表列選擇費用 > 訂單，在費用與成本頁面的退訂管理中進行退訂。更多資訊，請參見國際站退訂方式說明。

我可以購買單機版的ES執行個體嗎？

不支援，購買時至少需要選擇兩個資料節點，詳情請參見購買頁面參數。

購買執行個體時，資源已經售罄怎麼辦？

如果調整需求後仍然沒有資源，建議您等待一段時間再購買。執行個體資源是動態，如果資源不足，阿里雲會儘快補充資源，但是需要一定時間。

為什麼建議還在使用存量1核2 GiB規格的使用者儘快升級規格？

受規格庫存及效能穩定性影響，自2021年5月起，Elasticsearch不再提供1核2 GiB規格的資料節點的新購，存量節點使用不受影響。1核2 GiB規格執行個體只適合於學習情境，不適用於生產環境，根據產品SLA協議不在售後保障範圍內。建議您儘快將1核2 GiB規格升級至高規格，詳情請參見升配叢集。

購買ES後一直在建立中，如何處理？

執行個體建立後，需要一段時間才會生效。時間長短與您的叢集規格、資料結構和大小等相關，一般在小時層級。

ES叢集建立完成後，還需要單獨購買Kibana嗎？

為什麼找不到已建立的執行個體？

請您檢查下所選地區是否正確，建議您在ES控制台上方選擇地區處查看。 如果地區正常，ES執行個體仍然找不到，建議您清除瀏覽器緩衝或更換本網環境進行嘗試。

購買ES執行個體時，什麼情況下需要購買專有主節點和協調節點？

協調節點主要承擔所有的查詢和寫入請求，為資料節點做請求轉寄，同時merge資料節點的查詢結果，一般agg情境建議購買獨立的協調節點。一般建議按數量1:5添加獨立的協調節點（1協調對應5個資料節點，最少2個），規格建議和資料節點保持一致。更詳細的規格容量評估方案，請參見規格容量評估。

購買ES執行個體時，輸入密碼的預設帳號是什嗎？

預設帳號是elastic。您也可以建立自訂帳號，具體操作請參見通過Elasticsearch X-Pack角色管理實現使用者權限管控。

阿里雲ES支援版本升級或降級嗎？

僅部分版本（5.5升級5.6版本、5.6升級6.3版本、6.3升級6.7版本）支援直接升級版本。

如果您有其他版本間的升級需求或降版本需求，請先購買目標版本ES執行個體，再將原執行個體中的資料移轉至目標執行個體中，最後退訂或釋放原執行個體，間接完成版本升級或降級。

• 直接升級版本，請參見升級版本。

• 建立新ES執行個體，請參見建立阿里雲ES執行個體。

• 阿里雲ES執行個體間資料移轉，請參見阿里雲ES執行個體間資料移轉方案選取指南。

• 退訂未到期的訂用帳戶執行個體，請參見退訂和退款說明；釋放隨用隨付執行個體，請參見釋放執行個體。

ES支援通過SSH登入叢集修改配置嗎？

不支援。為確保安全性，ES不支援通過SSH登入叢集。如果您需要修改叢集配置，可通過ES的叢集配置功能實現，詳情請參見叢集配置概述。

6.7版本的Logstash和6.3版本的ES能夠相容嗎？

可以相容。更多相容性說明請參見產品相容性。

Quick BI支援ES資料來源嗎？

不支援。您可以通過Kibana進行資料分析與展示。

ES支援評分外掛程式嗎？

ES支援通過索引建立分詞器進行資料搜尋，同時也支援評分排序，詳情請參見步驟五：搜尋資料。

ES支援LDAP功能嗎？

ES產品側支援LDAP功能。如果您需要使用LDAP協議對接ES進行認證，需要先在本地搭建對應ES版本叢集環境進行測試，測試沒問題後再在ES控制台配置對應的模板，詳情請參見X-Pack整合LDAP認證最佳實務。

ES有Java SDK嗎？

有的，不同的ES版本對應不同的SDK，具體使用方式請參見Java API。

ES執行個體的核心版本在哪裡查看？

ES在使用過程中，什麼情況下可以使用強制重啟功能，使用該功能後會有什麼影響？

如果執行個體狀態顯示為非正常狀態（黃色或紅色），則不支援重啟操作。此時，您需要對執行個體進行強制重啟。使用該功能，可能會導致服務在重啟階段不穩定、資料丟失或者讀寫資料失敗等，請謹慎操作。

如何確認ES的Log4j2漏洞已修複？

叢集重啟成功即可完成漏洞修複，詳細資料請參見【漏洞預警】Apache Log4j2遠程代碼執行漏洞。

修複Log4j2漏洞需要升級ES版本嗎？

不需要，直接按照修複流程操作即可。

如何?跨地區ES執行個體內網互連？

如何在Elasticsearch叢集間遷移資料？

不同的遷移情境（Elasticsearch間遷移、自建Elasticsearch遷移至阿里雲、第三方Elasticsearch遷移至阿里雲等）需要使用不同的遷移方案和工具，詳細資料請參見遷移方案選取指南。

開啟HTTPS協議是否需要購買協調節點？

以下ES版本開啟HTTPS時不需要購買協調節點，且已購買的協調節點可以關閉。

• 7.16及以上版本。

除上述版本外，其他ES版本開啟HTTPS時必須開啟協調節點，且協調節點購買後不支援退訂和關閉。

為了提高安全性，在開啟HTTPS後，Elasticsearch會定期維護並更新所依賴的認證。因低版本（7.10及以下）暫不支援熱更新安裝在資料節點上的認證，為了降低更新認證時重啟節點對線上業務的影響，Elasticsearch會將認證部署在負責轉寄請求的協調節點上。如果您還未購買協調節點，在開啟HTTPS協議前，系統會提示您購買協調節點，請按照提示購買協調節點後再進行操作，詳細資料請參見使用HTTPS協議。

ES單節點最大支援多少分區？

ES 7.x版本最大支援1000個分區，其他版本無限制。您需要根據叢集規格，合理設定單個資料節點的shard數，詳細資料請參見規格容量評估和Size your shards。

PUT /_cluster/settings
{
   "transient": {
      "cluster": {
        "max_shards_per_node":10000
      }
   }
}

以.monitoring-es開頭的索引是怎麼產生的？作用是什嗎？

預設情況下，X-Pack監控用戶端會每隔10s採集一次叢集的監控資訊，並儲存到對應Elasticsearch執行個體的以.monitoring-*為首碼的索引中。以6.x版本執行個體為例，主要有.monitoring-es-6-*和.monitoring-kibana-6-*這兩種索引，以天為單位滾動建立。採集完的資訊會儲存在以.monitoring-es-6-為首碼，以當前日期為尾碼的索引中。

其中.monitoring-es-6-*索引佔用磁碟空間較大，主要存放了叢集狀態、叢集統計、節點統計、索引統計等資訊，更多詳細資料請參見配置Monitoring監控日誌。

ES資料盤開啟雲端硬碟加密，使用的密碼編譯演算法是什麼?

ES的雲端硬碟加密採用行業標準的AES-256密碼編譯演算法，利用Key Management Service（Key Management Service）加密雲端硬碟，詳細資料請參見加密雲端硬碟。

阿里雲ES服務是否支援9300連接埠？

如何將MongoDB資料同步至阿里雲ES？

您可以通過Monstache將MongoDB資料即時同步至Elasticsearch，具體操作請參見通過Monstache即時同步MongoDB資料至Elasticsearch。

重啟ES執行個體或節點需要多久？

在重啟ES執行個體或節點時，頁面上會顯示預估時間，這個時間是根據您的叢集規格、資料結構和大小等進行評估的。重啟執行個體耗時較長，一般在小時層級，詳情請參見重啟執行個體或節點。

開啟或關閉ES執行個體的公網訪問時，會觸發執行個體重啟嗎？

不會。但是會有短暫的生效狀態變更，不影響正常使用。

修改叢集訪問密碼，會觸發叢集重啟嗎？

不會。密碼變更只會觸發叢集重新載入，不會觸發重啟，詳細資料請參見重設執行個體訪問密碼。

索引沒有副本，是否會影響叢集重啟？

會影響，可能會導致重啟過程中無法對外持續提供服務。如果叢集整體負載不高且索引存在副本分區，一般情況下重啟過程中可對外持續提供服務。但在某些情境下，重啟過程中可能會出現訪問逾時，例如強制重啟並發度高、叢集負載很高並且已經存在叢集訪問停用情況、沒有副本分區、在重啟或強制重啟過程中存在大量的寫入和查詢等情境，建議重啟前先在用戶端設計好重試機制並且在業務低峰期進行操作。

如何重啟角色節點（例如Kibana節點）或單個節點？

• 重啟角色節點

  在執行個體的基本資料頁面單擊重啟，選擇操作類型為角色節點重啟，並選擇對應的角色節點，即可對該角色節點進行重啟。具體操作請參見重啟執行個體或節點。

• 重啟單個節點

  您可以通過以下兩種方式重啟單個節點：

  • 在執行個體的基本資料頁面單擊重啟，選擇操作類型為節點重啟，並選擇對應的節點，即可對該節點進行重啟。具體操作請參見重啟執行個體或節點。

  • 在執行個體的基本資料頁面下方的節點可視化地區中，將滑鼠移動到對應節點上，在彈出框中單擊重啟即可。具體操作請參見查看叢集狀態和節點資訊。

重啟執行個體卡住了怎麼辦？

ES執行個體能設定定期重啟節點嗎？

目前不支援定期重啟節點。如果您有該需求，可以嘗試使用API（RestartInstance）的方式，但是需要您自己寫定時任務和配置對應的節點資訊。

使用ES執行個體時，一部分節點的CPU和負載正常，另一部分處於空閑狀態，如何處理？

ES叢集狀態yellow，如何處理？

• 問題原因

  當您設定的索引複本數大於當前節點數減1時，會導致叢集處於yellow狀態。

• 解決方案

  通過GET _cat/indices?v命令查看索引分區的分布情況，定位yellow狀態的索引，並將其副本分區數設定為0。等待叢集恢複正常後，再將對應索引的副本分區數設定為原來的值。

  警告

  將副本分區數設定為0後，當節點掉線時，可能會導致資料丟失，請謹慎操作。待叢集恢複正常後（大約1分鐘），請儘快將副本分區數恢複到原來的值。

  PUT test/_settings
  {
    "index" : {
      "number_of_replicas":"0"
    }
  }                                

ES叢集負載高導致狀態red，如何處理？

主分區所在的節點異常會導致叢集red。您可以通過GET /_cat/indices?v命令查看索引分區的分布情況，定位到red索引，並按照以下常見原因和解決方案排查解決。

通過監控查看到或收到叢集警示，叢集CPU佔比過高，如何處理？

ES磁碟使用率過高，如何處理？

通過監控查看到或收到叢集警示，ES記憶體佔比過高，如何處理？

shard分配不均，如何調整？

叢集負載高，且主日誌報錯：java.lang.StackOverflowError for the entire cluster，如何處理？

主日誌報錯：java.lang.StackOverflowError for the entire cluster，表示Lucene堆疊溢位，與正則和模糊查詢相關，目前Elasticsearch 6.0及以上版本已修複。建議您儘快升級叢集版本，或者最佳化查詢語句，詳細資料請參見java.lang.StackOverflowError for the entire cluster。

如何查詢JVM配置實際分配了多少記憶體？

可通過GET _nodes/stats/jvm?pretty命令查看，預設為叢集記憶體的一半，不支援修改。

如何調整隊列大小？

如何查詢或匯出指定時間段內的資料？

您可以通過Elasticsearch中的range查詢實現查詢指定時間段內的資料，詳細資料請參見Range query。

如果要匯出指定時間段內的資料，可以通過Logstash進行過濾，詳細資料請參見Logstash設定檔說明。

ES使用批量插入操作是否有數量限制？

Bulk預設設定批量提交的資料量不能超過100 MB。如果超過該限制，您可以調整寫入資料量。每次寫入請求的資料量=文檔數量*單個文檔的大小。僅憑文檔數量可能無法準確評估寫入資料量的大小，它取決於您每個文檔的大小及複雜性。如果您的單個文檔資料量很大，可以適當減少文檔數量。一般建議每次寫入請求的資料量從5 MB~15 MB開始調試，預設不能超過100 MB（詳細資料請參見HTTP settings）。具體調試方案，請參見官方使用和調試批量請求文檔。

Elasticsearch查詢結果與實際存在時間差，如何處理？

ES叢集查詢較長時間後返回結果，或不返回結果，如何處理？

叢集寫入報錯Data too large... which is larger than the limit of，如何處理？

• 問題原因

  寫入過高，觸發熔斷，叢集資源無法滿足目前大量的寫入。

• 解決方案

  重要

  如果以下操作無法執行，需要先停止所有查詢和寫入，然後強制重啟叢集，待叢集恢複正常狀態後再操作。

  1. 執行POST /索引名/_cache/clear?fielddata=true命令，清理索引緩衝。如果無法解決，繼續執行以下步驟。

  2. 執行GET /_cat/indices?v命令，查看叢集中是否存在shard分配不均的問題，詳細說明及調整方法請參見shard分配不均，如何調整？。如果無法解決，繼續執行以下步驟。

  3. 降低並發寫入量，刪除無用的索引釋放資源，減少Kibana monitoring的使用。

     關閉Kibana monitoring執行以下命令：

     PUT _cluster / settings {
     	"persistent": {
     		"xpack.monitoring.collection.enabled": false
     	}
     }

     如果無法解決，繼續執行以下步驟。

  4. 通過升配叢集擴容叢集規格。

ES支援大量刪除索引嗎？

建立索引時會偶現索引UUID衝突報錯（index uuid conflicted ），索引文檔寫不進去，怎麼辦？

已知問題，需要將執行個體的核心版本升級到1.5.0及以上版本，具體操作請參見升級版本。

如何修改index.max_result_window（分頁查詢時查詢的最大文檔數量）？

ES預設的index.max_result_window（分頁查詢時查詢的最大文檔數量）參數值為10000（from+size），查詢時超過該值將報錯Result window is too large, from + size must be less than or equal to: [10000]。

PUT /my_index/_settings  
{  
  "index": {  
    "max_result_window": 50000  
  }
}

ES更新資料時報錯：Rejecting mapping update to [] as the final mapping would have more than 1 type，如何處理？

如何查詢索引中文檔的詳細內容？

GET _search
{
   "query": {
   "match_all": {}
  }
}

您也可以通過Kibana中的discover工具查看（需要先建立Index Pattern），具體操作請參見Kibana Guide。

使用ES前，如何合理規劃叢集的資源和規格以及shard的大小和數量？

您可以參見規格容量評估進行規劃。

如何查看ES執行個體的配置參數？

可在執行個體的基本資料頁面查看，詳情請參見查看執行個體的基本資料。

當您使用Transport Client訪問ES執行個體時，cluster.name為執行個體ID，詳情請參見Transport Client（5.x）。

變更集群配置會影響ES服務嗎？

變更集群配置會導致叢集重啟。目前阿里雲ES叢集重啟是採用滾動重啟的方式，在叢集狀態正常（綠色）、索引至少包含1個副本的情況下，如果資源使用率也不是特別高（可在叢集監控頁面查看，例如節點CPU使用率為80%左右，節點HeapMemory使用率為50%左右，節點load_1m低於當前資料節點的CPU核心數），那麼叢集在重啟期間能夠持續提供服務。但建議在業務低峰期進行操作。

變更節點數後，叢集會自動重新規劃分區嗎？

會。 ES資料節點數變更後，叢集會自動重新規劃分區，但自動重新規劃分區也不能保證所有資料一定是完全均勻分配的。受索引大小、分區數、節點數等多種因素影響，資料重新分配後依然有機率出現資料在分區上的分配不均勻情況。分區分配不均的排查方法和解決方案，請參見叢集負載不均問題的分析方法及解決方案。

ES執行個體支援變更雲端硬碟類型嗎？

支援。雲端硬碟降配時，支援雲端硬碟儲存效能由高到低依次為：ESSD雲端硬碟、SSD雲端硬碟、高效雲端硬碟；雲端硬碟升配時，支援雲端硬碟儲存效能由低到高依次為：高效雲端硬碟、SSD雲端硬碟、ESSD雲端硬碟。

ES支援將其他類型的節點變為冷資料節點嗎？

不支援，會導致執行個體不穩定，詳情請參見“Hot-Warm” Architecture in Elasticsearch 5.x。

升級了執行個體規格後，可以降低配置嗎，如何操作？

支援降配，詳情請參見縮容叢集資料節點或者降配叢集。

業務量臨時突增，如何變更集群配置，來保證業務正常進行？

升配叢集時，提示UpgradeVersionMustFromConsole如何處理？

出現此問題的原因是版本變更不符合要求。目前阿里雲ES只支援5.5.3版本升級到5.6.16版本、5.6.16版本升級到6.3.2版本、6.3.2版本升級到6.7.0版本，暫不支援其他版本間的升級。

升級ES版本需要多長時間？

具體時間長度與您叢集中的資料大小、資料結構、叢集規格等都有關係。一般為1個小時左右。

升級ES版本會影響叢集服務嗎？

升級期間可以繼續向叢集寫入資料或從叢集讀取資料，但不能進行其他變更操作，建議在流量低峰期進行。升級的注意事項和操作步驟請參見升級版本。

升配叢集報錯或逾時，如何處理？

導致升配叢集報錯或逾時的最常見原因是叢集狀態不正常。出現此種情況時，建議您先停止查詢和寫入，參見ES叢集負載高導致狀態red，如何處理？進行處理，待叢集狀態正常後再進行升配操作。您也可以在升配時進行強制變更，忽略叢集健康狀態，但此操作可能會影響ES服務，請謹慎操作。

其他原因導致的升配問題，需要您根據報錯資訊自行排查解決。

叢集無法變更配置，如何處理？

是否可以在叢集的YML檔案配置中，調整http.max_content_length和discovery.zen.ping_timeout值？

我可以切換ES執行個體的VPC嗎？

不支援切換。您可以重新購買一個對應VPC下的ES執行個體，然後遷移資料，再釋放原執行個體。

ES執行個體變更雲端硬碟類型會導致已有的資料丟失嗎？

不會。已經存在的資料不會丟失，但是持續寫入的新資料有丟失的風險，建議在業務低峰期或者停止寫入後執行升配，詳細資料請參見升配叢集。

叢集升配時，提示叢集不健康，但是叢集狀態確認是Green，如何處理？

叢集中可能存在close狀態的索引，可通過POST /<index_name>/_open命令，將對應索引的狀態暫時設定為open，詳細資料請參見升配叢集。

ES可以直接升配CPU，避免資料移轉嗎？

不可以。升配或降配CPU會觸發藍綠變更，導致節點IP地址發生變化，並且資料會從舊節點遷移到新節點。

為什麼冷資料節點無法降配？

叢集降配是有一定條件限制的，例如降配所選的目標規格的CPU和記憶體均需大於或等於當前規格的1/2，且不支援將節點規格降配至1核2 GiB、2核2 GiB、4核4 GiB和2核4 GiB等，詳細資料請參見使用限制。

如果不滿足降配條件，您可以選擇建立執行個體，遷移資料後再釋放原來的叢集，遷移資料的具體方案可參見遷移方案選取指南。

縮容叢集資料節點時，出現“該操作會導致當前叢集資源（Disk/CPU/Memory）不足或shard分配異常”的報錯，如何處理？

PUT _template/template_1
{
  "template": "*",
  "settings": {
    "number_of_replicas": 2
  }
}  

縮容叢集資料節點時，出現“叢集目前狀態異常或有未完成任務”的報錯，如何處理？

建議您通過智能營運診斷叢集健康情況，並根據診斷結果和診斷建議處理報錯。具體操作請參見診斷叢集健康情況。

縮容叢集資料節點時，出現“保留節點數需大於2”的報錯，如何處理？

為保證叢集的可靠性，保留的節點數必須大於等於2；對於多可用性區域執行個體，還需確保每個可用性區域節點數大於等於2，且每個可用性區域剩餘節點數相同。如果不滿足要求，需要重新選擇遷移或縮容的節點或者升配叢集。

縮容叢集資料節點時，出現“當前ES叢集配置不支援該操作”的報錯，如何處理？

使用GET _cluster/settings命令查看叢集配置，判斷是否存在不允許資料分配的配置，即"cluster.routing.allocation.enable" : "none"。如果存在，可將其暫時設定為允許，即"cluster.routing.allocation.enable" : "all"。如果該配置會影響您的其他動作，待縮容完成後需要再設定回去。

使用auto_expand_replicas索引，導致資料移轉或者節點縮容失敗，如何處理？

• 原因

  部分使用者使用了X-Pack提供的許可權管理功能，在早期版本中，該功能對應的.security索引預設會使用"index.auto_expand_replicas" : "0-all"配置，該配置會使得資料移轉或者節點縮容失敗。

• 解決方案

  1. 查看索引配置。

     GET .security/_settings

     返回如下結果。

     {
       ".security-6" : {
         "settings" : {
           "index" : {
             "number_of_shards" : "1",
             "auto_expand_replicas" : "0-all",
             "provided_name" : ".security-6",
             "format" : "6",
             "creation_date" : "1555142250367",
             "priority" : "1000",
             "number_of_replicas" : "9",
             "uuid" : "9t2hotc7S5OpPuKEIJ****",
             "version" : {
               "created" : "6070099"
             }
           }
         }
       }
     }

  2. 選擇其中一種方式修改配置。

     • 方式一

       PUT .security/_settings
       {
         "index" : {
           "auto_expand_replicas" : "0-1"
         }
       }

     • 方式二

       PUT .security/_settings
       {
         "index" : {
           "auto_expand_replicas" : "false",
           "number_of_replicas" : "1"
         }
       }

       重要

       number_of_replicas表示索引的副本個數，可以根據實際需求進行配置，但要保證至少有1個，且不大於可用的資料節點個數。

ES如何清理緩衝？

如何變更ES叢集的可用性區域？

參見遷移可用性區域節點操作。

ES叢集支援磁碟獨立擴容嗎？

ES支援修改JVM參數嗎？

阿里雲ES的JVM參數使用的是官方ES推薦的參數配置，預設為叢集記憶體的一半，不支援修改，最大可分配32 GB。詳細資料請參見Heap size settings。

使用IK分詞器時，如何自訂擴充分詞詞典內容？

您可以通過阿里雲ES的IK分詞外掛程式的冷更新或熱更新功能，添加或刪除詞典中的內容，詳情請參見使用IK分詞外掛程式（analysis-ik）。

使用IK分詞外掛程式時，提示ik startOffset報錯，如何處理？

以上報錯觸發了ES 6.7版本的bug，需要您重啟叢集，詳情請參見重啟執行個體或節點。

本地IK詞庫檔案丟失，可以在叢集管理頁面找回嗎？

無法找回，只能在叢集管理頁面上進行刪除和更新操作。建議您下載官方主分詞和停用分詞檔案，把對應的主分詞和停用詞改成您系統詞庫中的名詞，然後重新上傳。

更新IK分詞詞庫後，如何使新的詞庫對之前的資料生效？

需要重建索引。已經配置了IK分詞的索引，在IK詞典冷更新或熱更新操作完成後將只對新資料生效。如果您希望對全部資料生效，需要重建索引，詳情請參見配置reindex白名單。

FullGC有標準值嗎？

FullGC（清理整個堆空間）是否存在問題，需要通過業務延時，以及對比歷史和現在的狀況來分析。CMS回收器在記憶體為75%就會開始回收，需要留一點空間以應付突增流量。

不使用的系統外掛程式可以卸載嗎？

部分可卸載。可在系統預設外掛程式列表中查看，如果外掛程式對應的操作列下出現卸載，則表示該外掛程式可卸載，具體操作步驟請參見安裝或卸載系統預設外掛程式。

阿里雲ES的IK分詞外掛程式和開源版本的IK外掛程式的詞庫一致嗎？

一致。阿里雲ES IK外掛程式內建的詞庫就是對應版本的開源IK的詞庫，詳情請參見IK Analysis for Elasticsearch。

自訂外掛程式可以訪問外部網路嗎，例如讀取Github上的詞庫檔案？

自訂外掛程式不支援訪問外網。如果要訪問外部檔案，可將檔案上傳至阿里雲OSS上，通過串連OSS讀取檔案。

自訂外掛程式支援熱更新功能嗎？

不支援。如果需要熱更新，可參考IK詞典熱更新的方式，自行配置，詳情請參見IK Analysis for Elasticsearch。

analysis-aliws分詞是如何配置的，檔案的格式是什麼樣的？

具體配置方式請參見使用AliNLP分詞外掛程式（analysis-aliws）。

ES同義字、IK分詞、AliNLP分詞有哪些區別？

ES IK分詞模式在哪裡配置？

阿里雲ES提供了analysis-ik外掛程式，預設已安裝不能卸載。您可以對預設詞典進行冷熱更新，並在建立索引mappings時應用，詳細資料請參見使用IK分詞外掛程式（analysis-ik）。

阿里雲ES支援哪些內建的中文分詞器？

目前阿里雲ES支援的內建中文分詞器包括analysis-ik和analysis-aliws，您需要配置對應的詞典即可使用。

通過OSS熱更新詞典檔案，OSS側詞典檔案內容發生變化，ES側會自動更新嗎？

不會。阿里雲ES暫時不支援OSS檔案熱更新，OSS檔案內容發生變化後，需要重新手動設定上傳才會生效，不支援自動同步更新。並且對於已經配置了IK分詞、同義字或AliNLP分詞的索引，詞典更新後將只對新資料生效。如果您希望對全部資料生效，需要重建索引。

阿里雲ES使用的IK分詞器是否支援遠程字典？

不支援。阿里雲ES提供的IK分詞器支援上傳或更新詞典，詳細資料請參見使用IK分詞外掛程式（analysis-ik）。不支援遠程詞典及相關配置，例如IKAnalyzer.cfg.xml等。

阿里雲ES 7.10版本執行個體如何安裝向量檢索外掛程式（aliyun-knn）？

安裝外掛程式重啟會影響叢集服務嗎？

如果叢集整體負載不高且索引存在副本分區，一般情況下重啟（變更）過程中可對外持續提供服務。但在某些情境下，重啟（變更）過程中可能會出現訪問逾時，例如強制重啟並發度高、叢集負載很高並且已經存在叢集訪問停用情況、沒有副本分區、在重啟或強制重啟過程中存在大量的寫入和查詢等情境，建議重啟前先在用戶端設計好重試機制並且在業務低峰期進行操作。

ES支援設定.security日誌的儲存時間嗎？

ES如何將日誌儲存到本地？

可調用ListsearchLog API實現，詳情請參見ListSearchLog。

查看不到ES的查詢和更新日誌，如何處理？

可通過設定慢日誌，降低日誌記錄的時間戳記查看，詳情請參見相關文檔。

如何配置和查看ES執行個體的慢日誌？

如何通過程式定期擷取ES執行個體的慢日誌？

可調用阿里雲ES的ListSearchLog API實現，詳情請參見ListSearchLog。

如何查有哪些用戶端在使用ES執行個體？

訪問日誌和審計日誌的使用限制、注意事項以及開啟操作等詳細資料，請參見查詢日誌。

ES執行個體的快照能恢複到其他版本的執行個體中嗎？

如果是自動備份，則只能將快照恢複到原執行個體中或通過跨叢集快照恢複功能進行操作，詳情請參見自動備份與恢複和設定跨叢集OSS倉庫。

如果是手動備份，可以將快照恢複到其他執行個體中。一般是建議在相同版本之間恢複，不同版本之間可能存在相容性問題，詳情請參見手動備份與恢複。

阿里雲ES控制台上升級版本，備份ES資料時，提示叢集狀態不健康，如何處理？

ES叢集狀態不健康時，無法成功觸發快照備份，建議您優先恢複叢集狀態為green。

開啟了自動備份，但是沒有設定過OSS，是不是沒有備份成功？

阿里雲ES預設為您提供了一個OSS Bucket，您可以參見登入Kibana控制台，在Kibana中使用GET _snapshot/aliyun_auto_snapshot/_all命令，擷取自動備份的資料。

通過快照遷移（恢複）資料時，目標端顯示分區異常。通過分區恢複指令POST /_cluster/reroute?retry_failed=true依舊無法成功，且對應索引顯示異常，如何處理？

快照遷移（恢複）資料時，出現如下異常情況：

POST /_snapshot/aliyun_snapshot_from_instanceId/es-cn-instanceId_datetime/_restore
{
    "indices": "myIndex",
    "settings": {
    "max_restore_bytes_per_sec" : "150mb" 
    }
}

阿里雲ES中的資料是否可以匯出到本地？

阿里雲ES提供了資料備份功能，詳情請參見資料備份概述。您可以先將資料備份到OSS中，再通過OSS的控制台下載檔案功能將資料存放區到本地。

如何?跨叢集恢複快照？

跨叢集恢複快照的具體操作、限制條件和注意事項，請參見設定跨叢集OSS倉庫。對於同帳號跨地區的資料移轉情境，可以通過快照備份與恢複命令實現，更多遷移方案請參見遷移方案選取指南。

阿里雲ES有哪些資料備份方案？

阿里雲ES的資料備份方案，以及對應方案的使用情境和限制請參見資料備份概述。

如何配置X-Pack Watcher警示？

出現GC記憶體無法分配的警示，如何處理？

叢集狀態指標數值分別表示什麼意思？

如何查看ES的磁碟使用方式？

您可以通過控制台或Kibana的X-Pack監控查看ES的磁碟使用方式，詳細資料請參見指標含義與異常處理建議和配置Monitoring監控日誌。

CMS GC時報錯promotion failed，如何處理？

Elasticsearch在使用CMS記憶體回收行程時可能會遇到該錯誤，這通常表示老年代空間不足，對象晉陞（promotion）到老年代失敗。在Elasticsearch中，若出現此類CMS記憶體回收相關的問題，您可以考慮以下解決措施：

• 監控與日誌分析：

  • 查看GC日誌擷取詳細的記憶體回收資訊，分析是否存在頻繁的CMS GC操作或Full GC操作，確認是否因老年代空間不足導致CMS GC promotion failed。

  • 登入Elasticsearch日誌查詢頁面，搜尋包含promotion failed的相關日誌記錄，進一步瞭解問題的具體原因。

• 調整堆記憶體大小及記憶體回收行程設定：

  • 如果Elasticsearch版本>=6.7.0且資料節點記憶體>=32GB，建議您將記憶體回收行程切換至G1，以最佳化記憶體回收效能。

  • 根據叢集實際資源使用方式和業務需求，評估是否需要擴充執行個體記憶體。

• 調優建議：

  如果持續出現記憶體相關問題，可能需要整體評估索引資料量、查詢負載以及叢集資源配置，必要時聯絡阿里雲支援人員尋求專業調優指導。

如何使用用戶端串連阿里雲ES叢集，與開源ES有什麼區別？

使用阿里雲ES的內網或外網地址串連，對應開源ES的叢集地址，詳情請參見通過用戶端訪問Elasticsearch。

通過用戶端訪問ES執行個體時，可以關閉Basic Auth（安全認證）嗎？

不可以。Basic Auth是X-pack內建的Kibana認證機制，ES執行個體包含X-Pack功能，因此不支援關閉Basic Auth。

阿里雲ECS和ES的VPC相同，但可用性區域不同，那ECS可以通過內網訪問ES嗎？

可以。只要ECS和ES在同一VPC下，就可以通過內網訪問。

如何配置ES的公網或私網訪問白名單？

如何通過外網串連ES執行個體？

可通過執行個體的公網地址來串連，並且需要配置公網地址訪問白名單，詳情請參見配置執行個體公網或私網訪問白名單。串連時需要配置訪問網域名稱、使用者名稱和密碼等參數，詳情請參見通過用戶端訪問Elasticsearch。

無法訪問ES，報錯Failed to establish a new connection: [Errno 61] Connection refused

重設密碼是否會影響ES訪問？

Elasticsearch-Head外掛程式5.0.0版本無法訪問阿里雲ES（所有版本），如何處理？