使用docker部署spring boot并接入skywalking的方法
一、概述
最近在研究skywalking,打算使用k8s部署 skywalking 并将 pod 中的应用接入 skywalking 进行服务链路追踪。这篇文章先不介绍 skywalking 在k8s中的部署和使用,而是先介绍如何使用手动和docker的方式使用 skywalking。在整个实践过程中查阅了大量文档,遇到了各种问题,这里将我自己的实践过程记录下来,希望对有同样需求的小伙伴提供一些帮助。
1、skywalking 简介
SkyWalking是一款广受欢迎的国产APM(Application Performance Monitoring,应用性能监控)产品,主要针对微服务、Cloud Native和容器化(Docker、Kubernetes、Mesos)架构的应用。SkyWalking的核心是一个分布式追踪系统,目前是Apache基金会的顶级项目。
skywalking 的详细介绍可以查看官方文档:skywalking 官网
2、skywalking 架构
从逻辑上讲,SkyWalking分为四个部分:探针,平台后端,存储和UI,如下图所示:
- 探针收集数据并重新格式化以符合SkyWalking的要求(不同的探针支持不同的来源)。
- 平台后端支持数据聚合,分析和流处理,涵盖跟踪,指标和日志。
- 存储设备通过开放/可插入的界面存储SkyWalking数据。您可以选择现有的实现,例如ElasticSearch,H2,MySQL,TiDB,InfluxDB,或者实现自己的实现。
- UI是一个高度可定制的基于Web的界面,允许SkyWalking最终用户可视化和管理SkyWalking数据。
3、skywalking 如何自动上报数据
在使用链路追踪控制台追踪应用的链路数据之前,需要通过客户端将应用数据上报至链路追踪。SkyWalking将Java应用数据上报至链路追踪控制台,首先需要完成埋点工作。SkyWalking既支持自动探针(Dubbo、gRPC、JDBC、OkHttp、Spring、Tomcat、Struts、Jedis等),也支持手动埋点(OpenTracing)。本文介绍自动埋点方法。
skywalking 上报数据的原理如下图所示:
二、使用 docker-compose 安装 skywalking-oap-server 和 skywalking-ui
使用下面的命令在linux中安装 docker-compose
:
yum install -y docker-compose
使用下面的命令创建 skywalking-docker-compose.yaml
文件:
vim skywalking-docker-compose.yaml
这里启动一个 standlone
容器,默认使用 H2
存储数据,如需其他存储可以查看官方文档进行设置。
skywalking-docker-compose.yaml
文件内容如下:
version: '3' services: oap: image: apache/skywalking-oap-server:8.4.0-es6 container_name: oap restart: always ports: - 11800:11800 # agent 上报数据的端口,这是 gRPC 端口 - 12800:12800 # ui 读取数据的端口, 这是 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 官网下载地址:http://skywalking.apache.org/downloads/
我这里下载的是 apache-skywalking-apm-8.4.0.tar.gz
,在linux系统中也可以通过下面的命令下载并解压:
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
解压后的目录结构如下图:
agent目录的说明如下图:
2、spring boot 项目自动上报数据
要上报spring boot项目的数据需要配置 skywalking 的接入点和服务名,可以通过下面的方式配置:
修改配置文件
打开前面下载的 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}
根据实际情况进行配置即可,配置修改完成之后,可以通过下面的命令启动spring boot 项目:
java -javaagent:<skywalking-agent-path> -jar spring-boot-demo
请将替换为Agent文件夹中的skywalking-agent.jar的绝对路径。
注意-javaagent
参数一定要在-jar
参数之前。
通过命令参数进行配置
服务名可以在应用程序的启动命令行中添加-Dskywalking.agent.service_name
参数。
skywalking 接入点可以在应用程序的启动命令行中添加-Dskywalking.collector.backend_service
参数。
完整命令如下:
java -javaagent:<skywalking-agent-path> -Dskywalking.agent.service_name=<ServiceName> -Dskywalking.collector.backend_service=<backend-service-addresses> -jar yourApp.jar
在idea中启动参数中配置
我们也可以在 idea 启动配置选项的 VM options
中进行如下配置:
配置完成后,启动项目可以看到如下信息打印到控制台:
查看skywalking 控制台,并没有数据,因为需要先访问接口,才会上报数据到控制台,通过不断的调用测试接口,再次查看控制台可以看到我们的调用情况,如下图所示:
四、使用 docker 部署 spring boot 并接入 skywalking
这里 spring boot 的基础镜像选择 skywalking-base
,此镜像中包含 openjdk11
和 skywalking-agent
,详细的信息可以参考下面的参考文档。
spring boot 的 Dockerfile
文件内容如下:
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
这里使用环境变量的方式为 skywalking 设置自定义参数,环境变量的其他配置可以查看 agent/config/agent.config
文件。
使用下面的命令构建镜像:
docker build -t spring-boot-demo .
使用下面的命令启动镜像:
docker run --rm -p 8080:8080 spring-boot-demo
启动成功之后可以访问测试的地址,到 skywalking 控制台查看是否有数据上报,如果没有数据上报,我们需要查看 skywalking agent 的日志,可以在 agent/logs/skywalking-api.log
文件中查看报错信息。
参考文档
skywalking 官方文档
Apache SkyWalking Docker Files
通过SkyWalking上报Java应用数据
到此这篇关于使用docker部署spring boot并接入skywalking的文章就介绍到这了,更多相关docker部署spring boot接入skywalking内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞!
相关文章
- 这篇文章主要介绍了Spring AOP 对象内部方法间的嵌套调用方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-08-29
解决springboot使用logback日志出现LOG_PATH_IS_UNDEFINED文件夹的问题
这篇文章主要介绍了解决springboot使用logback日志出现LOG_PATH_IS_UNDEFINED文件夹的问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-04-28Spring Cloud 中@FeignClient注解中的contextId属性详解
这篇文章主要介绍了Spring Cloud 中@FeignClient注解中的contextId属性详解,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-25Springboot如何实现Web系统License授权认证
这篇文章主要介绍了Springboot如何实现Web系统License授权认证,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-05-28- 这篇文章主要为大家详细介绍了SpringBoot实现excel文件生成和下载,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...2021-02-09
如何在Spring WebFlux的任何地方获取Request对象
这篇文章主要介绍了如何在Spring WebFlux的任何地方获取Request对象,帮助大家更好的理解和使用springboot框架,感兴趣的朋友可以了解下...2021-01-26- 这篇文章主要介绍了详解springBoot启动时找不到或无法加载主类解决办法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-09-16
- 这篇文章主要介绍了详解SpringCloudGateway内存泄漏问题,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-07-16
- 这篇文章主要介绍了SpringBoot集成Redis实现消息队列的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-02-10
- 这篇文章主要介绍了解决Springboot get请求是参数过长的情况,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-09-17
Spring Boot项目@RestController使用重定向redirect方式
这篇文章主要介绍了Spring Boot项目@RestController使用重定向redirect方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-02- 这篇文章主要介绍了Springboot+TCP监听服务器搭建过程,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2020-10-28
- 这篇文章主要介绍了springBoot 项目排除数据库启动方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-09-10
- @Autowired 注解的主要功能就是完成自动注入,使用也非常简单,但这篇文章主要给大家介绍了关于Spring为什么不推荐使用@Autowired注解的相关资料,需要的朋友可以参考下...2021-11-03
Springboot如何使用mybatis实现拦截SQL分页
这篇文章主要介绍了Springboot使用mybatis实现拦截SQL分页,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-06-19docker 启动elasticsearch镜像,挂载目录后报错的解决
这篇文章主要介绍了docker 启动 elasticsearch镜像,挂载目录后报错的解决,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-11-20详解SpringBoot之访问静态资源(webapp...)
这篇文章主要介绍了详解SpringBoot之访问静态资源(webapp...),文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-09-14- 这篇文章主要介绍了SpringBoot接口接收json参数解析,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-10-19
解决Docker中的error during connect异常情况
这篇文章主要介绍了解决Docker中的error during connect异常情况,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-11-22- 这篇文章主要介绍了SpringMVC文件上传原理及实现过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-07-15