ELK - MAC环境搭建
ELK - MAC环境搭建
本文旨在记录elasticsearch、logstash、kibana在mac下的安装与启动。
写在前面
ELK的官方文档对与它们的使用方法已经讲的非常清楚了,这里只对相关的安装步骤以及可能碰到的一些坑进行一些记录。
先决条件
- java8
- mac软件管理工具brew
brew相关命令
# 安装软件
brew install your-software
# 查看软件安装信息
brew info your-software
# 管理服务,没怎么用它,ELK都有自己的启动脚本在安装目录的bin/下面,且基本上都会携带参数启动
brew services start/stop your-service
elasticsearch
mac安装elasticsearch
# mac安装elasticsearch
brew install elasticsearch
elasticsearch的相关安装位置
安装目录:/usr/local/Cellar/elasticsearch/{elasticsearch-version}/
日志目录:/usr/local/var/log/elasticsearch/
插件目录:/usr/local/var/elasticsearch/plugins/
配置目录:/usr/local/etc/elasticsearch/
安装完成elasticsearch之后,可以通过brew services start elasticsearch
启动它,然后通过curl请求REST API对它进行调用
首次启动,默认的端口号是9200,用户名是elastic,密码我也不知道(资料上查到的都是6.0以前的版本,密码是changeme,6.0以后不清楚),通过调用_xpack接口修改默认密码:
# 如果不是第一次修改,则需要输入当前密码才能进行密码修改
curl -XPUT -u elastic 'localhost:9200/_xpack/security/user/elastic/_password' -H "Content-Type: application/json" -d '{"password":"123456"}'
kibana
# mac安装kibana
brew install kibana
kibana的相关安装位置
安装目录:/usr/local/Cellar/kibana/{kibana-version}/
配置目录:/usr/local/etc/kibana/
启动kibana之前,需要先修改一下配置文件/usr/local/etc/kibana/kibana.yml,取消elasticsearch.name和elasticsearch.password的注释,并将值改为上面修改过的用户名密码username: elastic, password: 123456,请参考下面的kibana.yml片段
# /usr/local/Cellar/kibana/6.2.4/kibana.yml
server.port: 5601
server.host: "localhost"
elasticsearch.url: "http://localhost:9200"
elasticsearch.username: "elastic"
elasticsearch.password: "changeme"
这里提供两个脚本用来启动/停止kibana:
#! /bin/bash
# 启动脚本: file path: /usr/local/Cellar/kibana/6.2.4/bin/kibana-start.sh
nohup ./bin/kibana -l /usr/local/var/log/kibana.log > /dev/null & echo $! > pid.txt
#! /bin/bash
# 停止脚本:file path: /usr/local/Cellar/kibana/6.2.4/bin/kibana-stop.sh
kill -9 `cat bin/pid.txt`
因为默认的启动脚本bin/kibana
并没有提供后台运行,且如果不指定-l
参数,默认是没有日志文件的,这里我将日志文件定位到了/usr/local/var/log/kibana.log
文件中。
首次启动,默认端口号是5601,打开浏览器访问http://localhost:5601
访问kibana管理页面,会弹框要求输入用户名密码,输入elastic和123456即可。
注:这里的kibana.yml中配置的用户名密码是kibana访问elasticsearch需要用到的,而web页面手动输入的用户名密码是我们登录kibana管理页面的密码,它们为什么能共用一个密码,不太清楚
坑:如果没有配置kibana.yml,虽然可以登录成功kibana,但是在kibana页面中什么都访问不了,它会提示你elasticsearch的认证失败!
logstash
# mac安装logstash
brew install logstash
logstash的相关安装位置
安装目录:/usr/local/Cellar/logstash/{logstash-version}/
启动相关:参考备注
filebeat
# mac安装filebeat
brew install filebeat
filebeat的相关安装位置
安装目录:/usr/local/Cellar/filebeat/{filebeat-version}/
配置目录:/usr/local/etc/filebeat/
缓存目录:/usr/local/var/lib/filebeat/
启动相关:参考备注
备注
因为logstash的启动关乎很多概念如管道、输入、输出、过滤器等,我这里是参考的官方文档,写的非常清晰:https://www.elastic.co/guide/en/logstash/current/getting-started-with-logstash.html
讲了logstash结合filebeat将Apache日志文件解析成结构化数据存储到elasticsearch