重要Elasticsearch配置 · Elasticsearch 5.4 中文文檔

# 重要Elasticsearch配置原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/important-settings.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/important-settings.html) 譯文鏈接 : [http://www.apache.wiki/pages/editpage.action?pageId=4882617](http://www.apache.wiki/pages/editpage.action?pageId=4882617) 貢獻者 : [geekidentity](/display/~houfachao) [阿叩](/display/~luanqing) 校對 : [misaka nagisa](/display/~wangjueyimin) 雖然Elasticsearch僅需要很少的配置，但有許多設置需要手動配置，并且在進入生產之前絕對必須進行配置。 * `path.data`?和?`path.logs` * `cluster.name` * `node.name` * `bootstrap.memory_lock` * `network.host` * `discovery.zen.ping.unicast.hosts` * `discovery.zen.minimum_master_nodes` ### `path.data`?和?`path.logs` 如果使用.zip或.tar.gz歸檔，則數據和日志目錄是$ES_HOME的子文件夾。如果這些重要的文件夾保留在其默認位置，則存在將Elasticsearch升級到新版本時被刪除的高風險。在生產使用中，肯定得更改數據和日志文件夾的位置： ``` path: logs: /var/log/elasticsearch data: /var/data/elasticsearch ``` RPM和Debian發行版已經使用數據和日志的自定義路徑。 path.data設置可以設置為多個路徑，在這種情況下，所有路徑將用于存儲數據（屬于單個分片的文件將全部存儲在同一數據路徑上）： ``` path: data: - /mnt/elasticsearch_1 - /mnt/elasticsearch_2 - /mnt/elasticsearch_3 ``` ### `cluster.name` 節點只能在群集與群集中的所有其他節點共享其cluster.name時才能加入群集。默認名稱為elasticsearch，但您應將其更改為描述集群用途的適當名稱。 ``` cluster.name: logging-prod ``` 確保不要在不同的環境中重復使用相同的集群名稱，否則可能會導致加入錯誤集群的節點。 ### `node.name` 默認情況下，Elasticsearch將使用隨機生成的uuid的第一個字符作為節點id。請注意，節點ID是持久化的，并且在節點重新啟動時不會更改，因此默認節點名稱也不會更改。配置一個更有意義的名稱是值得的，這是重啟節點后也能一直保持的優勢： ``` node.name: prod-data-2 ``` node.name也可以設置為服務器的HOSTNAME，如下所示： ``` node.name: ${HOSTNAME} ``` ### `bootstrap.memory_lock` 沒有JVM被交換到磁盤上這事對于節點的健康來說是至關重要的。一種實現方法是將bootstrap.memory_lock設置為true。要使此設置生效，需要首先配置其他系統設置。有關如何正確設置內存鎖定的更多詳細信息，請參閱[啟用bootstrap.memory_lock](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-configuration-memory.html#mlockall)。 ## network.host 默認情況下，Elasticsearch僅僅綁定在本地回路地址——如：127.0.0.1與[::1]。這在一臺服務器上跑一個開發節點是足夠的。 > 提示 > > 事實上，多個節點可以在單個節點上相同的`$ES_HOME`位置一同運行。這可以用于測試Elasticsearch形成集群的能力,但這種配置方式不推薦用于生產環境。為了將其它服務器上的節點形成一個可以相互通訊的集群，你的節點將不能綁定在一個回路地址上。這里有更多的[網路配置](https://aqlu.gitbooks.io/elasticsearch-reference/content/Modules/Network_Settings.html)，通常你只需要配置`network.host`： ``` network.host: 192.168.1.10 ``` `network.host`也可以配置成一些能識別的特殊的值，譬如：`_local_`、`_site`、`_global_`，它們可以結合指定`:ip4`與`ip6`來使用。更多相信信息請參見：[網路配置](https://aqlu.gitbooks.io/elasticsearch-reference/content/Modules/Network_Settings.html#network-interface-values) > 重要 > > 一旦你自定義了`network.host`的配置，Elasticsearch將假設你已經從開發模式轉到了生產模式，并將升級系統檢測的警告信息為異常信息。更多信息請參見：[開發模式vs生產模式](https://aqlu.gitbooks.io/elasticsearch-reference/content/Setup_Elasticsearch/Important_System_Configuration.html#dev-vs-prod) ## discovery.zen.ping.unicast.hosts（單播發現）開箱即用，無需任何網絡配置，Elasticsearch將綁定到可用的回路地址，并掃描9300年到9305的端口去連接同一機器上的其他節點,試圖連接到相同的服務器上運行的其他節點。它提供了不需要任何配置就能自動組建集群的體驗。當與其它機器上的節點要形成一個集群時，你需要提供一個在線且可訪問的節點列表。像如下來配置： ``` discovery.zen.ping.unicast.hosts: - 192.168.1.10:9300 - 192.168.1.11 #① - seeds.mydomain.com #② ``` ① 未指定端口時，將使用默認的`transport.profiles.default.port`值，如果此值也為設置則使用`transport.tcp.port` * * * ② 主機名將被嘗試解析成能解析的多個IP ## discovery.zen.minimum_master_nodes 為防止數據丟失，配置`discovery-zen-minimum_master_nodes`將非常重要，他規定了必須至少要有多少個`master`節點才能形成一個集群。沒有此設置時，一個集群在發生網絡問題是可能會分裂成多個集群——腦裂——這將導致數據丟失。更多詳細信息請參見：[通過`minimum_master_nodes`避免腦裂](https://aqlu.gitbooks.io/elasticsearch-reference/content/Modules/Node.html#split-brain) 為避免腦裂，你需要根據`master`節點數來設置法定人數： ``` (master_eligible_nodes / 2) + 1 ``` 換句話說，如果你有三個`master`節點，最小的主節點數因被設置為`(3/2)+1`或者是`2` ``` discovery.zen.minimum_master_nodes: 2 ```