一、下载测试程序和Arthas工具
1.首先下载并启动Arthas官方提供给我们的测试程序
curl -O https://arthas.aliyun.com/math-game.jar
java -jar math-game.jar
2.另外再启动一个shell窗口下载并启动arthas工具
curl -O https://arthas.aliyun.com/arthas-boot.jar
java -jar arthas-boot.jar
3.输入“1”选择我们的测试程序
完成以上操作后,接下来就可以来尝试使用arthas提供的命令了!
二、基础命令
1.dashboard
作用:查看当前应用进程的实时数据面板
数据说明:
ID: Java 级别的线程 ID,注意这个 ID 不能跟 jstack 中的 nativeID 一一对应。
NAME: 线程名
GROUP: 线程组名
PRIORITY: 线程优先级, 1~10 之间的数字,越大表示优先级越高
STATE: 线程的状态
CPU%: 线程的 cpu 使用率。比如采样间隔 1000ms,某个线程的增量 cpu 时间为 100ms,则 cpu 使用率=100/1000=10%
DELTA_TIME: 上次采样之后线程运行增量 CPU 时间,数据格式为秒
TIME: 线程运行总 CPU 时间,数据格式为分:秒
INTERRUPTED: 线程当前的中断位状态
DAEMON: 是否是 daemon 线程
JVM 内部线程
2.jvm
作用:查看当前 JVM 的信息
参数说明:
THREAD 相关
COUNT: JVM 当前活跃的线程数
DAEMON-COUNT: JVM 当前活跃的守护线程数
PEAK-COUNT: 从 JVM 启动开始曾经活着的最大线程数
STARTED-COUNT: 从 JVM 启动开始总共启动过的线程次数
DEADLOCK-COUNT: JVM 当前死锁的线程数
文件描述符相关
MAX-FILE-DESCRIPTOR-COUNT:JVM 进程最大可以打开的文件描述符数
OPEN-FILE-DESCRIPTOR-COUNT:JVM 当前打开的文件描述符数
3.memory
作用:查看 JVM 的内存信息
4.sysenv
作用:查看当前 JVM 的环境变量
查看所有环境变量:
查看指定的环境变量:
5.sysprop
作用:查看和修改 JVM 的系统属性
查看当前JVM的所有属性
查看指定的属性:
设置属性:
6.vmoption
作用:查看和修改 JVM 里诊断相关的选项
查看所有的JVM诊断相关的选项:
查看指定的选项:
修改指定的选项:
7.thread
作用:查看当前 JVM 的线程堆栈信息
查看最忙的前3个线程:
查看指定的线程:
找出当前阻塞其他线程的线程:
注意:目前只支持找出 synchronized 关键字阻塞住的线程, 如果是java.util.concurrent.Lock, 目前还不支持。
8.help
作用:查看当前 arthas 版本支持的指令
9.命令 -h
作用:查看指定命令的用法
10.history
作用:查看历史执行过的命令
11.session
作用:查看当前会话的信息,显示当前绑定的 pid 以及会话 id。
12.version
作用:查看当前目标 Java 进程所加载的 Arthas 版本号。
13.quit
作用:退出当前 Arthas 客户端,其他 Arthas 客户端不受影响。等同于exit、logout、q三个指令。
14.reset
作用:重置增强类,还原被 Arthas 增强过的类。
重置指定的被 Arthas 增强过的类:
重置所有被 Arthas 增强过的类:
15.stop
作用:关闭 Arthas 服务端,所有 Arthas 客户端全部退出。
注意:关闭 Arthas 服务器之前,会重置掉所有做过的增强类。但是用 redefine 重加载的类内容不会被重置。
三、进阶命令
1.heapdump
作用:生成内存快照,排查内存泄漏时很有用。
2.jad
作用:反编译Java类。
反编译指定的Java类:
反编译指定Java类并只显示源码:
反编译Java类的指定方法:
3.sc
作用:搜索出所有已经加载到 JVM 中的 Class 信息。
查看指定的JVM已加载类的详细信息:
模糊搜索JVM已加载的类:
查看指定类的成员变量信息:
4.sm
作用:查看已加载类的方法信息。
查看指定类的方法:
查看指定类的方法详细信息:
5.mc
作用:编译.java文件生成.class。
编译指定的Java文件并指定class文件存放路径:
指定classLoaderHash编译Java文件:
指定classloader全限定名编译Java文件:
6.redefine
作用:加载外部的.class文件,热部署到JVM中,可以用来热修复Bug。
举个栗子:
有以下代码:
当访问/user/0时会抛异常:
然而我不想看到这个异常,那么我们可以:
①先反编译这个Java类文件输出为Java文件:
②找到这个类的ClassLoader,后续操作需要用到:
③另外打开一个新的shell窗口,修改源代码:
④使用前面我们已经查询到该类的classLoaderHash对修改后的Java文件进行编译:
⑤使用redefine命令将编译生成的class文件加载到JVM中:
⑥再次访问/user/0,查看热部署后的效果:
至此,说明我们修改的代码已经成功热更新到JVM中了。
最后,注意redefine的限制:
- 不允许新增加 field/method
- 正在跑的函数,没有退出不能生效,比如下面新增加的System.out.println,只有run()函数里的会生效
public class MathGame {
public static void main(String[] args) throws InterruptedException {
MathGame game = new MathGame();
while (true) {
game.run();
TimeUnit.SECONDS.sleep(1);
// 这个不生效,因为代码一直跑在 while里
System.out.println("in loop");
}
}
public void run() throws InterruptedException {
// 这个生效,因为run()函数每次都可以完整结束
System.out.println("call run()");
try {
int number = random.nextInt();
List<Integer> primeFactors = primeFactors(number);
print(number, primeFactors);
} catch (Exception e) {
System.out.println(String.format("illegalArgumentCount:%3d, ", illegalArgumentCount) + e.getMessage());
}
}
}
7.stack
作用:查看指定方法的调用路径。
8.trace
作用:查看方法内部调用路径,并输出方法路径上的每个节点上耗时。
指定指定捕捉结果的次数:
9.tt
作用:记录下指定方法每次调用的入参和返回信息
记录3次findUserById方法调用的入参和返回信息:
查看已记录的调用记录:
查看指定的调用记录:
10.watch
作用:观察方法调用时的参数、this 对象和返回值。
-x:指定输出结果的属性遍历深度,默认为 1,最大值是 4。
11.monitor
作用:监控方法执行结果。
-c: 统计周期,默认值为 120 秒。
更多命令和详细内容见Arthas的官方文档:
https://arthas.aliyun.com/doc/