Java 诊断利器Arthas：快速入门

简介

    Arthas 是Alibaba开源的Java诊断工具，深受开发者喜爱。在线排查问题，无需重启；动态跟踪Java代码；实时监控JVM状态。

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

快速入门

1. 启动一个java 项目（如果只是测试可以使用阿里提供的测试应用）

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

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

2. 启动arthas

     在命令行下面执行（使用和目标进程一致的用户启动，否则可能attach失败）： 

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

• 执行该程序的用户需要和目标进程具有相同的权限。比如以admin用户来执行：sudo su admin && java -jar arthas-boot.jar 或 sudo -u admin -EH java -jar arthas-boot.jar。

• 如果attach不上目标进程，可以查看~/logs/arthas/ 目录下的日志。

• 如果下载速度比较慢，可以使用aliyun的镜像：java -jar arthas-boot.jar --repo-mirror aliyun --use-http

• java -jar arthas-boot.jar -h 打印更多参数信息。

   选择应用java进程：

$ $ java -jar arthas-boot.jar
* [1]: 1284 math-game.jar

math-game进程是第1个，则输入1，再输入回车/enter。Arthas会attach到目标进程上，并输出日志：

3. 查看dashboard

        输入dashboard，按回车/enter，会展示当前进程的信息，按ctrl+c可以中断执行。

 4. 通过thread命令来获取到math-game进程的Main Class

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

$ thread 1 | grep 'main('
    at demo.MathGame.main(MathGame.java:17)

5. 通过jad来反编译Main Class

[arthas@1284]$ jad demo.MathGame

ClassLoader:                                                                                                       
+-sun.misc.Launcher$AppClassLoader@1b6d3586                                                                        
  +-sun.misc.Launcher$ExtClassLoader@2f810d51                                                                      

Location:                                                                                                          
/home/shell/math-game.jar                                                                                          

       /*
        * Decompiled with CFR.
        */
       package demo;
       
       import java.util.ArrayList;
       import java.util.List;
       import java.util.Random;
       import java.util.concurrent.TimeUnit;
       
       public class MathGame {
           private static Random random = new Random();
           private int illegalArgumentCount = 0;
       
           public List<Integer> primeFactors(int number) {
/*44*/         if (number < 2) {
/*45*/             ++this.illegalArgumentCount;
                   throw new IllegalArgumentException("number is: " + number + ", need >= 2");
               }
               ArrayList<Integer> result = new ArrayList<Integer>();
/*50*/         int i = 2;
/*51*/         while (i <= number) {
/*52*/             if (number % i == 0) {
/*53*/                 result.add(i);
/*54*/                 number /= i;
/*55*/                 i = 2;
                       continue;
                   }
/*57*/             ++i;
               }
/*61*/         return result;
           }
       
           public static void main(String[] args) throws InterruptedException {
               MathGame game = new MathGame();
               while (true) {
/*16*/             game.run();
/*17*/             TimeUnit.SECONDS.sleep(1L);
               }
           }
       
           public void run() throws InterruptedException {
               try {
/*23*/             int number = random.nextInt() / 10000;
/*24*/             List<Integer> primeFactors = this.primeFactors(number);
/*25*/             MathGame.print(number, primeFactors);
               }
               catch (Exception e) {
/*28*/             System.out.println(String.format("illegalArgumentCount:%3d, ", this.illegalArgumentCount) + e.getMessage());
               }
           }
       
           public static void print(int number, List<Integer> primeFactors) {
               StringBuffer sb = new StringBuffer(number + "=");
/*34*/         for (int factor : primeFactors) {
/*35*/             sb.append(factor).append('*');
               }
/*37*/         if (sb.charAt(sb.length() - 1) == '*') {
/*38*/             sb.deleteCharAt(sb.length() - 1);
               }
/*40*/         System.out.println(sb);
           }
       }

Affect(row-cnt:1) cost in 1303 ms.

6. watch

        通过watch命令来查看demo.MathGame#primeFactors函数的返回值：

[arthas@1284]$ watch demo.MathGame primeFactors returnObj
Press Q or Ctrl+C to abort.
Affect(class count: 1 , method count: 1) cost in 181 ms, listenerId: 1
method=demo.MathGame.primeFactors location=AtExit
ts=2021-12-10 16:38:18; [cost=1.467531ms] result=@ArrayList[
    @Integer[41521],
]
method=demo.MathGame.primeFactors location=AtExceptionExit
ts=2021-12-10 16:38:19; [cost=0.125017ms] result=null
method=demo.MathGame.primeFactors location=AtExceptionExit
ts=2021-12-10 16:38:20; [cost=0.037231ms] result=null
method=demo.MathGame.primeFactors location=AtExit
ts=2021-12-10 16:38:21; [cost=0.09885ms] result=@ArrayList[
    @Integer[3],
    @Integer[13],
    @Integer[4919],
]
method=demo.MathGame.primeFactors location=AtExit
ts=2021-12-10 16:38:22; [cost=0.042784ms] result=@ArrayList[
    @Integer[2],
    @Integer[19],
    @Integer[727],
]

7. 退出arthas

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

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