1 ##################### Elasticsearch Configuration Example #####################
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>.
7 # The installation procedure is covered at
8 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/setup.html>.
10 # Elasticsearch comes with reasonable defaults for most settings,
11 # so you can try it out without bothering with configuration.
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].
18 # Any element in the configuration can be replaced with environment variables
19 # by placing them in ${...} notation. For example:
21 #node.rack: ${RACK_ENV_VAR}
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>
27 ################################### Cluster ###################################
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.
32 #cluster.name: elasticsearch
33 cluster.name: ${{FQDN}}-policy-sa
36 #################################### Node #####################################
38 # Node names are generated dynamically on startup, so you're relieved
39 # from configuring them manually. You can tie this node to a specific name:
41 #node.name: "Franz Kafka"
42 node.name: "${{FQDN}}"
44 # Every node can be configured to allow or deny being eligible as the master,
45 # and to allow or deny to store the data.
47 # Allow this node to be eligible as a master node (enabled by default):
51 # Allow this node to store data (enabled by default):
55 # You can exploit these settings to design advanced cluster topologies.
57 # 1. You want this node to never become a master node, only to hold data.
58 # This will be the "workhorse" of your cluster.
63 # 2. You want this node to only serve as a master: to not store any data and
64 # to have free resources. This will be the "coordinator" of your cluster.
69 # 3. You want this node to be neither master nor data node, but
70 # to act as a "search load balancer" (fetching data from nodes,
71 # aggregating results, etc.)
76 # Use the Cluster Health API [http://localhost:9200/_cluster/health], the
77 # Node Info API [http://localhost:9200/_nodes] or GUI tools
78 # such as <http://www.elasticsearch.org/overview/marvel/>,
79 # <http://github.com/karmi/elasticsearch-paramedic>,
80 # <http://github.com/lukas-vlcek/bigdesk> and
81 # <http://mobz.github.com/elasticsearch-head> to inspect the cluster state.
83 # A node can have generic attributes associated with it, which can later be used
84 # for customized shard allocation filtering, or allocation awareness. An attribute
85 # is a simple key value pair, similar to node.key: value, here is an example:
89 # By default, multiple nodes are allowed to start from the same installation location
90 # to disable it, set the following:
91 node.max_local_storage_nodes: 1
94 #################################### Index ####################################
96 # You can set a number of options (such as shard/replica options, mapping
97 # or analyzer definitions, translog settings, ...) for indices globally,
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.
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.
107 # Set the number of shards (splits) of an index (5 by default):
109 #index.number_of_shards: 5
111 # Set the number of replicas (additional copies) of an index (1 by default):
113 #index.number_of_replicas: 1
115 # Note, that for development on a local machine, with small indices, it usually
116 # makes sense to "disable" the distributed features:
118 index.number_of_shards: 1
119 index.number_of_replicas: 0
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:
125 # 1. Having more *shards* enhances the _indexing_ performance and allows to
126 # _distribute_ a big index across machines.
127 # 2. Having more *replicas* enhances the _search_ performance and improves the
128 # cluster _availability_.
130 # The "number_of_shards" is a one-time setting for an index.
132 # The "number_of_replicas" can be increased or decreased anytime,
133 # by using the Index Update Settings API.
135 # Elasticsearch takes care about load balancing, relocating, gathering the
136 # results from nodes, etc. Experiment with different settings to fine-tune
139 # Use the Index Status API (<http://localhost:9200/A/_status>) to inspect
143 #################################### Paths ####################################
145 # Path to directory containing configuration (this file and logging.yml):
147 #path.conf: /path/to/conf
149 # Path to directory where to store index data allocated for this node.
151 #path.data: /path/to/data
153 # Can optionally include more than one location, causing data to be striped across
154 # the locations (a la RAID 0) on a file level, favouring locations with most free
155 # space on creation. For example:
157 #path.data: /path/to/data1,/path/to/data2
159 # Path to temporary files:
161 #path.work: /path/to/work
165 #path.logs: /path/to/logs
166 path.logs: ${{POLICY_HOME}}/logs
168 # Path to where plugins are installed:
170 #path.plugins: /path/to/plugins
173 #################################### Plugin ###################################
175 # If a plugin listed here is not installed for current node, the node will not start.
177 #plugin.mandatory: mapper-attachments,lang-groovy
180 ################################### Memory ####################################
182 # Elasticsearch performs poorly when JVM starts swapping: you should ensure that
185 # Set this property to true to lock the memory:
187 #bootstrap.mlockall: true
189 # Make sure that the ES_MIN_MEM and ES_MAX_MEM environment variables are set
190 # to the same value, and that the machine has enough memory to allocate
191 # for Elasticsearch, leaving enough memory for the operating system itself.
193 # You should also make sure that the Elasticsearch process is allowed to lock
194 # the memory, eg. by using `ulimit -l unlimited`.
197 ############################## Network And HTTP ###############################
199 # Elasticsearch, by default, binds itself to the 0.0.0.0 address, and listens
200 # on port [9200-9300] for HTTP traffic and on port [9300-9400] for node-to-node
201 # communication. (the range means that if the port is busy, it will automatically
202 # try the next port).
204 # Set the bind address specifically (IPv4 or IPv6):
206 #network.bind_host: 10.00.10.00
208 # Set the address other nodes will use to communicate with this node. If not
209 # set, it is automatically derived. It must point to an actual IP address.
211 #network.publish_host: 10.00.10.00
213 # Set both 'bind_host' and 'publish_host':
215 #network.host: 10.00.10.00
217 # Set a custom port for the node to node communication (9300 by default):
219 #transport.tcp.port: 9300
221 # Enable compression for all communication between nodes (disabled by default):
223 #transport.tcp.compress: true
225 # Set a custom port to listen for HTTP traffic:
229 # Set a custom allowed content length:
231 #http.max_content_length: 100mb
233 # Disable HTTP completely:
238 ################################### Gateway ###################################
240 # The gateway allows for persisting the cluster state between full cluster
241 # restarts. Every change to the state (such as adding an index) will be stored
242 # in the gateway, and when the cluster starts up for the first time,
243 # it will read its state from the gateway.
245 # There are several types of gateway implementations. For more information, see
246 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-gateway.html>.
248 # The default gateway type is the "local" gateway (recommended):
252 # Settings below control how and when to start the initial recovery process on
253 # a full cluster restart (to reuse as much local data as possible when using shared
256 # Allow recovery process after N nodes in a cluster are up:
258 #gateway.recover_after_nodes: 1
260 # Set the timeout to initiate the recovery process, once the N nodes
261 # from previous setting are up (accepts time value):
263 #gateway.recover_after_time: 5m
265 # Set how many nodes are expected in this cluster. Once these N nodes
266 # are up (and recover_after_nodes is met), begin recovery process immediately
267 # (without waiting for recover_after_time to expire):
269 #gateway.expected_nodes: 2
272 ############################# Recovery Throttling #############################
274 # These settings allow to control the process of shards allocation between
275 # nodes during initial recovery, replica allocation, rebalancing,
276 # or when adding and removing nodes.
278 # Set the number of concurrent recoveries happening on a node:
280 # 1. During the initial recovery
282 #cluster.routing.allocation.node_initial_primaries_recoveries: 4
284 # 2. During adding/removing nodes, rebalancing, etc
286 #cluster.routing.allocation.node_concurrent_recoveries: 2
288 # Set to throttle throughput when recovering (eg. 100mb, by default 20mb):
290 #indices.recovery.max_bytes_per_sec: 20mb
292 # Set to limit the number of open concurrent streams when
293 # recovering a shard from a peer:
295 #indices.recovery.concurrent_streams: 5
298 ################################## Discovery ##################################
300 # Discovery infrastructure ensures nodes can be found within a cluster
301 # and master node is elected. Multicast discovery is the default.
303 # Set to ensure a node sees N other master eligible nodes to be considered
304 # operational within the cluster. This should be set to a quorum/majority of
305 # the master-eligible nodes in the cluster.
307 #discovery.zen.minimum_master_nodes: 1
309 # Set the time to wait for ping responses from other nodes when discovering.
310 # Set this option to a higher value on a slow or congested network
311 # to minimize discovery failures:
313 #discovery.zen.ping.timeout: 3s
315 # For more information, see
316 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-discovery-zen.html>
318 # Unicast discovery allows to explicitly control which nodes will be used
319 # to discover the cluster. It can be used when multicast is not present,
320 # or to restrict the cluster communication-wise.
322 # 1. Disable multicast discovery (enabled by default):
324 #discovery.zen.ping.multicast.enabled: false
326 # 2. Configure an initial list of master nodes in the cluster
327 # to perform discovery when new nodes (master or data) are started:
329 #discovery.zen.ping.unicast.hosts: ["host1", "host2:port"]
331 # EC2 discovery allows to use AWS EC2 API in order to perform discovery.
333 # You have to install the cloud-aws plugin for enabling the EC2 discovery.
335 # For more information, see
336 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-discovery-ec2.html>
338 # See <http://elasticsearch.org/tutorials/elasticsearch-on-ec2/>
339 # for a step-by-step tutorial.
341 # GCE discovery allows to use Google Compute Engine API in order to perform discovery.
343 # You have to install the cloud-gce plugin for enabling the GCE discovery.
345 # For more information, see <https://github.com/elasticsearch/elasticsearch-cloud-gce>.
347 # Azure discovery allows to use Azure API in order to perform discovery.
349 # You have to install the cloud-azure plugin for enabling the Azure discovery.
351 # For more information, see <https://github.com/elasticsearch/elasticsearch-cloud-azure>.
353 ################################## Slow Log ##################################
355 # Shard level query and fetch threshold logging.
357 #index.search.slowlog.threshold.query.warn: 10s
358 #index.search.slowlog.threshold.query.info: 5s
359 #index.search.slowlog.threshold.query.debug: 2s
360 #index.search.slowlog.threshold.query.trace: 500ms
362 #index.search.slowlog.threshold.fetch.warn: 1s
363 #index.search.slowlog.threshold.fetch.info: 800ms
364 #index.search.slowlog.threshold.fetch.debug: 500ms
365 #index.search.slowlog.threshold.fetch.trace: 200ms
367 #index.indexing.slowlog.threshold.index.warn: 10s
368 #index.indexing.slowlog.threshold.index.info: 5s
369 #index.indexing.slowlog.threshold.index.debug: 2s
370 #index.indexing.slowlog.threshold.index.trace: 500ms
372 ################################## GC Logging ################################
374 #monitor.jvm.gc.young.warn: 1000ms
375 #monitor.jvm.gc.young.info: 700ms
376 #monitor.jvm.gc.young.debug: 400ms
378 #monitor.jvm.gc.old.warn: 10s
379 #monitor.jvm.gc.old.info: 5s
380 #monitor.jvm.gc.old.debug: 2s
382 ################################## Security ################################
384 # Uncomment if you want to enable JSONP as a valid return transport on the
385 # http server. With this enabled, it may pose a security risk, so disabling
386 # it unless you need it is recommended (it is disabled by default).
388 #http.jsonp.enable: true
390 discovery.zen.ping.multicast.enabled: false
392 action.auto_create_index: false