自带IDEA插件的阿里开源诊断神器Arthas线上项目BUG调试

2022-11-13 10:11:37 阿里神器线上

前言

记得之前写过一篇Arthas使用教程，通过使用Arthas我们既可以实现线上调试，还可以实现热修复。最近逛了下Arthas的官网，发现它已经支持直接集成到springBoot应用中去，并且还出了专用的IDEA插件。今天我们再来体验下它，看看它的功能是不是更强大了！

SpringBoot实战电商项目mall（50k+star）地址：https://GitHub.com/Macrozheng/mall

Arthas简介

Arthas是Alibaba开源的Java诊断利器，深受开发者喜爱，目前在github上已有29K+Star。它采用命令行交互模式，同时提供丰富的 Tab 自动补全功能，进一步方便进行问题的定位和诊断。

ArthasTunnel

为了演示一个更加真实的线上环境，接下来我们将对Docker容器中的SpringBoot应用进行诊断。我们将使用ArthasTunnel来实现，ArthasTunnel相当于一个WEB控制台，使用它我们无需进入应用容器即可对应用进行诊断，非常方便。

首先我们需要下载ArthasTunnel的安装包，下载地址：

Https://github.com/alibaba/arthas/releases

由于官方只提供了jar包，如果你想通过Docker方式启动的话，可以自行打包Docker镜像，打包使用的Dockerfile脚本如下：

# 该镜像需要依赖的基础镜像
FROM java:8
# 将当前目录下的jar包复制到docker容器的/目录下
ADD arthas-tunnel-server.jar /arthas-tunnel-server.jar
# 声明服务运行的端口
EXPOSE 8080 7777
# 指定docker容器启动时运行jar包
ENTRYPOINT ["java", "-jar","/arthas-tunnel-server.jar"]
# 指定维护者的名字
MaiNTAINER macro

这里再提供一个一键打包运行ArthasTunnel容器的执行脚本run.sh，脚本内容如下；

#!/usr/bin/env bash
# 定义应用组名
group_name='mall-tiny'
# 定义应用名称
app_name='arthas-tunnel-server'
# 定义应用版本
app_version='1.0-SNAPSHOT'
echo '----copy jar----'
docker stop ${app_name}
echo '----stop container----'
docker rm ${app_name}
echo '----rm container----'
docker rmi ${group_name}/${app_name}:${app_version}
echo '----rm image----'
# 打包编译docker镜像
docker build -t ${group_name}/${app_name}:${app_version} .
echo '----build image----'
docker run -p 8080:8080 -p 7777:7777 --name ${app_name} \
-e TZ="Asia/Shanghai" \
-v /etc/localtime:/etc/localtime \
-v /mydata/app/${app_name}/logs:/var/logs \
-d ${group_name}/${app_name}:${app_version}
echo '----start container----'

接下来吧ArthasTunnel的JAR包、Dockerfile文件、执行脚本run.sh上传到linux服务器上，然后使用./run.sh命令运行即可；

运行成功后，可以直接访问ArthasTunnel的Web控制台，访问地址：http://192.168.3.105:8080

SpringBoot集成

在SpringBoot应用中直接集成Arthas并使用，无疑是最方便的，接下来我们将采用此种方法。

首先在项目的pom.xml中添加如下依赖，可以对比下Arthas使用教程中的使用方法，直接集成确实简单不少；

<!--集成Java诊断利器Arthas-->
<dependency>
    <groupId>com.taobao.arthas</groupId>
    <artifactId>arthas-spring-boot-starter</artifactId>
    <version>3.6.1</version>
</dependency>

然后修改配置文件application.yml，记住这个agent-id，ArthasTunnel连接需要使用，由于我们将会把应用容器通过--link的方式连接到ArthasTunnel容器，这里的tunnel-server按下面进行配置；

management:
  endpoints:
    web:
      exposure:
        # 暴露端点`/actuator/arthas`
        include: 'arthas'
arthas:
  agent-id: mall-tiny-arthas
  tunnel-server: ws://arthas-tunnel-server:7777/ws

接下来通过之前的Dockerfile和run.sh打包应用，run.sh与之前对比，只多了一行通过--link连接到ArthasTunnel容器的命令；