常用命令
help 查看帮助 help COMMAND 查看指定命令的详细帮助 COMMAND -h 查看指定命令的详细帮助 double tab 查看支持的所有命令 dashboard 查看线程JVM信息仪表盘 thread 查看所有线程 thread 51 查看指定线程堆栈 thread -n 5 查看前5个线程堆栈 thread -n -1 查看所有线程堆栈 thread -b 查看阻塞线程 thread -i 2000 在计算CPU使用率时指定采样间隔(2秒后输出结果) jad javax.servlet.Servlet 对jvm已加载的类进行反编译 >>> java -jar cfr-0.148.jar /tmp/TestClass.class 可以反编译class文件,org.benf:cfr0.148 <<< mc -c ClassLoaderHash /tmp/Test.java 编译java文件 <<< 有依赖关系的单个java文件用javac编译是肯定不行的。内存编译器mc则可以,但也有可能会个别代码编译失败 <<< sc javax.servlet.Servlet 查找jvm已加载的类 sc -d javax.servlet.Servlet 查找jvm已加载的类,打印详细 stack com.TestClass testMethod 查看方法的调用堆栈,重新触发后打印 trace com.TestClass testMethod 查看方法的子调用方法的耗时 monitor -c 3 com.TestClass testMethod 监控方法的调用次数,成功率等信息,每隔3秒输出一次。 classloader 查看类加载器数量,以及每个加载器加载的类数量 【ognl】 执行表达式 ognl '@java.lang.System@out.println("hello")' 调用静态方法 ognl '#str=new String("hello"), #str.length()' 这样都行 ognl '#value1=@System@getProperty("java.home"), #value2=@System@getProperty("java.runtime.name"), {#value1, #value2}' 执行多个表达式,并赋值给临时变量 【redefine + sc + jad】 实现不重启加载class redefine 加载外部的.class文件,redefine jvm已加载的类 redefine -c ClassLoaderHash /tmp/TestClass.class 将修改后编译出来的class文件放到指定目录,并redefine >>> 其中ClassLoaderHash为该类的类加载器HashCode,可通过"sc com.TestClass -d"查询 必须指定ClassLoaderHash,否则修改不生效。redefine后可以使用jad反编译查看修改。 注意:redefine后的原来的类不能恢复,可以redefine原始的class文件来还原 限制:1. 不允许新增加field/method 2. 修改正在跑的函数,没有退出不能生效 <<< 【watch】 观察方法的执行,有点像在方法中打断点debug。用法同tt中的-w,相当于实时的tt watch 类 方法 观察表达式 条件表达式 用法 watch com.TestClass testMethod returnObj 观察方法的执行,包括观察当前对象、传入参数、返回值、抛出的异常等等 watch com.TestClass testMethod "@java.lang.Thread@currentThread().getName()" 调用静态方法 watch com.TestClass testMethod target 观察当前对象 watch com.TestClass testMethod 'new String("hello")' 像极了debug模式的表达式 watch com.TestClass testMethod {params[0],returnObj} -e 观察方法执行的第一个入参合和返回值,仅当方法抛出异常时才打印 >>> https://github.com/alibaba/arthas/issues/71 表达式用法说明 https://alibaba.github.io/arthas/advice-class.html 表达式变量说明, 如target、params、returnObj等变量 方法重载问题:使用条件表达式(stack,trace等作用于方法的命令也都适用) 1. 指定参数长度 watch com.TestClass testMethod params[0] params.length==2 2. 指定某参数类型 watch com.TestClass testMethod params[0] 'params[1] instanceof String' <<< 【tt】 记录方法调用的时间片信息 tt -t com.TestClass testMethod 开始记录 tt -l 查看历史记录 tt -i ID 查看某个时间片信息(含参数值) tt -i ID -w params[0] 查看时间片方法的第一个参数的值,-w用法同watch命令 tt -i ID -w params[0].length() 查看时间片方法的第一个参数的值,支持对象访问 tt -i ID -w {params[0],param[1]} 查看时间片方法的多个参数的值 >>> spring mvc应用 拦截RequestMappingHandlerAdapter这个调用,获取到spring context为所欲为 tt -t org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter invokeHandlerMethod tt -i invokeHandlerMethodID -w 'target.getApplicationContext().getBean("helloWorldService")' <<<
使用/安装指南【下载工具】
https://alibaba.github.io/arthas/arthas-boot.jar 或 https://alibaba.github.io/arthas/install.sh(sh install.sh下载启动脚本as.sh) 【使用条件】 环境需要安装java 依赖jdk/lib/tools.jar 如果只有jre,可拷贝jdk的tools.jar到jre/lib/下 as.sh需要telnet命令,若无telnet可使用arthas-boot.jar方式 【启动工具】 java -jar arthas-boot.jar 或 sh as.sh 第一次启动会下载arthas-3.1.4-bin.zip到/root/.arthas/lib/3.1.4/arthas下并解压。 每次启动会检测是否有java进程,然后输入数字选择需要诊断的进程。(PS:工具检测进程的原理$JAVA_HOME/bin/jps -l -v) sh as.sh --repo-mirror aliyun //如果下载速度比较慢,可以使用aliyun的镜像 sh as.sh --target-ip 192.168.1.9 //指定telnet监听IP sh as.sh -h //查看更多启动配置 sh as.sh PID //指定进程诊断 linux-8ku8:/opt/arthas # sh as.sh Arthas script version: 3.1.4 [INFO] JAVA_HOME: /opt/jdk1.8.0_74 [INFO] Process 10528 already using port 3658 [INFO] Process 10528 already using port 8563 Found existing java process, please choose one and hit RETURN. * [1]: 10528 org.apache.catalina.startup.Bootstrap 【默认自动下载目录】 linux-8ku8:~/.arthas/lib/3.1.4/arthas # ls -lh total 22M -rw-r--r-- 1 root root 11M Jun 22 16:13 arthas-3.1.4-bin.zip -rw-r--r-- 1 root root 8.2K Sep 25 2019 arthas-agent.jar -rw-r--r-- 1 root root 109K Sep 25 2019 arthas-boot.jar -rw-r--r-- 1 root root 394K Sep 25 2019 arthas-client.jar -rw-r--r-- 1 root root 11M Sep 25 2019 arthas-core.jar -rw-r--r-- 1 root root 3.7K Sep 25 2019 arthas-demo.jar -rw-r--r-- 1 root root 2.9K Sep 25 2019 arthas-spy.jar -rwxr-xr-x 1 root root 7.6K Sep 25 2019 as-service.bat -rwxr-xr-x 1 root root 3.1K Sep 25 2019 as.bat -rwxr-xr-x 1 root root 28K Sep 25 2019 as.sh -rwxr-xr-x 1 root root 635 Sep 25 2019 install-local.sh 【启动成功】 linux-8ku8:/opt/arthas # sh as.sh ........ ,---. ,------. ,--------.,--. ,--. ,---. ,---. / O | .--. ''--. .--'| '--' | / O ' .-' | .-. || '--'.' | | | .--. || .-. |`. `-. | | | || | | | | | | || | | |.-' | `--' `--'`--' '--' `--' `--' `--'`--' `--'`-----' ........ [arthas@10528]$ help //查看帮助;double tab查看支持的所有命令;help COMMAND查看指定命令的详细帮助 [arthas@10528]$ exit //断开连接,工具还在运行。重新执行as.sh可再次进入,或者telnet 127.0.0.1 3658也可再次重连(后者连接速度超快) [arthas@10528]$ shutdown 或 stop //关闭工具 【离线安装】 将arthas-3.1.4-bin.zip解压到/root/.arthas/lib/3.1.4/arthas/目录下 非root用户解压到/home/$USER/.arthas/lib/3.1.4/arthas/目录下,注意修改文件的用户属组 然后启动即可,不同用户下执行as.sh,会调用各自用户家目录下的arthas
只要创建了ARTHAS_HOME目录,即/home/$USER/.arthas/lib/$USER_VERSION/arthas,启动as.sh时就不会联网下载包,之后把包解压进去即可。
快捷安装:解压arthas-3.1.4-bin.zip后执行install-local.sh即可。原理上面的一样,自动创建ARTHAS_HOME目录并拷贝包进去。
ARTHAS_HOME目录也可以是自定义的路径,sh as.sh --arthas-home <value> 使用指定的ARTHAS_HOME目录执行
【Arthas用户文档】 https://github.com/alibaba/arthas/blob/master/README_CN.md https://alibaba.github.io/arthas/dashboard