共计 3750 个字符,预计需要花费 10 分钟才能阅读完成。
一、概述
最近在钻研 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 利用数据