使用docker部署spring boot并接入skywalking的方法
一、概述
最近在研究skywalking,打算使用k8s部署 skywalking 并將 pod 中的應(yīng)用接入 skywalking 進行服務(wù)鏈路追蹤。這篇文章先不介紹 skywalking 在k8s中的部署和使用,而是先介紹如何使用手動和docker的方式使用 skywalking。在整個實踐過程中查閱了大量文檔,遇到了各種問題,這里將我自己的實踐過程記錄下來,希望對有同樣需求的小伙伴提供一些幫助。
1、skywalking 簡介
SkyWalking是一款廣受歡迎的國產(chǎn)APM(Application Performance Monitoring,應(yīng)用性能監(jiān)控)產(chǎn)品,主要針對微服務(wù)、Cloud Native和容器化(Docker、Kubernetes、Mesos)架構(gòu)的應(yīng)用。SkyWalking的核心是一個分布式追蹤系統(tǒng),目前是Apache基金會的頂級項目。
skywalking 的詳細介紹可以查看官方文檔:skywalking 官網(wǎng)
2、skywalking 架構(gòu)
從邏輯上講,SkyWalking分為四個部分:探針,平臺后端,存儲和UI,如下圖所示:
- 探針收集數(shù)據(jù)并重新格式化以符合SkyWalking的要求(不同的探針支持不同的來源)。
- 平臺后端支持數(shù)據(jù)聚合,分析和流處理,涵蓋跟蹤,指標(biāo)和日志。
- 存儲設(shè)備通過開放/可插入的界面存儲SkyWalking數(shù)據(jù)。您可以選擇現(xiàn)有的實現(xiàn),例如ElasticSearch,H2,MySQL,TiDB,InfluxDB,或者實現(xiàn)自己的實現(xiàn)。
- UI是一個高度可定制的基于Web的界面,允許SkyWalking最終用戶可視化和管理SkyWalking數(shù)據(jù)。
3、skywalking 如何自動上報數(shù)據(jù)
在使用鏈路追蹤控制臺追蹤應(yīng)用的鏈路數(shù)據(jù)之前,需要通過客戶端將應(yīng)用數(shù)據(jù)上報至鏈路追蹤。SkyWalking將Java應(yīng)用數(shù)據(jù)上報至鏈路追蹤控制臺,首先需要完成埋點工作。SkyWalking既支持自動探針(Dubbo、gRPC、JDBC、OkHttp、Spring、Tomcat、Struts、Jedis等),也支持手動埋點(OpenTracing)。本文介紹自動埋點方法。
skywalking 上報數(shù)據(jù)的原理如下圖所示:
二、使用 docker-compose 安裝 skywalking-oap-server 和 skywalking-ui
使用下面的命令在linux中安裝 docker-compose
:
yum install -y docker-compose
使用下面的命令創(chuàng)建 skywalking-docker-compose.yaml
文件:
vim skywalking-docker-compose.yaml
這里啟動一個 standlone
容器,默認使用 H2
存儲數(shù)據(jù),如需其他存儲可以查看官方文檔進行設(shè)置。skywalking-docker-compose.yaml
文件內(nèi)容如下:
version: '3' services: oap: image: apache/skywalking-oap-server:8.4.0-es6 container_name: oap restart: always ports: - 11800:11800 # agent 上報數(shù)據(jù)的端口,這是 gRPC 端口 - 12800:12800 # ui 讀取數(shù)據(jù)的端口, 這是 http 端口 skywaling-ui: image: apache/skywalking-ui:8.4.0 container_name: ui depends_on: - oap links: - oap ports: - 8088:8080 environment: - SW_OAP_ADDRESS=oap:12800
使用下面的命令啟動skywalking:
docker-compose -f skywalking-docker-compose.yaml up -d
使用下面的命令查看啟動日志:
docker-compose -f skywalking-docker-compose.yaml logs -f
啟動成功后,訪問:http://localhost:8088,可以看到如下界面:
三、手動將 spring boot 接入 skywalking
1、下載 skywalking agent
skywalking 官網(wǎng)下載地址:http://skywalking.apache.org/downloads/
我這里下載的是 apache-skywalking-apm-8.4.0.tar.gz
,在linux系統(tǒng)中也可以通過下面的命令下載并解壓:
wget https://archive.apache.org/dist/skywalking/8.4.0/apache-skywalking-apm-8.4.0.tar.gz tar -zxvf apache-skywalking-apm-8.4.0.tar.gz
解壓后的目錄結(jié)構(gòu)如下圖:
agent目錄的說明如下圖:
2、spring boot 項目自動上報數(shù)據(jù)
要上報spring boot項目的數(shù)據(jù)需要配置 skywalking 的接入點和服務(wù)名,可以通過下面的方式配置:
修改配置文件
打開前面下載的 agent/config/agent.config
文件,找到下面的兩個配置:
# The service name in UI agent.service_name=${SW_AGENT_NAME:Your_ApplicationName} # Backend service addresses. collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:127.0.0.1:11800}
根據(jù)實際情況進行配置即可,配置修改完成之后,可以通過下面的命令啟動spring boot 項目:
java -javaagent:<skywalking-agent-path> -jar spring-boot-demo
請將替換為Agent文件夾中的skywalking-agent.jar的絕對路徑。
注意-javaagent
參數(shù)一定要在-jar
參數(shù)之前。
通過命令參數(shù)進行配置
服務(wù)名可以在應(yīng)用程序的啟動命令行中添加-Dskywalking.agent.service_name
參數(shù)。
skywalking 接入點可以在應(yīng)用程序的啟動命令行中添加-Dskywalking.collector.backend_service
參數(shù)。
完整命令如下:
java -javaagent:<skywalking-agent-path> -Dskywalking.agent.service_name=<ServiceName> -Dskywalking.collector.backend_service=<backend-service-addresses> -jar yourApp.jar
在idea中啟動參數(shù)中配置
我們也可以在 idea 啟動配置選項的 VM options
中進行如下配置:
配置完成后,啟動項目可以看到如下信息打印到控制臺:
查看skywalking 控制臺,并沒有數(shù)據(jù),因為需要先訪問接口,才會上報數(shù)據(jù)到控制臺,通過不斷的調(diào)用測試接口,再次查看控制臺可以看到我們的調(diào)用情況,如下圖所示:
四、使用 docker 部署 spring boot 并接入 skywalking
這里 spring boot 的基礎(chǔ)鏡像選擇 skywalking-base
,此鏡像中包含 openjdk11
和 skywalking-agent
,詳細的信息可以參考下面的參考文檔。
spring boot 的 Dockerfile
文件內(nèi)容如下:
FROM apache/skywalking-base:8.4.0-es6 WORKDIR /app COPY target/spring-demo-0.0.1-SNAPSHOT.jar spring-demo-0.0.1-SNAPSHOT.jar ENV SW_AGENT_COLLECTOR_BACKEND_SERVICES="127.0.0.1:11800" \ SW_AGENT_NAME="my-spring-demo-test-adfasdf" CMD java -javaagent:/skywalking/agent/skywalking-agent.jar \ -jar spring-demo-0.0.1-SNAPSHOT.jar
這里使用環(huán)境變量的方式為 skywalking 設(shè)置自定義參數(shù),環(huán)境變量的其他配置可以查看 agent/config/agent.config
文件。
使用下面的命令構(gòu)建鏡像:
docker build -t spring-boot-demo .
使用下面的命令啟動鏡像:
docker run --rm -p 8080:8080 spring-boot-demo
啟動成功之后可以訪問測試的地址,到 skywalking 控制臺查看是否有數(shù)據(jù)上報,如果沒有數(shù)據(jù)上報,我們需要查看 skywalking agent 的日志,可以在 agent/logs/skywalking-api.log
文件中查看報錯信息。
參考文檔
skywalking 官方文檔
Apache SkyWalking Docker Files
通過SkyWalking上報Java應(yīng)用數(shù)據(jù)
到此這篇關(guān)于使用docker部署spring boot并接入skywalking的文章就介紹到這了,更多相關(guān)docker部署spring boot接入skywalking內(nèi)容請搜索本站以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持本站!
版權(quán)聲明:本站文章來源標(biāo)注為YINGSOO的內(nèi)容版權(quán)均為本站所有,歡迎引用、轉(zhuǎn)載,請保持原文完整并注明來源及原文鏈接。禁止復(fù)制或仿造本網(wǎng)站,禁止在非www.sddonglingsh.com所屬的服務(wù)器上建立鏡像,否則將依法追究法律責(zé)任。本站部分內(nèi)容來源于網(wǎng)友推薦、互聯(lián)網(wǎng)收集整理而來,僅供學(xué)習(xí)參考,不代表本站立場,如有內(nèi)容涉嫌侵權(quán),請聯(lián)系alex-e#qq.com處理。