使用 docker 部署 spring boot 并接入 skywalking

标签: java 程序员 容器 docker springboot | 发表时间:2021-04-16 15:41 | 作者:惜鸟
出处:https://segmentfault.com/blogs

一、概述

最近在研究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,如下图所示:
image.png

  • 探针收集数据并重新格式化以符合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 上报数据的原理如下图所示:
image.png

二、使用 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,可以看...
image.png

三、手动将 spring boot 接入 skywalking

1、下载 skywalking agent

skywalking 官网下载地址: http://skywalking.apache.org/...
image.png
image.png

我这里下载的是 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

解压后的目录结构如下图:
image.png
agent目录的说明如下图:
image.png

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
请将<skywalking-agent-path>替换为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 中进行如下配置:
image.png

配置完成后,启动项目可以看到如下信息打印到控制台:
image.png

查看skywalking 控制台,并没有数据,因为需要先访问接口,才会上报数据到控制台,通过不断的调用测试接口,再次查看控制台可以看到我们的调用情况,如下图所示:
image.png

四、使用 docker 部署 spring boot 并接入 skywalking

这里 spring boot 的基础镜像选择 skywalking-base,此镜像中包含 openjdk11skywalking-agent,详细的信息可以参考下面的参考文档。
image.png

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] 推荐:

docker容器部署Spring Boot项目及更新

- - 编程语言 - ITeye博客
Docker这项容器技术已经是十分的火热了,读者要是不了解docker的话可以吧docker先理解为虚拟机. 我们的Springboot最终是要部署在Linux上的,docker作为Linux轻量级的实现. docker也是可以用来部署Springboot应用的. 1.创建Dockerfile . 创建一个文件名为Dockerfile的文件,复制以下内容到文件中.

使用 docker 部署 spring boot 并接入 skywalking

- - SegmentFault 最新的文章
最近在研究skywalking,打算使用k8s部署 skywalking 并将 pod 中的应用接入 skywalking 进行服务链路追踪. 这篇文章先不介绍 skywalking 在k8s中的部署和使用,而是先介绍如何使用手动和docker的方式使用 skywalking. 在整个实践过程中查阅了大量文档,遇到了各种问题,这里将我自己的实践过程记录下来,希望对有同样需求的小伙伴提供一些帮助.

Spring boot传统部署

- - 企业架构 - ITeye博客
使用spring boot很方便,一个jar包就可以启动了,因为它里面内嵌了tomcat等服务器. 但是spring boot也提供了部署到独立服务器的方法. 如果你看文档的话,从jar转换为war包很简单,pom.xml的配置修改略去不讲. 只看source的修改,很简单,只要一个配置类,继承自SpringBootServletInitializer, 并覆盖configure方法.

值得使用的Spring Boot

- - ImportNew
2013年12月12日,Spring发布了4.0版本. 这个本来只是作为Java平台上的控制反转容器的库,经过将近10年的发展已经成为了一个巨无霸产品. 不过其依靠良好的分层设计,每个功能模块都能保持较好的独立性,是Java平台不可多得的好用的开源应用程序框架. Spring的4.0版本可以说是一个重大的更新,其全面支持Java8,并且对Groovy语言也有良好的支持.

Spring Boot配置多个DataSource

- - 廖雪峰的官方网站
使用Spring Boot时,默认情况下,配置 DataSource非常容易. Spring Boot会自动为我们配置好一个 DataSource. 如果在 application.yml中指定了 spring.datasource的相关配置,Spring Boot就会使用该配置创建一个 DataSource.

Spring boot executable jar/war 原理

- - ImportNew
spring boot里其实不仅可以直接以 Java -jar demo.jar的方式启动,还可以把jar/war变为一个可以执行的脚本来启动,比如./demo.jar. 把这个executable jar/war 链接到/etc/init.d下面,还可以变为Linux下的一个service. 只要在spring boot maven plugin里配置:.

Spring Boot Starter是什么?

- - 技术,永无止境
在工作中我们经常能看到各种各样的springboot starter,如spring-cloud-netflix、spring-cloud-alibaba等等. 这些starter究竟有什么作用呢. 在了解这些starter之前,我们需要先大概知道Spring MVC与Spring Boot的关系.

spring boot与spring batch、postgres及elasticsearch整合

- - 互联网 - ITeye博客
当系统有大量数据需要从数据库导入elasticsearch时,使用sping batch可以提高导入的效率. 这篇文章使用spring batch将数据从postgres导入elasticsearch. 本文使用spring data jest连接ES(也可以使用spring data elasticsearch连接ES),ES版本为5.5.3.

Spring Boot使用redis做数据缓存

- - ITeye博客
SysUser.class)); //请注意这里. 3 redis服务器配置. /** *此处的dao操作使用的是spring data jpa,使用@Cacheable可以在任意方法上,*比如@Service或者@Controller的方法上 */ public interface SysUserRepo1 extends CustomRepository {.

spring boot应用启动原理分析

- - ImportNew
在spring boot里,很吸引人的一个特性是可以直接把应用打包成为一个jar/war,然后这个jar/war是可以直接启动的,不需要另外配置一个Web Server. 如果之前没有使用过spring boot可以通过下面的demo来感受下. 下面以这个工程为例,演示如何启动Spring boot项目:.