1. 程式人生 > 實用技巧 >SpringBoot 配置 ELK 環境

SpringBoot 配置 ELK 環境

在看大型網站的中介軟體技術,對於Elasticsearch有點興趣,所以將配置流程記錄了一下

為什麼要用ELK
ELK實際上是三個工具,Elastricsearch + LogStash + Kibana,通過ELK,用來收集日誌還有進行日誌分析,最後通過視覺化UI進行展示。一開始業務量比較小的時候,通過簡單的SLF4J+Logger在伺服器列印日誌,通過grep進行簡單查詢,但是隨著業務量增加,資料量也會不斷增加,所以使用ELK可以進行大數量的日誌收集和分析

簡單畫了一下架構圖

「在環境配置中,主要介紹Mac和linux配置,windows系統大致相同,當然,前提是大家都安裝了JDK1.8及以上版本~」

[root@VM_234_23_centos ~]# java -version
java version "1.8.0_161"
Java(TM) SE Runtime Environment (build 1.8.0_161-b12)
Java HotSpot(TM) 64-Bit Server VM (build 25.161-b12, mixed mode)
注意

高版本的ELK同樣需要高版本的JDK支援,本文配置的ELK版本是6.0+,所以需要的JDK版本不小於1.8

ElasticSearch
Elasticsearch 是一個分散式的 RESTful 風格的搜尋和資料分析引擎,能夠解決不斷湧現出的各種用例。作為 Elastic Stack 的核心,它集中儲存您的資料,幫助您發現意料之中以及意料之外的情況。

Mac安裝和執行

安裝:brew install elasticsearch
執行:elasticsearch
linux: 從Elasticsearch官方地址下載(也可以下載完,通過ftp之類的工具傳上去),gz檔案的話通過tar進行解壓縮,然後進入bin目錄下執行軟體

[root@VM_234_23_centos app]# curl -L -O https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.2.4.tar.gz
[root@VM_234_23_centos app]# tar -zxvf elasticsearch-6.2.4.tar.gz
[root@VM_234_23_centos app]# cd elasticsearch-6.2.4
[root@VM_234_23_centos elasticsearch-6.2.4]# ./bin/elasticsearch
注意

在Linux機器上,執行elasticsearch需要一個新的使用者組,文章最後有Elastic在linux安裝的踩坑記錄

Logstash
Logstash 是開源的伺服器端資料處理管道,能夠同時從多個來源採集資料,轉換資料,然後將資料傳送到您最喜歡的 “儲存庫” 中。(我們的儲存庫當然是 Elasticsearch。)-官方賣萌

「1. 軟體安裝」

Mac安裝:

brew install logstash
linux安裝:

[root@VM_234_23_centos app]# curl -L -O https://artifacts.elastic.co/downloads/logstash/logstash-6.3.2.tar.gz
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 137M 100 137M 0 0 5849k 0 0:00:24 0:00:24 --:--:-- 6597k
[root@VM_234_23_centos app]# tar -zxvf logstash-6.3.2.tar.gz
「2. 修改配置檔案」

vim /etc/logstash.conf
「conf檔案,指定要使用的外掛,和配置對應的elasticsearch的hosts」

input { stdin { } }
output {
elasticsearch { hosts => ["localhost:9200"] }
stdout { codec => rubydebug }
}
「3. 執行」

bin/logstash -f logstash.conf
「4. 訪問http://localhost:9600/」

{
"host": "=-=",
"version": "6.2.4",
"http_address": "127.0.0.1:9600",
"id": "5b47e81f-bdf8-48fc-9537-400107a13bd2",
"name": "=-=",
"build_date": "2018-04-12T22:29:17Z",
"build_sha": "a425a422e03087ac34ad6949f7c95ec6d27faf14",
"build_snapshot": false
}
「在elasticsearch日誌中,也能看到logstash正常加入的日誌」

[2018-08-16T14:08:36,436][INFO ][o.e.c.m.MetaDataIndexTemplateService] [f2s1SD8] adding template [logstash] for index patterns [logstash-*]
「看到這種返回值,表示已經成功安裝和啟動」

踩坑

在執行的那一步,有可能遇到記憶體分配錯誤

Java HotSpot(TM) 64-Bit Server VM warning: INFO: os::commit_memory(0x00000000c5330000, 986513408, 0) failed; error=’Cannot allocate memory’ (errno=12)

這個錯誤很明顯就是記憶體不足,由於個人購買的是騰訊雲1G記憶體的伺服器(如果是壕,請隨意購買更高的配置=-=),已經運行了elasticsearch,導致logstash分配不到足夠的記憶體,所以最後要修改一下jvm配置。

[root@VM_234_23_centos logstash-6.3.2]# cd config/
[root@VM_234_23_centos config]# ll
total 28
-rw-r--r-- 1 root root 1846 Jul 20 14:19 jvm.options
-rw-r--r-- 1 root root 4466 Jul 20 14:19 log4j2.properties
-rw-r--r-- 1 root root 8097 Jul 20 14:19 logstash.yml
-rw-r--r-- 1 root root 3244 Jul 20 14:19 pipelines.yml
-rw-r--r-- 1 root root 1696 Jul 20 14:19 startup.options
[root@VM_234_23_centos config]# vim jvm.options
「將-Xms1g -Xmx1g修改為」

-Xms256m
-Xmx256m
「然後就能正常啟動了~~」

Kibana
「1. 軟體安裝」

Kibana 讓您能夠視覺化 Elasticsearch 中的資料並操作 Elastic Stack,因此您可以在這裡解開任何疑問:例如,為何會在凌晨 2:00 被傳呼,雨水會對季度資料造成怎樣的影響。(而且展示的圖示十分酷炫)

Mac安裝

brew install kibana
linux安裝,官方下載地址:

https://www.elastic.co/downloads/kibana

[root@VM_234_23_centos app]# curl -L -O https://artifacts.elastic.co/downloads/kibana/kibana-6.3.2-linux-x86_64.tar.gz
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
0 195M 0 271k 0 0 19235 0 2:57:54 0:00:14 2:57:40 26393
「在這一步,有可能下載速度奇慢,所以我本地下載好之後,通過rz命令傳輸到伺服器」

[root@VM_234_23_centos app]# rz
rz waiting to receive.
Starting zmodem transfer. Press Ctrl+C to cancel.
Transferring kibana-6.3.2-linux-x86_64.tar.gz...
100% 200519 KB 751 KB/sec 00:04:27 0 Errors
[root@VM_234_23_centos app]# tar -zxvf kibana-6.3.2-linux-x86_64.tar.gz
「2. 修改配置」

修改 config/kibana.yml 配置檔案,設定 elasticsearch.url 指向 Elasticsearch 例項。

如果跟我一樣使用預設的配置,可以不需要修改該檔案

「3. 啟動」

[root@VM_234_23_centos kibana]# ./bin/kibana
「4. 訪問 http://localhost:5601/app/kibana#/home?_g=()」

「介面顯示了這麼多功能,下面通過整合SLF4J+LogBack」

整合Spring+Logstash
「1. 修改logstash.conf後,重新啟動logstash」

input {

stdin { }

tcp {
# host:port就是上面appender中的 destination,

這裡其實把logstash作為服務,開啟9250埠接收logback發出的訊息

host => "127.0.0.1" port => 9250 mode => "server" tags => ["tags"] codec => json_lines 

}
}
output {
elasticsearch { hosts => ["localhost:9200"] }
stdout { codec => rubydebug }
}
「2. 在Java應用中引用依賴」

net.logstash.logback logstash-logback-encoder 5.2 「3. 在Logback.xml中配置日誌輸出」


localhost:9250



{"appname":"ye_test"}

「由於我在第一步驟中,沒有指定對應的index,所以在服務啟動的時候,日誌採集器Logstash幫我自動建立了logstash-timestamp的index」

「4. 在kibana中新增index索引」

「5. 在左邊discover中檢視索引資訊」

「6. 新增視覺化圖表Visualize」

「還有更多功能還在探索中,首先環境搭起來才會用動力繼續去學習~」

踩坑記錄
啟動報錯
uncaught exception in thread [main] org.elasticsearch.bootstrap.StartupException: java.lang.RuntimeException: can not run elasticsearch as root

原因:不能使用Root許可權登入

解決方案:切換使用者

[root@VM_234_23_centos ~]# groupadd es
[root@VM_234_23_centos ~]# useradd es -g es -p es
[root@VM_234_23_centos ~]# chown es:es /home/app/elasticsearch/

切換使用者,記得su - ,這樣才能獲得環境變數

[root@VM_234_23_centos ~]# sudo su - es
Exception in thread “main” java.nio.file.AccessDeniedException:

錯誤原因:使用非 root使用者啟動ES,而該使用者的檔案許可權不足而被拒絕執行。

解決方法:chown -R 使用者名稱:使用者名稱 檔案(目錄)名

例如:chown -R abc:abc searchengine
再啟動ES就正常了

elasticsearch啟動後報Killed
[2018-07-13T10:19:44,775][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [aggs-matrix-stats]
[2018-07-13T10:19:44,779][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [analysis-common]
[2018-07-13T10:19:44,780][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [ingest-common]
[2018-07-13T10:19:44,780][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [lang-expression]
[2018-07-13T10:19:44,780][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [lang-mustache]
[2018-07-13T10:19:44,780][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [lang-painless]
[2018-07-13T10:19:44,780][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [mapper-extras]
[2018-07-13T10:19:44,780][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [parent-join]
[2018-07-13T10:19:44,780][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [percolator]
[2018-07-13T10:19:44,780][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [rank-eval]
[2018-07-13T10:19:44,781][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [reindex]
[2018-07-13T10:19:44,781][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [repository-url]
[2018-07-13T10:19:44,781][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [transport-netty4]
[2018-07-13T10:19:44,781][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [tribe]
[2018-07-13T10:19:44,781][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-core]
[2018-07-13T10:19:44,781][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-deprecation]
[2018-07-13T10:19:44,781][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-graph]
[2018-07-13T10:19:44,781][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-logstash]
[2018-07-13T10:19:44,782][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-ml]
[2018-07-13T10:19:44,782][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-monitoring]
[2018-07-13T10:19:44,782][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-rollup]
[2018-07-13T10:19:44,782][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-security]
[2018-07-13T10:19:44,782][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-sql]
[2018-07-13T10:19:44,782][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-upgrade]
[2018-07-13T10:19:44,782][INFO ][o.e.p.PluginsService ] [f2s1SD8] loaded module [x-pack-watcher]
[2018-07-13T10:19:44,783][INFO ][o.e.p.PluginsService ] [f2s1SD8] no plugins loaded
Killed
修改config目錄下的jvm.options,將堆的大小設定小一點

Xms represents the initial size of total heap space

Xmx represents the maximum size of total heap space

-Xms512m
-Xmx512m
虛擬記憶體不足
max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]

[2018-07-13T14:02:06,749][DEBUG][o.e.a.ActionModule ] Using REST wrapper from plugin org.elasticsearch.xpack.security.Security
[2018-07-13T14:02:07,249][INFO ][o.e.d.DiscoveryModule ] [f2s1SD8] using discovery type [zen]
[2018-07-13T14:02:09,173][INFO ][o.e.n.Node ] [f2s1SD8] initialized
[2018-07-13T14:02:09,174][INFO ][o.e.n.Node ] [f2s1SD8] starting ...
[2018-07-13T14:02:09,539][INFO ][o.e.t.TransportService ] [f2s1SD8] publish_address {10.105.234.23:9300}, bound_addresses {0.0.0.0:9300}
[2018-07-13T14:02:09,575][INFO ][o.e.b.BootstrapChecks ] [f2s1SD8] bound or publishing to a non-loopback address, enforcing bootstrap checks
ERROR: [1] bootstrap checks failed
[1]: max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]
[2018-07-13T14:02:09,621][INFO ][o.e.n.Node ] [f2s1SD8] stopping ...
[2018-07-13T14:02:09,726][INFO ][o.e.n.Node ] [f2s1SD8] stopped
[2018-07-13T14:02:09,726][INFO ][o.e.n.Node ] [f2s1SD8] closing ...
[2018-07-13T14:02:09,744][INFO ][o.e.n.Node ] [f2s1SD8] closed
需要修改虛擬記憶體的大小(在root許可權下)

[root@VM_234_23_centos elasticsearch]# vim /etc/sysctl.conf

插入下列程式碼後儲存退出

vm.max_map_count=655360
[root@VM_234_23_centos elasticsearch]# sysctl -p

最後重啟elastricsearch

參考文章
ELK 快速指南

Mac上搭建ELK

通過ELK快速搭建一個你可能需要的集中化日誌平臺

Logback JSON encoder

elasticSearch安裝常見錯誤或問題

Linux中root使用者找不到JAVA_HOME

遠端連線elasticsearch遇到的問題