Arthas Install — Arthas 3.5.4 文档Arthas Install — Arthas 3.5.4 文档
今天是1024程序员节。昨天研究了下arthas整理一下笔记
常用命令
watch watch — Arthas 3.5.4 文档
同时观察方法调用前和方法返回后 $ watch demo.MathGame primeFactors "{params,target,returnObj}" -x 2 -b -s -n 2
观察异常信息的例子 $ watch demo.MathGame primeFactors "{params[0],throwExp}" -e -x 2
观察方法入参和出参 "{params,returnObj}" -x 2 -b -s"{params,returnObj}" -x 2 -b -s 常用表达式 观察入参出参和异常 "{params,returnObj,throwExp}" -x 2 -b -s -e
watch 的参数比较多,主要是因为它能在 4 个不同的场景观察对象
参数名称 |
参数说明 |
class-pattern |
类名表达式匹配 |
method-pattern |
方法名表达式匹配 |
express |
观察表达式,默认值:{params, target, returnObj} |
condition-express |
条件表达式 |
[b] |
在方法调用之前观察 before |
[e] |
在方法异常之后观察 |
[s] |
在方法返回之后观察 |
[f] |
在方法结束之后(正常返回和异常返回)观察 |
[E] |
开启正则表达式匹配,默认为通配符匹配 |
[x:] |
指定输出结果的属性遍历深度,默认为 1 |
这里重点要说明的是观察表达式,观察表达式的构成主要由 ognl 表达式组成,所以你可以这样写"{params,returnObj}",只要是一个合法的 ognl 表达式,都能被正常支持。
观察的维度也比较多,主要体现在参数 advice 的数据结构上。Advice 参数最主要是封装了通知节点的所有信息。请参考表达式核心变量中关于该节点的描述。
特别说明:
- watch 命令定义了4个观察事件点,即 -b 方法调用前,-e 方法异常后,-s 方法返回后,-f 方法结束后
- 4个观察事件点 -b、-e、-s 默认关闭,-f 默认打开,当指定观察点被打开后,在相应事件点会对观察表达式进行求值并输出
- 这里要注意方法入参和方法出参的区别,有可能在中间被修改导致前后不一致,除了 -b 事件点 params 代表方法入参外,其余事件都代表方法出参
- 当使用 -b 时,由于观察事件点是在方法调用前,此时返回值或异常均不存在
- 在watch命令的结果里,会打印出location信息。location有三种可能值:AtEnter,AtExit,AtExceptionExit。对应函数入口,函数正常return,函数抛出异常。
tt 命令
com.mb.wife.controller.HiController#hi
INDEX TIMESTAMP COST(ms) IS-RET IS-EXP OBJECT CLASS METHOD
-----------------------------------------------------------------------------------------------------------------------
1000 2021-10-23 22:14:27 0.4527 true false 0x6fd97fd1 HiController hi
1001 2021-10-23 22:14:38 0.157701 true false 0x6fd97fd1 HiController hi
1002 2021-10-23 22:14:44 0.9488 true false 0x6fd97fd1 HiController hi
查看详情
tt -i 1000
重放 重做一次调用 这是一个很赞的功能!
tt -i 1000 -p
在线调试地址
当在本地启动时,可以访问 http://127.0.0.1:8563/ ,通过浏览器来使用Arthas。
reset
Arthas在 watch/trace 等命令时,实际上是修改了应用的字节码,插入增强的代码。显式执行 reset 命令,可以清除掉这些增强代码。
退出Arthas
用 exit 或者 quit 命令可以退出Arthas。
退出Arthas之后,还可以再次用 java -jar arthas-boot.jar 来连接。
彻底退出Arthas
exit/quit命令只是退出当前session,arthas server还在目标进程中运行。
想完全退出Arthas,可以执行 stop 命令。