ELK即Elasticsearch、Logstash、Kibana,组合起来可以搭建线上日志系统,在目前这种分布式微服务系统中,通过ELK 会非常方便的查询和统计日志情况.
本文以zxcloud 的upms 模块为例

ELK中各个服务的作用

  • Elasticsearch:用于存储收集到的日志信息;
  • Logstash:用于收集日志,应用整合了Logstash以后会把日志发送给Logstash,Logstash再把日志转发给Elasticsearch;
  • Kibana:通过Web端的可视化界面来查看日志。

    使用Docker Compose 搭建ELK环境

    编写docker-compose.yml脚本启动ELK服务

    1. version: '3'
    2. services:
    3. elasticsearch:
    4. image: elasticsearch:6.4.0
    5. container_name: elasticsearch
    6. environment:
    7. - "cluster.name=elasticsearch" #设置集群名称为elasticsearch
    8. - "discovery.type=single-node" #以单一节点模式启动
    9. - "ES_JAVA_OPTS=-Xms512m -Xmx512m" #设置使用jvm内存大小
    10. volumes:
    11. - /mydata/elasticsearch/plugins:/usr/share/elasticsearch/plugins #插件文件挂载
    12. - /mydata/elasticsearch/data:/usr/share/elasticsearch/data #数据文件挂载
    13. ports:
    14. - 9200:9200
    15. kibana:
    16. image: kibana:6.4.0
    17. container_name: kibana
    18. links:
    19. - elasticsearch:es #可以用es这个域名访问elasticsearch服务
    20. depends_on:
    21. - elasticsearch #kibana在elasticsearch启动之后再启动
    22. environment:
    23. - "elasticsearch.hosts=http://es:9200" #设置访问elasticsearch的地址
    24. ports:
    25. - 5601:5601
    26. logstash:
    27. image: logstash:6.4.0
    28. container_name: logstash
    29. volumes:
    30. - /mydata/logstash/upms-logstash.conf:/usr/share/logstash/pipeline/logstash.conf
    31. depends_on:
    32. - elasticsearch #kibana在elasticsearch启动之后再启动
    33. links:
    34. - elasticsearch:es #可以用es这个域名访问elasticsearch服务
    35. ports:
    36. - 4560:4560
    opy to clipboardErrorCopied

    创建对应容器挂载目录

    ```shell mkdir -p /mydata/logstash

mkdir -p /mydata/elasticsearch/data

mkdir -p /mydata/elasticsearch/plugins

chmod 777 /mydata/elasticsearch/data # 给777权限,不然启动elasticsearch 可能会有权限问题

opy to clipboardErrorCopied
<a name="NGjC5"></a>
### 编写日志采集logstash
在 /mydata/logstash目录创建 upms-logstash.conf
```json
input {
  tcp {
    mode => "server"
    host => "0.0.0.0"
    port => 4560
    codec => json_lines
  }
}
output {
  elasticsearch {
    hosts => "es:9200"
    index => "upms-logstash-%{+YYYY.MM.dd}"
  }
}

to clipboardErrorCopied

启动ELK 服务

在docker-compose.yml 同级目录执行 docker-compose up -d
注意:Elasticsearch启动可能需要好几分钟,要耐心等待。
ELK日志系统 - 图1

logstash 安装json_lines 格式插件

# 进入logstash容器
docker exec -it logstash /bin/bash
# 进入bin目录
cd /bin/
# 安装插件
logstash-plugin install logstash-codec-json_lines
# 退出容器
exit
# 重启logstash服务
docker restart logstash

opy to clipboardErrorCopied

访问宿主机5601 kibana

ELK日志系统 - 图2

zxcloud 服务整合Logstash (以UPMS模块为例)

添加pom 依赖

<!--集成logstash-->
<dependency>
    <groupId>net.logstash.logback</groupId>
    <artifactId>logstash-logback-encoder</artifactId>
    <version>5.3</version>
</dependency>


py to clipboardErrorCopied

logback-spring.xml 新增appender

 <!--输出到logstash的appender-->
<appender name="LOGSTASH" class="net.logstash.logback.appender.LogstashTcpSocketAppender">
    <!--可以访问的logstash日志收集端口-->
    <destination>192.168.0.31:4560</destination>
    <encoder charset="UTF-8" class="net.logstash.logback.encoder.LogstashEncoder"/>
</appender>
<root level="INFO">
    <appender-ref ref="LOGSTASH"/>
</root>

opy to clipboardErrorCopied

启动zxcloud 在kibana中查询日志

ELK日志系统 - 图3 ELK日志系统 - 图4

同时采集多个模块日志

每个应用发送到不同的TCP 端口 这里注意logstash 的容器端口映射增加

input {
  tcp {
   add_field => {"service" => "upms"}
    mode => "server"
    host => "0.0.0.0"
    port => 4560
    codec => json_lines
  }
  tcp {
   add_field => {"service" => "auth"}
    mode => "server"
    host => "0.0.0.0"
    port => 4561
    codec => json_lines
  }
}
output {
   if [service] == "upms"{
    elasticsearch {
      hosts => "es:9200"
      index => "upms-logstash-%{+YYYY.MM.dd}"
    }
   }
  if [service] == "auth"{
    elasticsearch {
      hosts => "es:9200"
      index => "auth-logstash-%{+YYYY.MM.dd}"
    }
   }
}