标签：ges 变量 one info vol src involve max set
ElasticSearch共有两个配置文件，都位于config目录下，分别是elasticsearch.yml和logging.yml，其中，elasticsearch.yml 是全局配置文件，用于在服务器级别对ElasticSearch进行配置。ElasticSearch的配置选项分为静态设置和动态设置两种，静态设置必须在结点级别（node-level）设置，或配置在elasticsearch.yml配置文件中，或配置在环境变量中，或配置在命令行中，在结点启动之后，静态设置不能修改。集群的名字和结点的名称：cluster.name 和 node.name，这两个配置项是静态配置项，不能在集群运行时修改，而动态配置项可以在集群运行时通过RESTful API进行修改。
一，配置集群的标识（cluster.name）
通过 cluster.name 属性配置集群的名字，用于唯一标识一个集群，集群名字相同的所有节点自动组成一个集群。如果不配置改属性，默认值是：elasticsearch。当启动一个结点时，该结点会自动寻找相同集群名字的主结点；如果找到主结点，该结点加入集群中；如果未找到主结点，该结点成为主结点。
配置集群的名字为myescluster
cluster.name:myescluster
二，结点的配置
ElasticSearch集群中，共有五种结点类型：主结点（Master），候选主结点（Master-eligible），数据结点（Data），吸收结点（Ingest）和部落结点（Tribe）。在一个集群中，主结点只有一个，负责管理集群，执行集群级别的操作，比如创建或删除索引，跟踪集群的组成结点的状态，决定将分片分配的目标结点，对集群来说，一个稳定的主结点十分重要。集群会自动进行健康检测，当主结点出现故障时，集群中的候选主结点进行选举，在选举结束之后，一个候选主结点被选举成为新的主结点，实现集群故障的自动转移。候选主结点具有投票权，其他结点没有投票权。
1，配置候选主结点和数据结点
默认情况下，ElasticSearch将当前节点配置为同时作为候选主结点和数据结点：
node.data:true 配置该结点是数据结点，用于保存数据，执行数据相关的操作（CRUD，Aggregation）；
node.master:true 配置该结点有资格被选举为主结点（候选主结点），用于处理请求和管理集群。如果结点没有资格成为主结点，那么该结点永远不可能成为主结点；如果结点有资格成为主结点，只有在被其他候选主结点认可和被选举为主结点之后，才真正成为主结点。
配置当前结点只保存数据：
node.master:false node.data:true
配置当前结点不保存数据，只做候选主结点：
node.master:false node.data:true
2，主结点选取的配置
discovery.zen.minimum_master_nodes 属性：默认值是1，该属性定义的是为了组成一个集群，相互连接的候选主结点的最小数目，强烈推荐该属性的设置使用多数原则：(master_eligible_nodes / 2) + 1，既能避免出现脑裂（split-brain），又能在故障发生后，快速选举出新的主结点，例如，有5个候选主结点，推荐把该属性设置为3。
3，结点的路径（Path）
默认情况下，ElasticSearch使用基于安装目录的相对路径来配置结点的路径，在安装目录下，有config，data，logs和plugins目录，一般情况下不需要单独配置。结点的路径配置项：
三，索引配置
1，配置索引的分片(shard)和副本(replica)数量
默认的配置是把索引分为5个分片，每个分片1个副本，共10个结点：
index.number_of_shards: 5 index.number_of_replicas: 1
禁用索引的分布式特性，使索引只创建在本地主机上：
index.number_of_shards: 1 index.number_of_replicas: 0
2，当前节点锁住内存
当JVM做分页切换（swapping）时，ElasticSearch执行的效率会降低，推荐把ES_MIN_MEM和ES_MAX_MEM两个环境变量设置成同一个值，并且保证机器有足够的物理内存分配给ES，同时允许ElasticSearch进程锁住内存：
bootstrap.mlockall: true
3，断路器（Circuit Breaker）控制内存的使用量
断路器用于阻止产生OutOfMemoryError的操作，每一个断路器设置一个内存使用的上限，一旦操作达到该上限，ElasticSearch将阻止该操作继续使用内存。设置较多，一般不需要修改，保持默认值：
4，字段数据缓存：
在对一个字段执行排序或聚合操作时，使用字段数据缓存（field data cache）将该字段的值加载到内存，以加快查询的速度。加载字段数据还原是IO密集的操作，推荐分配足够的内存。
5，结点查询缓存：
查询缓存用于缓存查询的结果，每一个节点都有一个查询缓存，缓存过期使用LRU淘汰策略（Least Recently Used eviction）：当缓存满时，最近最少使用的数据被淘汰，从缓存中清除，以存储新的数据。
6，索引缓存：
索引缓存用于存储最新的索引文档（newly indexed documents），当该缓存填充满时，缓存的文件将被写入到磁盘中的段（segment）中。
7，分片请求缓存：
当对一个索引执行查找请求（Search Request）时，每一个相关的分片（involved shard）都在本地执行查询，返回查询结果（local result）给协调结点（coordinating node）进行组合（combine），将各个分片的结果合并为最终的结果集返回。分片请求缓存对每个分片的查询结果进行缓存。
四，集群的网络配置
1，结点的IP地址配置
配置当前结点绑定的IP地址，默认为0.0.0.0
network.bind_host: 192.168.0.1
设置其它结点和该结点交互的ip地址，如果不设置它会自动判断，值必须是个真实的ip地址
network.publish_host: 192.168.0.1
同时设置bind_host和publish_host两个参数
network.host: 192.168.0.1
2，设置结点间交互的TCP端口，默认是9300
transport.tcp.port: 9300
3，设置对外服务的HTTP端口，默认为9200
http.port: 9200
4，设置是否压缩TCP传输时的数据，默认为false，不压缩
transport.tcp.compress: true
5，设置HTTP包内容的最大容量，默认100mb
http.max_content_length: 100mb
6，是否启用HTTP协议对外提供服务，默认为true，开启
http.enabled: true
五，集群的发现机制（Discovery）
ElasticSearch使用zen发现来寻找结点和选举主结点，组建集群。
1，配置多播（multicast）
多播（multicast）是zen发现的默认方法，主要有以下配置选项：
2，配置单播（unicast）
使用单播时，总是禁用多播，单播的配置选项：
discovery.zen.ping.unicast. hosts:指定接收单播请求的主机IP地址，推荐包含组成集群的所有主机，主机之间用逗号隔开；
discovery.zen.ping.multicast.enabled: false discovery.zen.ping.unicast.hosts: ["host1", "host2:port"]
3，结点之间的状态检测
ping是结点之间发送的心跳信号，用于检测其他结点是否健康运行，如果其他结点无法响应该信号，那么集群认为该结点发生故障，配置ping信号的属性：
六，本地网关（Gateway）和还原（Recovery）
网关用于持久化存储集群的状态，相当于关系型DB的事务日志。每一次集群状态的改变，ElasticSearch都将集群的状态存储到网关中。当集群重新启动时，它将会从网关中读取集群的状态，还原到上一次停机时的状态。
1，网关的类型
目前只支持local，默认值是local，默认的网关在本地文件系统中存储index及其元数据。
gateway.type: local
2，还原控制
还原控制的选项有：
3，保护动作
默认情况下，ElasticSearch自动创建索引，推荐关闭该选项
action.disable_close_all_indices: true action.disable_delete_all_indices: true action.disable_shutdown: true action.auto_create_index: false
4，还原限制（Recovery Throttling）
七，ElasticSearch重要配置示例
## cluster cluster.name: "my-es-cluster" ## node node.name: "node-1" node.master: true node.data: true ## index index.number_of_shards: 1 index.number_of_replicas: 0 ## memory bootstrap.mlockall: true ##network network.host: 192.168.0.1 transport.tcp.port: 9300 http.port: 9200 http.max_content_length: 100mb http.enabled: true ## Discovery discovery.zen.minimum_master_nodes: 1 discovery.zen.ping.timeout: 3s discovery.zen.ping.multicast.enabled: false discovery.zen.ping.unicast.hosts: ["host1", "host2:port"] ## gateway gateway.type: local gateway.recover_after_nodes: 1 gateway.recover_after_time: 10m gateway.expected_nodes: 2 ## protection action.disable_close_all_indices: true action.disable_delete_all_indices: true action.disable_shutdown: true action.auto_create_index: false ## Recovery Throttling cluster.routing.allocation.node_initial_primaries_recoveries: 4 cluster.routing.allocation.node_concurrent_recoveries: 2 indices.recovery.max_bytes_per_sec: 100mb indices.recovery.concurrent_streams: 5
参考文档：
Important Elasticsearch configuration
标签：ges 变量 one info vol src involve max set
原文地址：http://www.cnblogs.com/ljhdo/p/4959412.html
