乐趣区

关于java:使用-docker-部署-spring-boot-并接入-skywalking

jiezi

一、概述

最近在钻研 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/…

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

请将 <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 中进行如下配置：

配置实现后，启动我的项目能够看到如下信息打印到控制台：

查看 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 利用数据

退出移动版