关键词: docker docker-compose elasticsearch logstash kibana elk
请大家移步最新版本：https://www.jianshu.com/p/2787b4c98687
ELK Stack
ELK (Elasticsearch + Logstash + Kibana)，是一个开源的日志收集平台，用于收集各种客户端日志文件在同一个平台上面做数据分析。
Introduction
Elasticsearch, 基于json分析搜索引擎
Logstash, 动态数据收集管道
Kibana, 可视化视图将elasticsearh所收集的data通过视图展现
Background
起初我们搭建ELK platform都是通过rpm包或者repo的形式直接setup在服务器机器上面，这给运维后期带来的一个问题就是，每起一个新的ELK platform都需要重新setup在新的机器上面，而从运维的角度去减少这样的重复性effort变得异常突出，下面是根据我自身的经验来介绍如何通过docker solution去快速启动一个新的ELK platform，而无需重新setup。
Prerequisite
OS : Centos 7.x
Docker engine > 1.12.x
Docker-compose > 1.11.x
- Clone GIT folder到本地，branch:
master
建议放在user HOME下面，eg：/home/user1/
$ cd ~
$ git clone https://github.com/easonlau02/elasticstack.git
- 根据你的需求选择配置环境变量
a. Elasticsearch + Logstash + Kibana 运行在同一个机器下面，相关配置文件 :~/elasticstack/.env
# ~/elasticstack/.env
# environment propertiese, for distinguishing
environment=prod
# elascticsearch-image, change data path in host machine, default as /use/data/
E_LOCAL_DATA_PATH=/usr/data/
# logstash-image
## If docker-compose file set network_mode as host, can access elasticsearch via localhost. For 3 components are in one machine, need to set as localhost
L_ELASTICSEARCH_HOST_ENV=localhost
# kibana-image
## If docker-compose file set network_mode as host, can access elasticsearch via localhost ip. For 3 components are in one machine, need to set as localhost ip : 127.0.0.1 or 0.0.0.0
K_ELASTICSEARCH_HOST_IP=127.0.0.1
b. Elasticsearch + Logstash + Kibana 分别分开运行在不同的机器下面，各自相关的配置文件如下：
- Elasticsearch:
~/elasticstack/elasticsearch/.env
# ~/elasticstack/elasticsearch/.env
# environment propertiese, for distinguishing
environment=prod
# elascticsearch-image, change data path in host machine, default as /use/data/
E_LOCAL_DATA_PATH=/usr/data/
- Logstash:
~/elasticstack/logstash/.env
# ~/elasticstack/logstash/.env
# environment propertiese, for distinguishing
environment=prod
# logstash-image
## Specify elasticsearch host, if the same machine, set it as localhost,
## if not, set specific host name.
## To make sure no firewall to access elasticsearch:9200
L_ELASTICSEARCH_HOST_ENV=localhost
- Kibana:
~/elasticstack/kibana/.env
# ~/elasticstack/kibana/.env
# environment propertise, for distinguishing
environment=prod
# for kibana-image
## Specify elasticsearch host, if the same machine, set it as 127.0.0.0 or 0.0.0.0, if not, set specific host IP. To make sure no firewall to access elasticsearchIP:9200
K_ELASTICSEARCH_HOST_IP=127.0.0.1
上述配置文件包含的配置属性均属于基本配置属性，为了可以更方便的修改配置文件，结合docker-compose自动搜索并加载.env的特性，将ELK所需要的基本配置抽离出来作为单个.env文件来修改配置，而不需要通过逐个配置文件进行修改，下面对上述基本属性简单描述：
* environment: 用来区分ELK platform的当前环境，通常有qa/prod，你也可以根据自己的情况指定为自己想要的value
* E_LOCAL_DATA_PATH: 设置elasticsearch data存储在宿主机的相对路劲或者绝对路径，默认为/usr/data/
* L_ELASTICSEARCH_HOST_ENV: 由于docker-compose里边设置了network_mode等于host，使得方便同一台机器上面方便logstash和elasticsearch通信，所以如果logstash和elasticsearch跑在同一台机器上面(a)，可以直接使用localhost来指定连接elasticsearch host；如果logstash和elasticsearch在不同机器上(b)，则需要指定对应elasticsearch所在机器的hostname
* K_ELASTICSEARCH_HOST_IP: 和L_ELASTICSEARCH_HOST_ENV一样由于network_mode等于host，如果kibana和elasticsearch在同一台机器上，只需要指定0.0.0.0 or 127.0.0.1(经过多次试验，由于kibana自身加载yaml配置文件的方式貌似无法通过$获取环境变量，而是单纯获取对应properties的string，所以这里通过extra_link的方式在kibana的container里边添加了一个DNS record，所以需要使用IP而不是hostname)；相应的如果处于不同的机器(b)，需指定elasticsearch所在机器的IP。
以上配置属性都是启动ELK所需要的基本配置，如果有需要更多的配置，可以手动修改相应的配置文件或者联系微信lexmay 或 email : [email protected]
- 配置完成后，使用docker-compose启动ELK service
关于docker-compose文件，通常不需要改动，你也可以根据自己的需求添加container的properties，你可以在docker-compose文件里看到上面配置的属性都当成环境变量传递进去，eg:~/elasticstack/docker-compose.yml：version: '2' services: elasticsearch: image: eason02/elasticsearch:5.0.1 ... environment: - env=${environment} volumes: ... - ${E_LOCAL_DATA_PATH}:/usr/share/elasticsearch/data ... ... logstash: image: eason02/logstash:5.0.1 ... environment: - env=${environment} ... ... kibana: image: eason02/kibana:5.0.1 ... environment: - env=${environment} extra_hosts: - "elasticsearchHost:*${K_ELASTICSEARCH_HOST_IP}*" ...
以上所用到的image都是自己构建然后放在hub.docker.com官网repository，相应Dockerfile构建如下 :
- elasticsearh:
~/elasticstack/elasticsearch/Dockerfile - logstash:
~/elasticstack/logstash/Dockerfile - kibana:
~/elasticstack/kibana/Dockerfile
a. 运行在同一个机器，相关compose文件： ~/elasticstack/docker-compose.yml
$ cd ~/elasticstack/
$ docker-compose up -d
b. 分开运行不同机器，相关compose文件：
Elasticsearch: ~/elasticstack/elasticsearch/docker-compose.yml
Logstash: ~/elasticstack/logstash/docker-compose.yml
Kibana: ~/elasticstack/kibana/docker-compose.yml
- eg:
Elasticsearch in host1:
Logstash in host2:$ cd ~/elasticstack/elasticsearch $ docker-compose up -d
Kibana in host3:$ cd ~/elasticstack/logstash $ docker-compose up -d$ cd ~/elasticstack/kibana $ docker-compose up -d
- 通过kibana host+5601端口访问查看启动效果，
:5601
成功启动
如果看到上述界面，说明配置启动成功，你可以看到Unable to fetch mapping. Do you have indices match...，是因为还没有使用beats plugin将log发送到logstash或者elasticsearch，所以不能建立index。下一篇文章将会介绍已同样的方式一键setup beats plugin，用来发送log到ELK《一键启动 filebeat 5.1.1 集成 logstash》
** 文章所有步骤都是经过实践检验并可行，若有问题，下方请评论。
——END——
作者 : Eason，专注各种技术、平台、集成，不满现状，喜欢改改改
文章、技术合作
Email : [email protected]