重要的Elasticsearch配置 · my-elasticsearch-cn

# 重要的Elasticsearch配置雖然Elasticsearch僅需要很少的配置，但在進入生產使用之前還是需要手動配置一些配置。 - [path.data和path.logs](#path) - [cluster.name](#cluster-name) - [node.name](#node-name) - [bootstrap.memory\_lock](#bootstrap-memory_lock) - [network.host](#network-host) - [discovery.zen.ping.unicast.hosts](#discovery-zen-ping-unicast-hosts) - [discovery.zen.minimum\_master\_nodes](#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的前7個字符作為節點id。請注意，節點ID是持久化的，并且在節點重新啟動時不會更改，因此默認節點名稱也不會更改。值得配置一個更有意義的名稱，這也將有重新啟動節點后仍然存在的優勢： ``` node.name: prod-data-2 ``` node.name也可以設置為服務器的HOSTNAME，如下所示： ``` node.name: ${HOSTNAME} ``` ## bootstrap.memory\_lock 禁用JVM的swapped交換到磁盤對節點健康是至關重要的。實現的一種方法是將`bootstrap.memory_lock`設置為`true`。要使此設置生效，需要首先配置其他系統設置。有關如何正確設置內存鎖定的更多詳細信息，請參閱[啟用bootstrap.memory\_lock](Bootstrap_Checks/Memory_lock_check.md)。 ## network.host 默認情況下，Elasticsearch僅僅綁定在本地回路地址——如：127.0.0.1與\[::1\]。這在一臺服務器上跑一個開發節點是足夠的。 > 提示 > > 事實上，多個節點可以在單個節點上相同的`$ES_HOME`位置一天運行。這可以用于測試Elasticsearch形成集群的能力,但它不是一個推薦的配置方式用于生產。為了將其它服務器上的節點形成一個可以相互通訊的集群，你的節點將不能綁定在一個回路地址上。這里有更多的[網路配置](../Modules/Network_Settings.md)，通常你只需要配置`network.host`： ``` network.host: 192.168.1.10 ``` `network.host`也可以配置成一些能識別的特殊的值，譬如：`_local_`、`_site`、`_global_`，它們可以結合指定`:ip4`與`ip6`來使用。更多相信信息請參見：[網路配置](../Modules/Network_Settings.md#network-interface-values) > 重要 > > 一旦你自定義了`network.host`的配置，Elasticsearch將假設你已經從開發模式轉到了生產模式，并將升級系統檢測的警告信息為異常信息。更多信息請參見：[開發模式vs生產模式](Important_System_Configuration.md#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`避免腦裂](../Modules/Node.md#split-brain) 為避免腦裂，你需要根據`master`節點數來設置法定人數： ``` (master_eligible_nodes / 2) + 1 ``` 換句話說，如果你有三個`master`節點，最小的主節點數因被設置為`(3/2)+1`或者是`2` ``` discovery.zen.minimum_master_nodes: 2 ``` ## JVM heap dump path The?[RPM](https://www.elastic.co/guide/en/elasticsearch/reference/6.0/rpm.html "Install Elasticsearch with RPM")?and?[Debian](https://www.elastic.co/guide/en/elasticsearch/reference/6.0/deb.html "Install Elasticsearch with Debian Package")?package distributions default to configuring the JVM to dump the heap on out of memory exceptions to?`/var/lib/elasticsearch`. If this path is not suitable for storing heap dumps, you should modify the entry?`-XX:HeapDumpPath=/var/lib/elasticsearch`?in?[`jvm.options`](https://www.elastic.co/guide/en/elasticsearch/reference/6.0/setting-system-settings.html#jvm-options "Setting JVM options")?to an alternate path. If you specify a filename instead of a directory, the JVM will repeatedly use the same file; this is one mechanism for preventing heap dumps from accumulating in the heap dump path. Alternatively, you can configure a scheduled task via your OS to remove heap dumps that are older than a configured age. Note that the archive distributions do not configure the heap dump path by default. Instead, the JVM will default to dumping to the working directory for the Elasticsearch process. If you wish to configure a heap dump path, you should modify the entry?`#-XX:HeapDumpPath=/heap/dump/path`?in?[`jvm.options`](https://www.elastic.co/guide/en/elasticsearch/reference/6.0/setting-system-settings.html#jvm-options "Setting JVM options")?to remove the comment marker?`#`?and to specify an actual path. > my note > > `bootstrap.memory_lock` > `discovery.zen.ping.unicast.hosts` master節點和slave節點的配置 > `JVM heap dump path`