开发者学堂课程【分布式链路追踪 Skywalking:Agent 的使用-Spring Boot】学习笔记,与课程紧密连接,让用户快速学习知识。
课程地址:https://developer.aliyun.com/learning/course/743/detail/13157
Agent 的使用-Spring Boot
内容介绍:
一、Window 下 Tomcat7和8中使用 Agent
二、Spring Boot 中使用 Agent
一、Window 下 Tomcat7和8中使用 Agent
在 window 中使用 Agent 和在 Linux 下使用的方式类似,但是需要修改的文件从原来的 catalina.sh 变成了 catalina.bat,因为 bat 是在 window下 使用的,所以需要将第一行修改为 bat 能识别的一串代码:set "CATALINA_OPTS=-javaagent:/path/to/skywalking-agent/skywalking-agent.jar",在 set "CATALINA_OPTS 后加上 javaagent 的使用方式,用 -javaagent 指向 javaagent 的目录以及它的架包。也就是说,skywalking 在 window 下的使用和在 Linux 下使用的方式其实是一样的。,只不过在语法方面需要修改为 bat。
二、Spring Boot 中使用 Agent
1. Skywalking 与Spring Boot 集成
下面学习 Skywalking 如何与Spring Boot 做集成,来监控 Spring Boot 中接口的调用
(1)处理工作
如图:
现在处于一个 agent 的目录下,而这个目录当前实际上是被 Tomcat 使用的。
将 agent 拷贝一份,如图:
将其改为 agent_boot,然后进入 agent_boot 这个目录下。
这里需要修改的依旧是 config 目录,如图:
进入 config 目录,找到配置文件进行修改,如图:
将 agent.service_name 这句话的服务名改为 skywalking_boot,这样用于做一个服务的区别,即可以分出到底是 Tomcat 发布还是 spring_boot 发布的。此时,在 agentboot 下已经修改完配置文件,也就是说现在有两个 agent 可以使用,一个是 Tomcat 进行使用的,一个是 spring_boot 使用的。这样的方式看似很麻烦,但是设想如果将来应用上线,一般情况下一个虚拟仪只会放一个应用,为了避免过多的应用产生资源的争抢,这个时候就可以在虚拟仪上只放置一份 agent 。不过如果只是演示,就需要在一台虚拟机上启用多个应用,因此会认为这种方式麻烦。这个问题也可以用插件的方式解决。
(2)上传应用
将 skywalking_springboot 应用上传到虚拟机中,同时启动。
以下是 springboot 的一部分代码:
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.10.RELEASE</version>
<relativePath/><!--Lookup parent from repository-->
</parent>
<groupId>com.itcast</groupId>
<artifactId>skywalking_springboot<artifactId>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
在 pom 中,已经引入了 springboot 相关的依赖,这个依赖使用的版本号是2.1.10 ,而且使用了 spring-boot-starer-web 进行 springmvc 的一个集成。
还提供了一个 controller,
如以下代码:
RestController
public class MyController{
//正常访问接口
@RequestMapping("/sayBoot")
public String sayBoot() {return "Hello Boot!"; }
//异常访问接口
@RequestMapping("/exception")
public String exception(){
int i =1/0;
return "Hello Boot!";
这个 controller 有两个接口,一个叫 sayboot,它是一个正常访问的接口;一个叫 exception,是一个异常访问的接口,这个接口是通过1/0的方式来抛出一个除0异常。
如图,把 springboot 工程上传到虚拟机中:
使用工具进行上传,上传后即可通过启动 springboot 来进行验证。
(3)启动 Springboot
在启动前需要注意,正常启动前的应用不会和 skywalking 做集成,所以需要通过启动命令中添加探针的方式来进行启动,这个方式和之前使用 Tomcat 的方式是类似的
如下代码:
java -javaagentl/usr/local/skywalking/apache-skywalking-apm-bin/agent_boot/skywalking-agent.jar -Dserver.port=8082 -jarskywalking_springboot.jar &
在命令中加上 -javaagent 参数来指定 javaagent 的一个位置。
如图:
进行启动,首先把目录切换到 usr/local/skywalking 下,
如图:
可以看到,Springboot 已经上传成功。
在这个目录下,可以通过 java 加上参数 javaagent 来启动,
此时如果拷贝错误,需要手动输入,然后找到 skywalking.jar ,在加上参数之后指定启动的端口,也就是 Dserver.port=8082,然后再通过 /jar 命令找到架包并且用&进行后端的启动。
此时虽然在控制端还是打出了启动执行命令,但是它并不是在前端进行启动而是通过后台进行启动,所以即便把控制台进行退出也不会影响到系统运行。此时,应用启动成功。
(4)访问
如图:
在浏览器进行应用的访问。将端口改为8082,应用名不需要加,
然后看到它的一个接口 sayboot,来进行验证。
如果返回了 helloboot,就说明是一个正常访问。
然后再访问后面的异常接口,如图:
如图,这里前端报错,报的是/ by zero,也就是除0错误,抛出一个除0异常同时标记成500,这说明这是一个异常访问。
(5)查看 skywalking 信息
在 skywalking 中查看是否有上述记录,如图:
如图,这里有两条访问记录,在 skywalking_boot 下的依次是 exception 和 sayboot这两个接口。
然后在追踪中详细查看信息,
如图,exception 已经标红,证明它是一次失败的调用,它的持续时间是359毫秒。而 sayboot 是一次正常的调用,所以是蓝色的,持续时间是296毫秒。
在服务上找到 springboot 的服务,同时它的实例在141上,进程 ID 是10986,证明这个应用和这个实例已经被我们监控起来了。
如图,查看拓扑图:
可以看到,现在 User 一方面调用了skywalking_boot,一方面又调用了 sky walking_tomcat,而这两个本质上都是 springmvc 的项目,springboot 实际上是通过 web 端进行访问,也是基于 mvc 。至此,springboot 已经和 skywalking 完成了集成。
其实启动的方式大致相同,只是 springboot 的启动需要在 java 后 加上 javaagent 这个参数来指定一个 agent 探针。