Elasticsearch入门

安装Elasticsearch

安装Elasticsearch只有一个要求,就是需要依赖JDK。 Elasticsearch最新版本可以从 http://www.elastic.co/downloads/elasticsearch 下载;

下载之后解压安装包:

unzip elasticsearch-$VERSION.zip

运行Elasticsearch

cd elasticsearch-$VERSION ./bin/elasticsearch

如果你想让它在后台保持运行的话可以在命令后面再加一个 -d

启动elasticsearch服务后你就可以使用浏览器打开http://localhost:9200,在浏览器看到如下内容:

{
  "status" : 200,
  "name" : "Aegis",
  "cluster_name" : "elasticsearch_bianzexin",
  "version" : {
    "number" : "1.7.1",
    "build_hash" : "b88f43fc40b0bcd7f173a1f9ee2e97816de80b19",
    "build_timestamp" : "2015-07-29T09:54:16Z",
    "build_snapshot" : false,
    "lucene_version" : "4.10.4"
  },
  "tagline" : "You Know, for Search"
}

这就说明你的Elasticsearch已经正常work了,这时你就可以尽情地完虐Elasticsearch了。

另外在服务器上也可以通过servicewrapper这个es插件来启动,它支持通过参数,指定是在后台或前台运行es,并支持启动、停止、重启es服务。 先从http://github.com/elasticsearch/elasticsearch-servicewrapper 下载servicewrapper插件,解压之后将service文件夹放置es的bin目录下。具体命令集合如下:

bin/service/elasticsearch +
console 在前台运行es
start   在后台运行es
stop    停止es
install 使es作为服务在服务器启动时启动
remove  取消启动时自动启动
restart 重启es

初识Elasticsearch配置文件

Elasticsearch的config文件夹下有两个配置文件:elasticsearch.yml和logging.yml,第一个是es的基本配置文件,第二个是日志配置文件,es也是使用log4j来记录日志的,所以logging.yml里的设置按普通的log4j配置文件来设置就行了。下面对elasticsearch.yml这个文件做一个比较详细的说明。

  • cluster.name: elasticsearch

配置es的集群名称,默认是elasticsearch,es会自动发现在同一网段下的es,如果在同一个网段下有多个集群,就可以通过这个属性来区分不同的集群。

  • node.name: "Franz Kafka"

节点名,默认随机指定一个name列表中的名字,该列表在es的jar包种的config文件夹里name.txt文件中。

  • node.master: true

指定该节点是否有资格被选举为master,默认是true,es是默认集群中的第一台机器为master,如果这台机器挂了就会重新选举master。

  • node.data: true

指定该节点是否存储索引数据,默认是true。

  • index.number_of_shards: 5

设置默认索引分片个数,默认为5片。

  • index.number_of_replicas: 1

设置默认索引副本个数,默认为1个副本。

  • path.conf: /path/to/conf

设置配置文件的存储路径,默认是es根目录下地config文件夹。

  • path.data: /path/to/data

设置索引数据的存储路径,默认是es根目录下地data文件夹,可以设置多个存储路径,用逗号隔开,例如:path.data: /path/to/data1,/path/to/data2

  • path.work: /path/to/work

设置临时文件的存储路径,默认是es根目录下的work文件夹。

  • path.logs: /path/to/logs

设置日志文件的存储路径,默认是es根目录下的logs文件夹

  • path.plugins: /path/to/plugins

设置插件的存放路径,默认是es根目录下的plugins文件夹

  • bootstrap.mlockall: true

设置为true来锁住内存。因为当jvm开始swapping时es的效率 会降低,所以要保证它不swap,可以把ES_MIN_MEM和ES_MAX_MEM两个环境变量设置成同一个值,并且保证机器有足够的内存分配给es。 同时也要允许elasticsearch的进程可以锁住内存,linux下可以通过ulimit -l unlimited命令。

  • network.bind_host: 192.168.0.1

设置绑定的ip地址,可以是ipv4或ipv6的,默认为0.0.0.0。

  • network.publish_host: 192.168.0.1

设置其它节点和该节点交互的ip地址,如果不设置它会自动判断,值必须是个真实的ip地址。

  • network.host: 192.168.0.1

这个参数是用来同时设置bind_host和publish_host上面两个参数。

  • transport.tcp.port: 9300

设置节点间交互的tcp端口,默认是9300。

  • transport.tcp.compress: true

设置是否压缩tcp传输时的数据,默认为false,不压缩。

  • http.port: 9200

设置对外服务的http端口,默认为9200。

  • http.max_content_length: 100mb

设置内容的最大容量,默认100mb

  • http.enabled: false

是否使用http协议对外提供服务,默认为true,开启。

  • gateway.type: local

gateway的类型,默认为local即为本地文件系统,可以设置为本地文件系统,分布式文件系统,hadoop的HDFS,和amazon的s3服务器。

  • gateway.recover_after_nodes: 1

设置集群中N个节点启动时进行数据恢复,默认为1。

  • gateway.recover_after_time: 5m

设置初始化数据恢复进程的超时时间,默认是5分钟。

  • gateway.expected_nodes: 2

设置这个集群中节点的数量,默认为2,一旦这N个节点启动,就会立即进行数据恢复。

  • cluster.routing.allocation.node_initial_primaries_recoveries: 4

初始化数据恢复时,并发恢复线程的个数,默认为4。

  • cluster.routing.allocation.node_concurrent_recoveries: 2

添加删除节点或负载均衡时并发恢复线程的个数,默认为4。

  • indices.recovery.max_size_per_sec: 0

设置数据恢复时限制的带宽,如入100mb,默认为0,即无限制。

  • indices.recovery.concurrent_streams: 5

设置这个参数来限制从其它分片恢复数据时最大同时打开并发流的个数,默认为5。

  • discovery.zen.minimum_master_nodes: 1

设置这个参数来保证集群中的节点可以知道其它N个有master资格的节点。默认为1,对于大的集群来说,可以设置大一点的值(2-4)

  • discovery.zen.ping.timeout: 3s

设置集群中自动发现其它节点时ping连接超时时间,默认为3秒,对于比较差的网络环境可以高点的值来防止自动发现时出错。

  • discovery.zen.ping.multicast.enabled: false

设置是否打开多播发现节点,默认是true。

  • discovery.zen.ping.unicast.hosts: ["host1:port", "host2:port"]

设置集群中master节点的初始列表,可以通过这些节点来自动发现新加入集群的节点。

  • 下面是一些查询时的慢日志参数设置
index.search.slowlog.level: TRACE
index.search.slowlog.threshold.query.warn: 10s
index.search.slowlog.threshold.query.info: 5s
index.search.slowlog.threshold.query.debug: 2s
index.search.slowlog.threshold.query.trace: 500ms

index.search.slowlog.threshold.fetch.warn: 1s
index.search.slowlog.threshold.fetch.info: 800ms
index.search.slowlog.threshold.fetch.debug:500ms
index.search.slowlog.threshold.fetch.trace: 200ms