配置Elasticsearch · Elasticsearch 5.4 中文文檔

# 配置Elasticsearch 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html)（修改該鏈接為官網對應的鏈接）譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=4882615](http://www.apache.wiki/pages/viewpage.action?pageId=4882615)（修改該鏈接為 ApacheCN 對應的譯文鏈接）貢獻者 : @漫步 [geekidentity](/display/~houfachao) 校對 : [misaka nagisa](/display/~wangjueyimin) Elasticsearch本身具有適宜的默認值，且需要的配置很少。使用[Cluster Update Settings](https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-update-settings.html)(更新群集設置)API可以更改運行中集群里的大多數設置。配置文件應包含特定于節點的設置（例如node.name和路徑）或節點為了能夠加入群集而需要的設置，例如cluster.name和network.host。 ### 配置文件位置 Elasticsearch有兩個配置文件： * 用于配置Elasticsearch的elasticsearch.yml； * log4j2.properties用于配置Elasticsearch日志記錄。這些文件位于config目錄中，其位置默認為$ES_HOME/config/。Debian和RPM軟件包將config目錄位置設置為/etc/elasticsearch/。可以使用path.conf設置更改config目錄的位置，如下所示： ``` ./bin/elasticsearch -Epath.conf=/path/to/my/config/ ``` ### 配置文件格式配置格式為[YAML](http://www.yaml.org/)。下面是更改數據和日志的目錄路徑的示例： ``` path: data: /var/lib/elasticsearch logs: /var/log/elasticsearch ``` 設置也可以展平開如下： ``` path.data: /var/lib/elasticsearch path.logs: /var/log/elasticsearch ``` ### 環境變量替換配置文件中可以使用$ {...}符號引用環境變量的值，例如： ``` node.name: ${HOSTNAME} network.host: ${ES_NETWORK_HOST} ``` ### 設置的提示對于您不希望在配置文件中存儲的設置，您可以使用值${prompt.text}或${prompt.secret}并在控制臺啟動Elasticsearch。${prompt.secret}?禁用了echo，輸入的值不會在終端顯示; $ {prompt.text}將允許您在鍵入時看到值。例如： ``` node: name: ${prompt.text} ``` 當啟動Elasticsearch時，將提示您進行輸入，如下所示： ``` Enter value for [node.name]: ``` ![](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg)如果在設置中使用了${prompt.text}或${prompt.secret}，Elasticsearch進程將不能作為服務啟動或不能后臺運行。 ### 設置默認設置可以在命令行中設置新的默認設置。這將設置一個默認值，除非在配置文件中指定另一個值。例如，如果Elasticsearch按如下方式啟動： ``` ./bin/elasticsearch -Edefault.node.name=My_Node ``` node.name的值將為My_Node，但可以在命令行中使用es.node.name或在包含node.name的配置文件中覆蓋。 ### 日志配置 Elasticsearch使用[Log4j 2](https://logging.apache.org/log4j/2.x/)進行日志記錄。 Log4j 2可以使用log4j2.properties文件進行配置。 Elasticsearch公開了一個屬性${sys:es.logs}?，可以在配置文件中引用該屬性以確定日志文件的位置; 這將在運行時解析為Elasticsearch日志文件的前綴。例如，如果您的日志目錄（path.logs）是/var/log/elasticsearch并且您的集群名為production，那么$ {sys:es.logs}將解析為/var/log/elasticsearch/production。 ``` appender.rolling.type = RollingFile ① appender.rolling.name = rolling appender.rolling.fileName = ${sys:es.logs}.log ② appender.rolling.layout.type = PatternLayout appender.rolling.layout.pattern = [%d{ISO8601}][%-5p][%-25c] %.10000m%n appender.rolling.filePattern = ${sys:es.logs}-%d{yyyy-MM-dd}.log ③ appender.rolling.policies.type = Policies appender.rolling.policies.time.type = TimeBasedTriggeringPolicy ④ appender.rolling.policies.time.interval = 1 ⑤ appender.rolling.policies.time.modulate = true ⑥ ``` 1. 配置RollingFile appender 2. 記錄到/var/log/elasticsearch/production.log 3. 將日志記錄到/var/log/elasticsearch/production-yyyy-MM-dd.log 4. 使用基于時間的滾動策略 5. 每日滾動日志 6. 在日邊界對齊卷（而不是每二十四小時滾動一次） ![](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg)Log4j的配置解析會被任何無關的空格符所干擾;如果你復制、粘貼當前頁的Log4j配置或自己輸入Log4j配置時是要確認頭尾的空格符號是否修正。如果將.gz或.zip附加到appender.rolling.filePattern后，那么日志將在滾動時壓縮。如果要保留特定的時間段內的日志文件，則可以使用帶有刪除操作的滾動策略。 ``` appender.rolling.strategy.type = DefaultRolloverStrategy ① appender.rolling.strategy.action.type = Delete ② appender.rolling.strategy.action.basepath = ${sys:es.logs.base_path} ③ appender.rolling.strategy.action.condition.type = IfLastModified ④ appender.rolling.strategy.action.condition.age = 7D ⑤ appender.rolling.strategy.action.PathConditions.type = IfFileName ⑥ appender.rolling.strategy.action.PathConditions.glob = ${sys:es.logs.cluster_name}-* ⑦ ``` 1. 配置DefaultRolloverStrategy(默認滾動策略) 2. 配置Delete(刪除)操作處理策略 3. Elasticsearch日志路徑 4. 處理策略的條件 5. 保留7日日志 6. 僅刪除與指定通配符匹配的文件名或目錄中超出七日以上的文件 7. 刪除日志路徑下與${sys:es.logs.cluster_name}-*通配符匹配的文件；但這只是僅僅刪除匹配到的Elasticsearch日志，它不能同時刪除deprecation logs和slow logs。可以加載多個配置文件（在這種情況下，它們將被合并），只要它們命名為log4j2.properties并將Elasticsearch config目錄作為祖先; 這對于暴露其他日志記錄器的插件很有用。日志部分包含java包及其對應的日志級別。追加器部分包含日志的目標。有關如何自定義日志記錄和所有支持的追加器的詳細信息可以在[Log4j文檔](http://logging.apache.org/log4j/2.x/manual/configuration.html)中找到。 ### 棄用日志記錄除了常規日志記錄之外，Elasticsearch還允許您啟用已棄用操作的日志記錄。例如，這允許您早期確定，如果您需要在將來遷移某些功能。默認情況下，將在WARN級別啟用棄用日志記錄，這是將發出所有棄用日志消息的級別。 ``` logger.deprecation.level = warn ``` 這將在日志目錄中創建每日滾動deprecation日志文件。定期檢查此文件，特別是當您打算升級到新的主版本。默認的日志配置已為棄用日志設置了滾動策略，以在1 GB之后滾動和壓縮，并且最多保留五個日志文件（四個滾動日志和活動日志）。您可以通過將deprecation日志級別設置為error，在config / log4j2.properties文件中禁用它。