一、什么是Arthas(阿尔萨斯)
Arthas 是Alibaba开源的Java诊断工具,它能帮你解决以下问题:
- 这个类从哪个 jar 包加载的?为什么会报各种类相关的 Exception?
- 我改的代码为什么没有执行到?难道是我没 commit?分支搞错了?
- 遇到问题无法在线上 debug,难道只能通过加日志再重新发布吗?
- 线上遇到某个用户的数据处理有问题,但线上同样无法 debug,线下无法重现! 是否有一个全局视角来查看系统的运行状况?
- 有什么办法可以监控到JVM的实时运行状态?
二、linux安装
虽然Arthas也有Windows版本的,但是服务一般都是放在linux服务器上,所以主要记录下linux版本的安装。
下载arthas-boot.jar
,然后用java -jar
的方式启动:
- wget https://alibaba.github.io/arthas/arthas-boot.jar
- java -jar arthas-boot.jar
完成安装。就是这么简单。
三、启动并执行结果日志保存
arthas日志输出是默认关闭的,需要主动开启,开启步骤(前提需要启动Arthas)
options save-result true
如图所示,表示已开启。日志的路径一般都
root/logs/arthas-cache/result.log
如果不在这个路径下,可以通过find命令查找,命令如下
find . -name "arthas-cache"
之所需要打开保存日志,一方面是线上请求众多,控制台日志一下子就会跳过去,不容易捕获、另一方面,有可能入参的内容庞大,控制台无法完整显示。
四、快速使用
快速使用,使用idea开发工具打开对应的线上项目,然后下载一个插件,叫 arthas idea
点击安装。
安装完成后,选择你需要监控的对象类,鼠标放到上面去,右键可以看到,根据不同选择会自动生成命令,点击后会自动放到你的剪切板。如图所示
五、命令说明
5.1 dashboard
仪表盘显示当前进程相关信息
注意:dashboard务必指定执行次数(-n
),否则会导致批处理脚本无法终止
dashboard -n 1
点击查看大图,各个字段的说明
5.2 jad 命令
通过jad命令获取反编译代码,选中你需要反编译的代码(Decompile Class Jad),用插件生成命令如下
jad --source-only com.taopanfeng.feigndemoa8001.FeignConfiguration
5.3 watch命令
通过watch命令可查看运行时入参、返回值以及报错等,选中你需要watch的代码,用插件生成命令如下
watch com.bosssoft.xxx.saas.secret.xxx.xxxx.xxxx.xxx.HttpUtils sendPost '{params,returnObj,throwExp}' -n 5 -x 3
参数含义
-n 5 表示监听5次,-x 3 表示参数控制返回值的展开层数
params 入参,returnObj 返回值,throwExp 报错对象
对应代码内容
5.4 tt 命令
通过tt命令可实现重放请求,选中你需要TimeTunnel Tt的代码,用插件生成命令如下
监控请求方法
tt -t com.taopanfeng.feigndemoa8001.FeignConfiguration getSSLSocketFactory -n 5
然后调用该请求,可以看到捕获到的请求信息
找到请求对应的index
,本例中为1000
,然后执行命令重放请求
tt --play -i 1000
5.5 trace命令
trace命令渲染和统计整个调用链路上的所有性能开销和追踪调用链路,很方便的定位性能瓶颈,选中你需要trace的代码,用插件生成命令如下
trace com.bosssoft.nontax3.saas.secret.inter.service.jit.utils.HttpUtils sendPost -n 5 --skipJDKMethod false
相关链接
GitHub地址: https://github.com/alibaba/arthas
Arthas用户文档:Arthas 用户文档 — Arthas 3.6.2 文档