ES配置文件中文版

 

  1 ##################### Elasticsearch Configuration Example #####################
  2 
  3 # This file contains an overview of various configuration settings,
  4 # targeted at operations staff. Application developers should
  5 # consult the guide at <http://elasticsearch.org/guide>.
  6 #
  7 # The installation procedure is covered at
  8 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/setup.html>.
  9 #
 10 # Elasticsearch comes with reasonable defaults for most settings,
 11 # so you can try it out without bothering with configuration.
 12 #
 13 # Most of the time, these defaults are just fine for running a production
 14 # cluster. If you're fine-tuning your cluster, or wondering about the
 15 # effect of certain configuration option, please _do ask_ on the
 16 # mailing list or IRC channel [http://elasticsearch.org/community].
 17 
 18 # Any element in the configuration can be replaced with environment variables
 19 # by placing them in ${...} notation. For example:
 20 #全部的配置均可以使用環境變量，例如
 21 #node.rack: ${RACK_ENV_VAR}
 22 
 23 # For information on supported formats and syntax for the config file, see
 24 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/setup-configuration.html>
 25 
 26 
 27 ################################### Cluster ###################################
 28 
 29 # Cluster name identifies your cluster for auto-discovery. If you're running
 30 # multiple clusters on the same network, make sure you're using unique names.
 31 # 集羣名稱，默認爲elasticsearch
 32 #cluster.name: elasticsearch
 33 
 34 
 35 #################################### Node #####################################
 36 
 37 # Node names are generated dynamically on startup, so you're relieved
 38 # from configuring them manually. You can tie this node to a specific name:
 39 #節點名稱，es啓動時會自動建立節點名稱，但你也可進行配置
 40 #這些名稱默認是在es的lib目錄下的elasticsearch-1.4.4.jar文件中的config目錄下的names.txt文件中
 41 #node.name: "Franz Kafka"
 42 
 43 # Every node can be configured to allow or deny being eligible as the master,
 44 # and to allow or deny to store the data.
 45 #
 46 # Allow this node to be eligible as a master node (enabled by default):
 47 #(是否具有成爲主節點的資格)是否做爲主節點，每一個節點均可以被配置成爲主節點，默認值爲true：
 48 #node.master: true
 49 #
 50 # Allow this node to store data (enabled by default):
 51 #是否存儲數據，即存儲索引片斷，默認值爲true
 52 #node.data: true
 53 
 54 # You can exploit these settings to design advanced cluster topologies.
 55 #當master爲false，而data爲true時，會對該節點產生嚴重負荷；
 56 # 1. You want this node to never become a master node, only to hold data.
 57 #    This will be the "workhorse" of your cluster.
 58 #
 59 #node.master: false
 60 #node.data: true
 61 #當master爲true，而data爲false時，該節點做爲一個協調者；
 62 # 2. You want this node to only serve as a master: to not store any data and
 63 #    to have free resources. This will be the "coordinator" of your cluster.
 64 #
 65 #node.master: true
 66 #node.data: false
 67 #當master爲false，data也爲false時，該節點就變成了一個負載均衡器。
 68 # 3. You want this node to be neither master nor data node, but
 69 #    to act as a "search load balancer" (fetching data from nodes,
 70 #    aggregating results, etc.)
 71 #
 72 #node.master: false
 73 #node.data: false
 74 
 75 # Use the Cluster Health API [http://localhost:9200/_cluster/health], the
 76 # Node Info API [http://localhost:9200/_nodes] or GUI tools
 77 # such as <http://www.elasticsearch.org/overview/marvel/>,
 78 # <http://github.com/karmi/elasticsearch-paramedic>,
 79 # <http://github.com/lukas-vlcek/bigdesk> and
 80 # <http://mobz.github.com/elasticsearch-head> to inspect the cluster state.
 81 
 82 # A node can have generic attributes associated with it, which can later be used
 83 # for customized shard allocation filtering, or allocation awareness. An attribute
 84 # is a simple key value pair, similar to node.key: value, here is an example:
 85 #每一個節點均可以定義一些與之關聯的通用屬性，用於後期集羣進行分片分配時的過濾：
 86 #node.rack: rack314
 87 
 88 # By default, multiple nodes are allowed to start from the same installation location
 89 # to disable it, set the following:
 90 #默認狀況下，多個節點能夠在同一個安裝路徑啓動，若是你想讓你的es只啓動一個節點，能夠進行以下設置：
 91 #node.max_local_storage_nodes: 1
 92 
 93 
 94 #################################### Index ####################################
 95 
 96 # You can set a number of options (such as shard/replica options, mapping
 97 # or analyzer definitions, translog settings, ...) for indices globally,
 98 # in this file.
 99 #
100 # Note, that it makes more sense to configure index settings specifically for
101 # a certain index, either when creating it or by using the index templates API.
102 #
103 # See <http://elasticsearch.org/guide/en/elasticsearch/reference/current/index-modules.html> and
104 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/indices-create-index.html>
105 # for more information.
106 
107 # Set the number of shards (splits) of an index (5 by default):
108 #設置一個索引庫的分片數量，默認值爲5：
109 #index.number_of_shards: 5
110 
111 # Set the number of replicas (additional copies) of an index (1 by default):
112 #設置一個索引庫可被複制的數量，默認值爲1：
113 #index.number_of_replicas: 1
114 
115 # Note, that for development on a local machine, with small indices, it usually
116 # makes sense to "disable" the distributed features:
117 #當你想要禁用分佈式時，你能夠進行以下設置：
118 #index.number_of_shards: 1
119 #index.number_of_replicas: 0
120 
121 # These settings directly affect the performance of index and search operations
122 # in your cluster. Assuming you have enough machines to hold shards and
123 # replicas, the rule of thumb is:
124 # 這兩個屬性的設置直接影響集羣中索引和搜索操做的執行。假設你有足夠的機器來持有分片和複製品，
125 #    那麼能夠按以下規則設置這兩個值：
126 # 1. Having more *shards* enhances the _indexing_ performance and allows to
127 #    _distribute_ a big index across machines.
128 #擁有更多的分片能夠提高索引執行能力，並容許經過機器分發一個大型的索引；
129 # 2. Having more *replicas* enhances the _search_ performance and improves the
130 #    cluster _availability_.
131 #擁有更多的複製器可以提高搜索執行能力以及集羣能力。
132 # The "number_of_shards" is a one-time setting for an index.
133 #對於一個索引來講，number_of_shards只能設置一次
134 # The "number_of_replicas" can be increased or decreased anytime,
135 # by using the Index Update Settings API.
136 #而number_of_replicas能夠使用索引更新設置API在任什麼時候候被增長或者減小
137 #
138 # Elasticsearch takes care about load balancing, relocating, gathering the
139 # results from nodes, etc. Experiment with different settings to fine-tune
140 # your setup.
141 # ElasticSearch關注負載均衡、遷移、從節點彙集結果等等。能夠嘗試多種設計來完成這些功能。
142 # Use the Index Status API (<http://localhost:9200/A/_status>) to inspect
143 # the index status.
144 #能夠鏈接http://localhost:9200/A/_status來檢測索引的狀態。
145 
146 
147 #################################### Paths ####################################
148 
149 # Path to directory containing configuration (this file and logging.yml):
150 #配置文件所在的位置，即elasticsearch.yml和logging.yml所在的位置：
151 #path.conf: /path/to/conf
152 
153 # Path to directory where to store index data allocated for this node.
154 #分配給當前節點的索引數據所在的位置：
155 #path.data: /path/to/data
156 #
157 # Can optionally include more than one location, causing data to be striped across
158 # the locations (a la RAID 0) on a file level, favouring locations with most free
159 # space on creation. For example:
160 #能夠可選擇的包含一個以上的位置，使得數據在文件級別跨越位置，這樣在建立時就有更多的自由路徑，如：
161 #path.data: /path/to/data1,/path/to/data2
162 
163 # Path to temporary files:
164 # 臨時文件位置：
165 #path.work: /path/to/work
166 
167 # Path to log files:
168 #日誌文件所在位置：
169 #path.logs: /path/to/logs
170 
171 # Path to where plugins are installed:
172 # 插件安裝位置：
173 #path.plugins: /path/to/plugins
174 
175 
176 #################################### Plugin ###################################
177 
178 # If a plugin listed here is not installed for current node, the node will not start.
179 #若列表中的某一個插件未安裝，則節點沒法啓動：
180 #plugin.mandatory: mapper-attachments,lang-groovy
181 
182 
183 ################################### Memory ####################################
184 
185 # Elasticsearch performs poorly when JVM starts swapping: you should ensure that
186 # it _never_ swaps.
187 #
188 # Set this property to true to lock the memory:
189 #JVM開始交換時，ElasticSearch表現並很差：你須要保障JVM不進行交換，能夠將bootstrap.mlockall設置爲true禁止交換
190 #bootstrap.mlockall: true
191 
192 # Make sure that the ES_MIN_MEM and ES_MAX_MEM environment variables are set
193 # to the same value, and that the machine has enough memory to allocate
194 # for Elasticsearch, leaving enough memory for the operating system itself.
195 #請確保ES_MIN_MEM和ES_MAX_MEM的值是同樣的，而且可以爲ElasticSearch分配足夠的內在，併爲系統操做保留足夠的內存
196 # You should also make sure that the Elasticsearch process is allowed to lock
197 # the memory, eg. by using `ulimit -l unlimited`.
198 #你應該確保Elasticsearch 進程能夠鎖定內存。經過使用"ulimit -l unlimited"
199 
200 ############################## Network And HTTP ###############################
201 
202 # Elasticsearch, by default, binds itself to the 0.0.0.0 address, and listens
203 # on port [9200-9300] for HTTP traffic and on port [9300-9400] for node-to-node
204 # communication. (the range means that if the port is busy, it will automatically
205 # try the next port).
206 # 默認狀況下，ElasticSearch使用0.0.0.0地址，併爲http傳輸開啓9200-9300端口，
207 #    爲節點到節點的通訊開啓9300-9400端口，也能夠自行設置IP地址
208 #    （若是節點被佔用了，es將會自動嘗試使用下一個端口）
209 # Set the bind address specifically (IPv4 or IPv6):
210 #
211 #network.bind_host: 192.168.0.1
212 
213 # Set the address other nodes will use to communicate with this node. If not
214 # set, it is automatically derived. It must point to an actual IP address.
215 # publish_host設置其餘節點鏈接此節點的地址，若是不設置的話，則自動獲取，publish_host的地址必須爲真實地址
216 #network.publish_host: 192.168.0.1
217 
218 # Set both 'bind_host' and 'publish_host':
219 #bind_host和publish_host能夠一塊兒設置
220 #network.host: 192.168.0.1
221 
222 # Set a custom port for the node to node communication (9300 by default):
223 #能夠定製該節點與其餘節點交互的端口
224 #transport.tcp.port: 9300
225 
226 # Enable compression for all communication between nodes (disabled by default):
227 #節點間交互時，能夠設置是否壓縮，默認爲不壓縮
228 #transport.tcp.compress: true
229 
230 # Set a custom port to listen for HTTP traffic:
231 #能夠爲Http傳輸監聽定製端口
232 #http.port: 9200
233 
234 # Set a custom allowed content length:
235 #設置內容的最大長度
236 #http.max_content_length: 100mb
237 
238 # Disable HTTP completely:
239 #禁止HTTP
240 #http.enabled: false
241 
242 
243 ################################### Gateway ###################################
244 
245 # The gateway allows for persisting the cluster state between full cluster
246 # restarts. Every change to the state (such as adding an index) will be stored
247 # in the gateway, and when the cluster starts up for the first time,
248 # it will read its state from the gateway.
249 # 網關容許在全部集羣重啓後持有集羣狀態，集羣狀態的變動都會被保存下來，
250 #    當第一次啓用集羣時，能夠從網關中讀取到狀態，
251 
252 # There are several types of gateway implementations. For more information, see
253 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-gateway.html>.
254 
255 # The default gateway type is the "local" gateway (recommended):
256 #默認文件類型是本地local：
257 #gateway.type: local
258 
259 # Settings below control how and when to start the initial recovery process on
260 # a full cluster restart (to reuse as much local data as possible when using shared
261 # gateway).
262 
263 # Allow recovery process after N nodes in a cluster are up:
264 #容許在N個節點啓動後恢復過程
265 #gateway.recover_after_nodes: 1
266 
267 # Set the timeout to initiate the recovery process, once the N nodes
268 # from previous setting are up (accepts time value):
269 #設置初始化恢復過程的超時時間
270 #gateway.recover_after_time: 5m
271 
272 # Set how many nodes are expected in this cluster. Once these N nodes
273 # are up (and recover_after_nodes is met), begin recovery process immediately
274 # (without waiting for recover_after_time to expire):
275 #設置該集羣中可存在的節點上限
276 #gateway.expected_nodes: 2
277 
278 
279 ############################# Recovery Throttling #############################
280 
281 # These settings allow to control the process of shards allocation between
282 # nodes during initial recovery, replica allocation, rebalancing,
283 # or when adding and removing nodes.
284 
285 # Set the number of concurrent recoveries happening on a node:
286 #設置一個節點的併發數量，有兩種狀況，
287 #一種是在初始復甦過程當中：
288 # 1. During the initial recovery
289 #
290 #cluster.routing.allocation.node_initial_primaries_recoveries: 4
291 #
292 # 2. During adding/removing nodes, rebalancing, etc
293 #另外一種是在添加、刪除節點及調整時：
294 #cluster.routing.allocation.node_concurrent_recoveries: 2
295 
296 # Set to throttle throughput when recovering (eg. 100mb, by default 20mb):
297 #設置復甦時的吞吐量，默認狀況下是無限的
298 #indices.recovery.max_bytes_per_sec: 20mb
299 
300 # Set to limit the number of open concurrent streams when
301 # recovering a shard from a peer:
302 #設置從對等節點恢復片斷時打開的流的數量上限
303 #indices.recovery.concurrent_streams: 5
304 
305 
306 ################################## Discovery ##################################
307 
308 # Discovery infrastructure ensures nodes can be found within a cluster
309 # and master node is elected. Multicast discovery is the default.
310 
311 # Set to ensure a node sees N other master eligible nodes to be considered
312 # operational within the cluster. This should be set to a quorum/majority of 
313 # the master-eligible nodes in the cluster.
314 #設置一個集羣中主節點的數量，當多於三個節點時，該值可在2-4之間
315 #discovery.zen.minimum_master_nodes: 1
316 
317 # Set the time to wait for ping responses from other nodes when discovering.
318 # Set this option to a higher value on a slow or congested network
319 # to minimize discovery failures:
320 #設置ping其餘節點時的超時時間，網絡比較慢時可將該值設大
321 #discovery.zen.ping.timeout: 3s
322 
323 # For more information, see
324 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-discovery-zen.html>
325 
326 # Unicast discovery allows to explicitly control which nodes will be used
327 # to discover the cluster. It can be used when multicast is not present,
328 # or to restrict the cluster communication-wise.
329 #
330 # 1. Disable multicast discovery (enabled by default):
331 # 禁止當前節點發現多個集羣節點，
332 # 默認啓用發現節點機制，設爲false的話表示禁用自動發現機制
333 #discovery.zen.ping.multicast.enabled: false
334 #
335 # 2. Configure an initial list of master nodes in the cluster
336 #    to perform discovery when new nodes (master or data) are started:
337 #設置新節點被啓動時可以發現的主節點列表
338 #discovery.zen.ping.unicast.hosts: ["host1", "host2:port"]
339 
340 # EC2 discovery allows to use AWS EC2 API in order to perform discovery.
341 #
342 # You have to install the cloud-aws plugin for enabling the EC2 discovery.
343 #
344 # For more information, see
345 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-discovery-ec2.html>
346 #
347 # See <http://elasticsearch.org/tutorials/elasticsearch-on-ec2/>
348 # for a step-by-step tutorial.
349 
350 # GCE discovery allows to use Google Compute Engine API in order to perform discovery.
351 #
352 # You have to install the cloud-gce plugin for enabling the GCE discovery.
353 #
354 # For more information, see <https://github.com/elasticsearch/elasticsearch-cloud-gce>.
355 
356 # Azure discovery allows to use Azure API in order to perform discovery.
357 #
358 # You have to install the cloud-azure plugin for enabling the Azure discovery.
359 #
360 # For more information, see <https://github.com/elasticsearch/elasticsearch-cloud-azure>.
361 
362 ################################## Slow Log ##################################
363 
364 # Shard level query and fetch threshold logging.
365 
366 #index.search.slowlog.threshold.query.warn: 10s
367 #index.search.slowlog.threshold.query.info: 5s
368 #index.search.slowlog.threshold.query.debug: 2s
369 #index.search.slowlog.threshold.query.trace: 500ms
370 
371 #index.search.slowlog.threshold.fetch.warn: 1s
372 #index.search.slowlog.threshold.fetch.info: 800ms
373 #index.search.slowlog.threshold.fetch.debug: 500ms
374 #index.search.slowlog.threshold.fetch.trace: 200ms
375 
376 #index.indexing.slowlog.threshold.index.warn: 10s
377 #index.indexing.slowlog.threshold.index.info: 5s
378 #index.indexing.slowlog.threshold.index.debug: 2s
379 #index.indexing.slowlog.threshold.index.trace: 500ms
380 
381 ################################## GC Logging ################################
382 
383 #monitor.jvm.gc.young.warn: 1000ms
384 #monitor.jvm.gc.young.info: 700ms
385 #monitor.jvm.gc.young.debug: 400ms
386 
387 #monitor.jvm.gc.old.warn: 10s
388 #monitor.jvm.gc.old.info: 5s
389 #monitor.jvm.gc.old.debug: 2s
390 
391 ################################## Security ################################
392 
393 # Uncomment if you want to enable JSONP as a valid return transport on the
394 # http server. With this enabled, it may pose a security risk, so disabling
395 # it unless you need it is recommended (it is disabled by default).
396 #若是你想要啓用JSONP做爲HTTP服務器的有效傳輸的話取消註釋。
397 #啓用此功能，它可能會帶來風險。所以，禁用它，除非你必須須要它（默認禁用）
398 #http.jsonp.enable: true