Java在线诊断工具Arthas快速入门与使用

比眉伴天荒 2023-10-11 19:31 38阅读 0赞

## 场景 ##

### Arthas ###

Arthas 是一款线上监控诊断产品，通过全局视角实时查看应用 load、内存、gc、线程的状态信息，

并能在不修改应用代码的情况下，对业务问题进行诊断，包括查看方法调用的出入参、异常，监测方法执行耗时，

类加载信息等，大大提升线上问题排查效率。

### Arthas(阿尔萨斯)能做什么 ###

当你遇到以下类似问题而束手无策时，Arthas可以帮助你解决：

1、这个类从哪个 jar 包加载的？为什么会报各种类相关的 Exception？

2、我改的代码为什么没有执行到？难道是我没 commit？分支搞错了？

3、遇到问题无法在线上 debug，难道只能通过加日志再重新发布吗？

4、线上遇到某个用户的数据处理有问题，但线上同样无法 debug，线下无法重现！

5、是否有一个全局视角来查看系统的运行状况？

6、有什么办法可以监控到 JVM 的实时运行状态？

7、怎么快速定位应用的热点，生成火焰图？

8、怎样直接从 JVM 内查找某个类的实例？

Arthas 支持 JDK 6+，支持 Linux/Mac/Windows，采用命令行交互模式，同时提供丰富的 Tab 自动补全功能，进一步方便进行问题的定位和诊断。

Github:

[GitHub - alibaba/arthas: Alibaba Java Diagnostic Tool Arthas/Alibaba Java诊断利器Arthas][GitHub - alibaba_arthas_ Alibaba Java Diagnostic Tool Arthas_Alibaba Java_Arthas]

Gitee:

[arthas][]

![801771d8871046cda3d3bb598cab85c4.jpeg][]

快速入门文档地址:

[简介 | arthas][_ arthas]

注：

博客：  
[霸道流氓气质的博客\_CSDN博客-C\#,架构之路,SpringBoot领域博主][CSDN_-C_SpringBoot]  
关注公众号  
霸道的程序猿  
获取编程相关电子书、教程推送与免费下载。

## 实现 ##

1、需要事前启动一个jar包

这里可以直接下载官方示例jar包

curl -O https://arthas.aliyun.com/math-game.jar
    
    java -jar math-game.jar

math-game是一个简单的程序，每隔一秒生成一个随机数，再执行质因数分解，并打印出分解结果。

mate-game源码地址:

[arthas/MathGame.java at master · alibaba/arthas · GitHub][arthas_MathGame.java at master _ alibaba_arthas _ GitHub]

2、下载并启动arthas

curl -O https://arthas.aliyun.com/arthas-boot.jar
    
    java -jar arthas-boot.jar

也可直接在浏览器中访问地址下载或其他途径下载，最终将jar包下载下来即可。

![26aa4145490b4055914043e77c453ca2.jpeg][]

3、启动之后可以显示当前所有的java进程

这里math-game是第二个，所以输入2并回车

![dc4429da1edf4a03b89ac6d44a4f17e4.jpeg][]

3、查看dashboard

输入dashboard后，按回车，会展示当前进程的信息。

按ctrl+c可以中断执行。

![262827cfcf154e87aef08773751b7e78.jpeg][]

4、通过thread命令获取math-game的Main Class

thread 1 | grep 'main('

thread 1会打印线程ID为1的栈，通常是main函数的进程。

通过jad来反编译Main Class

jad demo.MathGame

![8914574a0bb5472288d128db165e20e2.jpeg][]

5、通过watch命令可以查看某个函数的返回值

比如查看上面源码中primeFactors的函数返回值

watch demo.MathGame primeFactors returnObj

![f4187dc757ad405da57146291b8df018.jpeg][]

6、其他命令

jvm相关

dashboard - 当前系统的实时数据面板  
getstatic - 查看类的静态属性  
heapdump - dump java heap, 类似 jmap 命令的 heap dump 功能  
jvm - 查看当前 JVM 的信息  
logger - 查看和修改 logger  
mbean - 查看 Mbean 的信息  
memory - 查看 JVM 的内存信息  
ognl - 执行 ognl 表达式  
perfcounter - 查看当前 JVM 的 Perf Counter 信息  
sysenv - 查看 JVM 的环境变量  
sysprop - 查看和修改 JVM 的系统属性  
thread - 查看当前 JVM 的线程堆栈信息  
vmoption - 查看和修改 JVM 里诊断相关的 option  
vmtool - 从 jvm 里查询对象，执行 forceGc

class/classloader相关

classloader - 查看 classloader 的继承树，urls，类加载信息，使用 classloader 去 getResource  
dump - dump 已加载类的 byte code 到特定目录  
jad - 反编译指定已加载类的源码  
mc - 内存编译器，内存编译.java文件为.class文件  
redefine - 加载外部的.class文件，redefine 到 JVM 里  
retransform - 加载外部的.class文件，retransform 到 JVM 里  
sc - 查看 JVM 已加载的类信息  
sm - 查看已加载类的方法信息

monotor/watch/trace相关

monitor - 方法执行监控  
stack - 输出当前方法被调用的调用路径  
trace - 方法内部调用路径，并输出方法路径上的每个节点上耗时  
tt - 方法执行数据的时空隧道，记录下指定方法每次调用的入参和返回信息，并能对这些不同的时间下调用进行观测  
watch - 方法执行数据观测

profiler/火焰图

profiler - 使用async-profiler对应用采样，生成火焰图  
jfr - 动态开启关闭 JFR 记录

鉴权

auth - 鉴权

options

options - 查看或设置 Arthas 全局开关

管道

Arthas 支持使用管道对上述命令的结果进行进一步的处理，如sm java.lang.String \* | grep 'index'

grep - 搜索满足条件的结果  
plaintext - 将命令的结果去除 ANSI 颜色  
wc - 按行统计输出结果

后台异步任务

当线上出现偶发的问题，比如需要 watch 某个条件，而这个条件一天可能才会出现一次时，异步后台任务就派上用场了

使用 > 将结果重写向到日志文件，使用 & 指定命令是后台运行，session 断开不影响任务执行（生命周期默认为 1 天）  
jobs - 列出所有 job  
kill - 强制终止任务  
fg - 将暂停的任务拉到前台执行  
bg - 将暂停的任务放到后台执行

基础命令

base64 - base64 编码转换，和 linux 里的 base64 命令类似  
cat - 打印文件内容，和 linux 里的 cat 命令类似  
cls - 清空当前屏幕区域  
echo - 打印参数，和 linux 里的 echo 命令类似  
grep - 匹配查找，和 linux 里的 grep 命令类似  
help - 查看命令帮助信息  
history - 打印命令历史  
keymap - Arthas 快捷键列表及自定义快捷键  
pwd - 返回当前的工作目录，和 linux 命令类似  
quit - 退出当前 Arthas 客户端，其他 Arthas 客户端不受影响  
reset - 重置增强类，将被 Arthas 增强过的类全部还原，Arthas 服务端关闭时会重置所有增强过的类  
session - 查看当前会话的信息  
stop - 关闭 Arthas 服务端，所有 Arthas 客户端全部退出  
tee - 复制标准输入到标准输出和指定的文件，和 linux 里的 tee 命令类似  
version - 输出当前目标 Java 进程所加载的 Arthas 版本号

具体命令使用可参考官方文档:

[命令列表 | arthas][_ arthas 1]

7、退出

如果只是退出当前的连接，可以用quit或者exit命令。Attach 到目标进程上的 arthas 还会继续运行，端口会保持开放，下次连接时可以直接连接上。

如果想完全退出 arthas，可以执行stop命令

![a3f25ddba8dc47b5bd290ca54588566c.jpeg][]

8、其他使用方式web控制台、api等具体使用参考官方文档

![7b7dae1dcf174af495893e317dbfbe82.jpeg][]

9、其他资料汇总

[Java在线诊断工具Arthas相关教程资料汇总.rar-Java文档类资源-CSDN下载][Java_Arthas_.rar-Java_-CSDN]

[GitHub - alibaba_arthas_ Alibaba Java Diagnostic Tool Arthas_Alibaba Java_Arthas]: https://github.com/alibaba/arthas
[arthas]: http://arthas.gitee.io/
[801771d8871046cda3d3bb598cab85c4.jpeg]: https://img-blog.csdnimg.cn/801771d8871046cda3d3bb598cab85c4.jpeg
[_ arthas]: https://arthas.gitee.io/doc/
[CSDN_-C_SpringBoot]: https://blog.csdn.net/badao_liumang_qizhi
[arthas_MathGame.java at master _ alibaba_arthas _ GitHub]: https://github.com/alibaba/arthas/blob/master/math-game/src/main/java/demo/MathGame.java
[26aa4145490b4055914043e77c453ca2.jpeg]: https://img-blog.csdnimg.cn/26aa4145490b4055914043e77c453ca2.jpeg
[dc4429da1edf4a03b89ac6d44a4f17e4.jpeg]: https://img-blog.csdnimg.cn/dc4429da1edf4a03b89ac6d44a4f17e4.jpeg
[262827cfcf154e87aef08773751b7e78.jpeg]: https://img-blog.csdnimg.cn/262827cfcf154e87aef08773751b7e78.jpeg
[8914574a0bb5472288d128db165e20e2.jpeg]: https://img-blog.csdnimg.cn/8914574a0bb5472288d128db165e20e2.jpeg
[f4187dc757ad405da57146291b8df018.jpeg]: https://img-blog.csdnimg.cn/f4187dc757ad405da57146291b8df018.jpeg
[_ arthas 1]: https://arthas.gitee.io/doc/commands.html
[a3f25ddba8dc47b5bd290ca54588566c.jpeg]: https://img-blog.csdnimg.cn/a3f25ddba8dc47b5bd290ca54588566c.jpeg
[7b7dae1dcf174af495893e317dbfbe82.jpeg]: https://img-blog.csdnimg.cn/7b7dae1dcf174af495893e317dbfbe82.jpeg
[Java_Arthas_.rar-Java_-CSDN]: https://download.csdn.net/download/BADAO_LIUMANG_QIZHI/86823061