elasticsearch配置文件详解

# ======================== Elasticsearch Configuration =========================
#
# NOTE: Elasticsearch comes with reasonable defaults for most settings.
# Before you set out to tweak and tune the configuration, make sure you
# understand what are you trying to accomplish and the consequences.
#
# The primary way of configuring a node is via this file. This template lists
# the most important settings you may want to configure for a production cluster.
#
# Please consult the documentation for further information on configuration options:
# https://www.elastic.co/guide/en/elasticsearch/reference/index.html
#
# ---------------------------------- Cluster -----------------------------------
#
# cluster.name可以确定你的集群名称，可以自动生成
#
cluster.name: app
#
# ------------------------------------ Node ------------------------------------
#
# 节点名称同理,可自动生成也可手动配置. 
node.name: app-es-01

# 允许一个节点是否可以成为一个master节点,es是默认集群中的第一台机器为master,如果这台机器停止就会 
# 重新选举master. 
node.master: true 

# 允许该节点存储数据(默认开启) 
node.data: true 
#
# 配置文件中给出了三种配置高性能集群拓扑结构的模式,如下： 
# 1. 如果你想让节点从不选举为主节点,只用来存储数据,可作为负载器 
# node.master: false 
# node.data: true 
# node.ingest: true #默认true

# 2. 如果想让节点成为主节点,且不存储任何数据,并保有空闲资源,可作为协调器 
# node.master: true 
# node.data: false
# node.ingest: true

# 3. 如果想让节点既不称为主节点,又不成为数据节点,那么可将他作为搜索器,从节点中获取数据,生成搜索结 
# 果等 
# node.master: false 
# node.data: false 
# node.ingest: true

# 4. 仅作为协调器 
# node.master: false 
# node.data: false
# node.ingest: false

# ----------------------------------- Paths ------------------------------------
#
# 配置文件存储位置 （不配置就默认config）
# path.conf: /path/to/conf 

# 数据存储位置(单个目录设置) 
# path.data: /data/es-data
# 多个数据存储位置,有利于性能提升 
# path.data: /data/es-data,/data/es-data2

# 临时文件的路径 （可以不配）
# path.work: /data/es-data/tmp 

# 日志文件的路径 
# path.logs: /data/es-logs

# 插件安装路径 （可以默认）
# path.plugins: /path/to/plugins 
#
# ----------------------------------- Memory -----------------------------------
#
# Lock the memory on startup:
#
# bootstrap.memory_lock: true
#
# Make sure that the heap size is set to about half the memory available
# on the system and that the owner of the process is allowed to use this
# limit.
#
# Elasticsearch performs poorly when the system is swapping the memory.

# bootstrap.mlockall: true 
# 当JVM开始写入交换空间时（swapping）ElasticSearch性能会低下,你应该保证它不会写入交换空间 
# 设置这个属性为true来锁定内存,同时也要允许elasticsearch的进程可以锁住内存
# 确保 ES_MIN_MEM 和 ES_MAX_MEM 环境变量设置为相同的值,以及机器有足够的内存分配给Elasticsearch

# 注意:
# 内存也不是越大越好,一般64位机器,最大分配内存别才超过32G;
# 一般最多分配内存的一半（一半最好），如果分配过多，会造成内存Lucene缓存（及其消耗内存）效率低下;
# 同时，生产环境应该杜绝32位操作系统;
# 是每个es实例不要超过32G，而不是所有的node的内存和；
#
# ---------------------------------- Network -----------------------------------
#
# 设置绑定的ip地址,可以是ipv4或ipv6的,默认为0.0.0.0 
# network.bind_host: 192.168.0.1 #只有本机可以访问http接口

# 设置其它节点和该节点交互的ip地址,如果不设置它会自动设置,值必须是个真实的ip地址 （可以不配）
# network.publish_host: 192.168.0.1 

# 同时设置bind_host和publish_host上面两个参数 （当前使用）
# network.host: 10.1.1.1 #绑定监听IP

# 设置节点间交互的tcp端口,默认是9300 
# transport.tcp.port: 9300 

# 设置是否压缩tcp传输时的数据，默认为false,不压缩
# transport.tcp.compress: true 

# 设置对外服务的http端口,默认为9200 
# http.port: 9200 

# 设置请求内容的最大容量,默认100mb 
# http.max_content_length: 100mb 

# 使用http协议对外提供服务,默认为true,开启 
# http.cors.enabled: true 

# --------------------------------- Discovery ----------------------------------
#
# 设置这个参数来保证集群中的节点可以知道其它N个有master资格的节点.默认为1,对于大的集群来说,可以
# 设置大一点的值(2-4) 
# discovery.zen.minimum_master_nodes: 2 
# 探查的超时时间,默认3秒,提高一点以应对网络不好的时候,防止脑裂 
discovery.zen.ping.timeout: 3s 

# 设置是否打开多播发现节点.
discovery.zen.ping.multicast.enabled: true 

# 这是一个集群中的主节点的初始列表,当节点(主节点或者数据节点)启动时使用这个列表进行探测 
discovery.zen.ping.unicast.hosts: ["host1", "host2:port"] 

# ---------------------------------- Gateway -----------------------------------
#
# gateway的类型,默认为local即为本地文件系统,可以设置为本地文件系统 
# gateway.type: local 

# 下面的配置控制怎样以及何时启动一整个集群重启的初始化恢复过程 
# (当使用shard gateway时,是为了尽可能的重用local data(本地数据)) 

# 一个集群中的N个节点启动后,才允许进行恢复处理 
# gateway.recover_after_nodes: 1 

# 设置初始化恢复过程的超时时间,超时时间从上一个配置中配置的N个节点启动后算起 
# gateway.recover_after_time: 5m 

# 设置这个集群中期望有多少个节点.一旦这N个节点启动(并且recover_after_nodes也符合), 
# 立即开始恢复过程(不等待recover_after_time超时) 
# gateway.expected_nodes: 2

############## Memory(重点需要调优的部分) ################ 
# Cache部分: 
# es有很多种方式来缓存其内部与索引有关的数据.其中包括filter cache 

# filter cache部分: 
# filter cache是用来缓存filters的结果的.默认的cache type是node type.node type的机制是所有的索
# 引内部的分片共享filter cache.node type采用的方式是LRU方式.即:当缓存达到了某个临界值之后，es会
# 将最近没有使用的数据清除出filter cache.使让新的数据进入es. 

# 这个临界值的设置方法如下：indices.cache.filter.size 值类型：eg.:512mb 20%。默认的值是10%。 

# out of memory错误避免过于频繁的查询时集群假死 
# 1.设置es的缓存类型为Soft Reference,它的主要特点是据有较强的引用功能.只有当内存不够的时候,才进
# 行回收这类内存,因此在内存足够的时候,它们通常不被回收.另外,这些引用对象还能保证在Java抛出
# OutOfMemory异常之前,被设置为null.它可以用于实现一些常用图片的缓存,实现Cache的功能,保证最大限
# 度的使用内存而不引起OutOfMemory.在es的配置文件加上index.cache.field.type: soft即可. 

# 2.设置es最大缓存数据条数和缓存失效时间,通过设置index.cache.field.max_size: 50000来把缓存
field的最大值设置为50000,设置index.cache.field.expire: 10m把过期时间设置成10分钟. 

# index.cache.field.max_size: 50000 
# index.cache.field.expire: 10m 
# index.cache.field.type: soft 

# field data部分&&circuit breaker部分： 
# 用于fielddata缓存的内存数量,主要用于当使用排序,faceting操作时,elasticsearch会将一些热点数据
# 加载到内存中来提供给客户端访问,但是这种缓存是比较珍贵的,所以对它进行合理的设置. 
# 可以使用值：eg:50mb 或者 30％(节点 node heap内存量),默认是：unbounded
# indices.fielddata.cache.size： unbounded 

# field的超时时间.默认是-1,可以设置的值类型: 5m 
# indices.fielddata.cache.expire: -1 

# circuit breaker部分: 
# 断路器是elasticsearch为了防止内存溢出的一种操作,每一种circuit breaker都可以指定一个内存界限触
# 发此操作,这种circuit breaker的设定有一个最高级别的设定:indices.breaker.total.limit 默认值是
# JVM heap的70%.当内存达到这个数量的时候会触发内存回收

# 另外还有两组子设置： 
# indices.breaker.fielddata.limit:当系统发现fielddata的数量达到一定数量时会触发内存回收.默认
# 值是JVM heap的70% 
# indices.breaker.fielddata.overhead:在系统要加载fielddata时会进行预先估计,当系统发现要加载进
# 内存的值超过limit * overhead时会进行进行内存回收.默认是1.03 
# indices.breaker.request.limit:这种断路器是elasticsearch为了防止OOM(内存溢出),在每次请求数据
# 时设定了一个固定的内存数量.默认值是40% 
# indices.breaker.request.overhead:同上,也是elasticsearch在发送请求时设定的一个预估系数,用来
# 防止内存溢出.默认值是1 

# Translog部分: 
# 每一个分片(shard)都有一个transaction log或者是与它有关的预写日志,(write log),在es进行索引
# (index)或者删除(delete)操作时会将没有提交的数据记录在translog之中,当进行flush 操作的时候会将
# tranlog中的数据发送给Lucene进行相关的操作.一次flush操作的发生基于如下的几个配置 
# index.translog.flush_threshold_ops:当发生多少次操作时进行一次flush.默认是 unlimited 

# index.translog.flush_threshold_size:当translog的大小达到此值时会进行一次flush操作.默认是
# 512mb 

# index.translog.flush_threshold_period:在指定的时间间隔内如果没有进行flush操作,会进行一次强
# 制flush操作.默认是30m 
# index.translog.interval:多少时间间隔内会检查一次translog,来进行一次flush操作.es会随机的在这
# 个值到这个值的2倍大小之间进行一次操作,默认是5s 
# index.gateway.local.sync:多少时间进行一次的写磁盘操作,默认是5s

#新增插件配置(*可选)

#xpack.security.enabled: true

#xpack: 插件配置