OLD | NEW |
(Empty) | |
| 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-confi
guration.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 # |
| 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 # |
| 40 #node.name: "Franz Kafka" |
| 41 |
| 42 # Every node can be configured to allow or deny being eligible as the master, |
| 43 # and to allow or deny to store the data. |
| 44 # |
| 45 # Allow this node to be eligible as a master node (enabled by default): |
| 46 # |
| 47 #node.master: true |
| 48 # |
| 49 # Allow this node to store data (enabled by default): |
| 50 # |
| 51 #node.data: true |
| 52 |
| 53 # You can exploit these settings to design advanced cluster topologies. |
| 54 # |
| 55 # 1. You want this node to never become a master node, only to hold data. |
| 56 # This will be the "workhorse" of your cluster. |
| 57 # |
| 58 #node.master: false |
| 59 #node.data: true |
| 60 # |
| 61 # 2. You want this node to only serve as a master: to not store any data and |
| 62 # to have free resources. This will be the "coordinator" of your cluster. |
| 63 # |
| 64 #node.master: true |
| 65 #node.data: false |
| 66 # |
| 67 # 3. You want this node to be neither master nor data node, but |
| 68 # to act as a "search load balancer" (fetching data from nodes, |
| 69 # aggregating results, etc.) |
| 70 # |
| 71 #node.master: false |
| 72 #node.data: false |
| 73 |
| 74 # Use the Cluster Health API [http://localhost:9200/_cluster/health], the |
| 75 # Node Info API [http://localhost:9200/_nodes] or GUI tools |
| 76 # such as <http://www.elasticsearch.org/overview/marvel/>, |
| 77 # <http://github.com/karmi/elasticsearch-paramedic>, |
| 78 # <http://github.com/lukas-vlcek/bigdesk> and |
| 79 # <http://mobz.github.com/elasticsearch-head> to inspect the cluster state. |
| 80 |
| 81 # A node can have generic attributes associated with it, which can later be used |
| 82 # for customized shard allocation filtering, or allocation awareness. An attribu
te |
| 83 # is a simple key value pair, similar to node.key: value, here is an example: |
| 84 # |
| 85 #node.rack: rack314 |
| 86 |
| 87 # By default, multiple nodes are allowed to start from the same installation loc
ation |
| 88 # to disable it, set the following: |
| 89 #node.max_local_storage_nodes: 1 |
| 90 |
| 91 |
| 92 #################################### Index #################################### |
| 93 |
| 94 # You can set a number of options (such as shard/replica options, mapping |
| 95 # or analyzer definitions, translog settings, ...) for indices globally, |
| 96 # in this file. |
| 97 # |
| 98 # Note, that it makes more sense to configure index settings specifically for |
| 99 # a certain index, either when creating it or by using the index templates API. |
| 100 # |
| 101 # See <http://elasticsearch.org/guide/en/elasticsearch/reference/current/index-m
odules.html> and |
| 102 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/indices-cre
ate-index.html> |
| 103 # for more information. |
| 104 |
| 105 # Set the number of shards (splits) of an index (5 by default): |
| 106 # |
| 107 #index.number_of_shards: 5 |
| 108 |
| 109 # Set the number of replicas (additional copies) of an index (1 by default): |
| 110 # |
| 111 #index.number_of_replicas: 1 |
| 112 |
| 113 # Note, that for development on a local machine, with small indices, it usually |
| 114 # makes sense to "disable" the distributed features: |
| 115 # |
| 116 #index.number_of_shards: 1 |
| 117 #index.number_of_replicas: 0 |
| 118 |
| 119 # These settings directly affect the performance of index and search operations |
| 120 # in your cluster. Assuming you have enough machines to hold shards and |
| 121 # replicas, the rule of thumb is: |
| 122 # |
| 123 # 1. Having more *shards* enhances the _indexing_ performance and allows to |
| 124 # _distribute_ a big index across machines. |
| 125 # 2. Having more *replicas* enhances the _search_ performance and improves the |
| 126 # cluster _availability_. |
| 127 # |
| 128 # The "number_of_shards" is a one-time setting for an index. |
| 129 # |
| 130 # The "number_of_replicas" can be increased or decreased anytime, |
| 131 # by using the Index Update Settings API. |
| 132 # |
| 133 # Elasticsearch takes care about load balancing, relocating, gathering the |
| 134 # results from nodes, etc. Experiment with different settings to fine-tune |
| 135 # your setup. |
| 136 |
| 137 # Use the Index Status API (<http://localhost:9200/A/_status>) to inspect |
| 138 # the index status. |
| 139 |
| 140 |
| 141 #################################### Paths #################################### |
| 142 |
| 143 # Path to directory containing configuration (this file and logging.yml): |
| 144 # |
| 145 #path.conf: /path/to/conf |
| 146 |
| 147 # Path to directory where to store index data allocated for this node. |
| 148 # |
| 149 #path.data: /path/to/data |
| 150 # |
| 151 # Can optionally include more than one location, causing data to be striped acro
ss |
| 152 # the locations (a la RAID 0) on a file level, favouring locations with most fre
e |
| 153 # space on creation. For example: |
| 154 # |
| 155 #path.data: /path/to/data1,/path/to/data2 |
| 156 |
| 157 # Path to temporary files: |
| 158 # |
| 159 #path.work: /path/to/work |
| 160 |
| 161 # Path to log files: |
| 162 # |
| 163 #path.logs: /path/to/logs |
| 164 |
| 165 # Path to where plugins are installed: |
| 166 # |
| 167 #path.plugins: /path/to/plugins |
| 168 |
| 169 |
| 170 #################################### Plugin ################################### |
| 171 |
| 172 # If a plugin listed here is not installed for current node, the node will not s
tart. |
| 173 # |
| 174 #plugin.mandatory: mapper-attachments,lang-groovy |
| 175 |
| 176 |
| 177 ################################### Memory #################################### |
| 178 |
| 179 # Elasticsearch performs poorly when JVM starts swapping: you should ensure that |
| 180 # it _never_ swaps. |
| 181 # |
| 182 # Set this property to true to lock the memory: |
| 183 # |
| 184 #bootstrap.mlockall: true |
| 185 |
| 186 # Make sure that the ES_MIN_MEM and ES_MAX_MEM environment variables are set |
| 187 # to the same value, and that the machine has enough memory to allocate |
| 188 # for Elasticsearch, leaving enough memory for the operating system itself. |
| 189 # |
| 190 # You should also make sure that the Elasticsearch process is allowed to lock |
| 191 # the memory, eg. by using `ulimit -l unlimited`. |
| 192 |
| 193 |
| 194 ############################## Network And HTTP ############################### |
| 195 |
| 196 # Elasticsearch, by default, binds itself to the 0.0.0.0 address, and listens |
| 197 # on port [9200-9300] for HTTP traffic and on port [9300-9400] for node-to-node |
| 198 # communication. (the range means that if the port is busy, it will automaticall
y |
| 199 # try the next port). |
| 200 |
| 201 # Set the bind address specifically (IPv4 or IPv6): |
| 202 # |
| 203 #network.bind_host: 192.168.0.1 |
| 204 |
| 205 # Set the address other nodes will use to communicate with this node. If not |
| 206 # set, it is automatically derived. It must point to an actual IP address. |
| 207 # |
| 208 #network.publish_host: 192.168.0.1 |
| 209 |
| 210 # Set both 'bind_host' and 'publish_host': |
| 211 # |
| 212 #network.host: 192.168.0.1 |
| 213 |
| 214 # Set a custom port for the node to node communication (9300 by default): |
| 215 # |
| 216 #transport.tcp.port: 9300 |
| 217 |
| 218 # Enable compression for all communication between nodes (disabled by default): |
| 219 # |
| 220 #transport.tcp.compress: true |
| 221 |
| 222 # Set a custom port to listen for HTTP traffic: |
| 223 # |
| 224 #http.port: 9200 |
| 225 |
| 226 # Set a custom allowed content length: |
| 227 # |
| 228 #http.max_content_length: 100mb |
| 229 |
| 230 # Disable HTTP completely: |
| 231 # |
| 232 #http.enabled: false |
| 233 |
| 234 |
| 235 ################################### Gateway ################################### |
| 236 |
| 237 # The gateway allows for persisting the cluster state between full cluster |
| 238 # restarts. Every change to the state (such as adding an index) will be stored |
| 239 # in the gateway, and when the cluster starts up for the first time, |
| 240 # it will read its state from the gateway. |
| 241 |
| 242 # There are several types of gateway implementations. For more information, see |
| 243 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-gat
eway.html>. |
| 244 |
| 245 # The default gateway type is the "local" gateway (recommended): |
| 246 # |
| 247 #gateway.type: local |
| 248 |
| 249 # Settings below control how and when to start the initial recovery process on |
| 250 # a full cluster restart (to reuse as much local data as possible when using sha
red |
| 251 # gateway). |
| 252 |
| 253 # Allow recovery process after N nodes in a cluster are up: |
| 254 # |
| 255 #gateway.recover_after_nodes: 1 |
| 256 |
| 257 # Set the timeout to initiate the recovery process, once the N nodes |
| 258 # from previous setting are up (accepts time value): |
| 259 # |
| 260 #gateway.recover_after_time: 5m |
| 261 |
| 262 # Set how many nodes are expected in this cluster. Once these N nodes |
| 263 # are up (and recover_after_nodes is met), begin recovery process immediately |
| 264 # (without waiting for recover_after_time to expire): |
| 265 # |
| 266 #gateway.expected_nodes: 2 |
| 267 |
| 268 |
| 269 ############################# Recovery Throttling ############################# |
| 270 |
| 271 # These settings allow to control the process of shards allocation between |
| 272 # nodes during initial recovery, replica allocation, rebalancing, |
| 273 # or when adding and removing nodes. |
| 274 |
| 275 # Set the number of concurrent recoveries happening on a node: |
| 276 # |
| 277 # 1. During the initial recovery |
| 278 # |
| 279 #cluster.routing.allocation.node_initial_primaries_recoveries: 4 |
| 280 # |
| 281 # 2. During adding/removing nodes, rebalancing, etc |
| 282 # |
| 283 #cluster.routing.allocation.node_concurrent_recoveries: 2 |
| 284 |
| 285 # Set to throttle throughput when recovering (eg. 100mb, by default 20mb): |
| 286 # |
| 287 #indices.recovery.max_bytes_per_sec: 20mb |
| 288 |
| 289 # Set to limit the number of open concurrent streams when |
| 290 # recovering a shard from a peer: |
| 291 # |
| 292 #indices.recovery.concurrent_streams: 5 |
| 293 |
| 294 |
| 295 ################################## Discovery ################################## |
| 296 |
| 297 # Discovery infrastructure ensures nodes can be found within a cluster |
| 298 # and master node is elected. Multicast discovery is the default. |
| 299 |
| 300 # Set to ensure a node sees N other master eligible nodes to be considered |
| 301 # operational within the cluster. This should be set to a quorum/majority of |
| 302 # the master-eligible nodes in the cluster. |
| 303 # |
| 304 #discovery.zen.minimum_master_nodes: 1 |
| 305 |
| 306 # Set the time to wait for ping responses from other nodes when discovering. |
| 307 # Set this option to a higher value on a slow or congested network |
| 308 # to minimize discovery failures: |
| 309 # |
| 310 #discovery.zen.ping.timeout: 3s |
| 311 |
| 312 # For more information, see |
| 313 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-dis
covery-zen.html> |
| 314 |
| 315 # Unicast discovery allows to explicitly control which nodes will be used |
| 316 # to discover the cluster. It can be used when multicast is not present, |
| 317 # or to restrict the cluster communication-wise. |
| 318 # |
| 319 # 1. Disable multicast discovery (enabled by default): |
| 320 # |
| 321 #discovery.zen.ping.multicast.enabled: false |
| 322 # |
| 323 # 2. Configure an initial list of master nodes in the cluster |
| 324 # to perform discovery when new nodes (master or data) are started: |
| 325 # |
| 326 #discovery.zen.ping.unicast.hosts: ["host1", "host2:port"] |
| 327 |
| 328 # EC2 discovery allows to use AWS EC2 API in order to perform discovery. |
| 329 # |
| 330 # You have to install the cloud-aws plugin for enabling the EC2 discovery. |
| 331 # |
| 332 # For more information, see |
| 333 # <http://elasticsearch.org/guide/en/elasticsearch/reference/current/modules-dis
covery-ec2.html> |
| 334 # |
| 335 # See <http://elasticsearch.org/tutorials/elasticsearch-on-ec2/> |
| 336 # for a step-by-step tutorial. |
| 337 |
| 338 # GCE discovery allows to use Google Compute Engine API in order to perform disc
overy. |
| 339 # |
| 340 # You have to install the cloud-gce plugin for enabling the GCE discovery. |
| 341 # |
| 342 # For more information, see <https://github.com/elasticsearch/elasticsearch-clou
d-gce>. |
| 343 |
| 344 # Azure discovery allows to use Azure API in order to perform discovery. |
| 345 # |
| 346 # You have to install the cloud-azure plugin for enabling the Azure discovery. |
| 347 # |
| 348 # For more information, see <https://github.com/elasticsearch/elasticsearch-clou
d-azure>. |
| 349 |
| 350 ################################## Slow Log ################################## |
| 351 |
| 352 # Shard level query and fetch threshold logging. |
| 353 |
| 354 #index.search.slowlog.threshold.query.warn: 10s |
| 355 #index.search.slowlog.threshold.query.info: 5s |
| 356 #index.search.slowlog.threshold.query.debug: 2s |
| 357 #index.search.slowlog.threshold.query.trace: 500ms |
| 358 |
| 359 #index.search.slowlog.threshold.fetch.warn: 1s |
| 360 #index.search.slowlog.threshold.fetch.info: 800ms |
| 361 #index.search.slowlog.threshold.fetch.debug: 500ms |
| 362 #index.search.slowlog.threshold.fetch.trace: 200ms |
| 363 |
| 364 #index.indexing.slowlog.threshold.index.warn: 10s |
| 365 #index.indexing.slowlog.threshold.index.info: 5s |
| 366 #index.indexing.slowlog.threshold.index.debug: 2s |
| 367 #index.indexing.slowlog.threshold.index.trace: 500ms |
| 368 |
| 369 ################################## GC Logging ################################ |
| 370 |
| 371 #monitor.jvm.gc.young.warn: 1000ms |
| 372 #monitor.jvm.gc.young.info: 700ms |
| 373 #monitor.jvm.gc.young.debug: 400ms |
| 374 |
| 375 #monitor.jvm.gc.old.warn: 10s |
| 376 #monitor.jvm.gc.old.info: 5s |
| 377 #monitor.jvm.gc.old.debug: 2s |
| 378 |
| 379 ################################## Security ################################ |
| 380 |
| 381 # Uncomment if you want to enable JSONP as a valid return transport on the |
| 382 # http server. With this enabled, it may pose a security risk, so disabling |
| 383 # it unless you need it is recommended (it is disabled by default). |
| 384 |
| 385 #http.jsonp.enable: true |
| 386 |
| 387 # Since version 1.4, Elasticsearch ships with a security setting that, by |
| 388 # default, prevents applications like Kibana from connecting |
| 389 |
| 390 #http.cors.enabled: true |
| 391 #http.cors.allow-origin: "/.*/" |
| 392 |
| 393 ################################## Puppet ################################ |
| 394 |
| 395 # The $::elasticsearch::settings provided by Puppet. |
| 396 |
| 397 <%- require 'json' -%> |
| 398 <%- @settings.sort.each do |key, value| -%> |
| 399 <%= key %>: <%= value.to_json %> |
| 400 <%- end -%> |
| 401 |
OLD | NEW |