Arthas 是Alibaba開源的Java診斷工具，深受開發(fā)者喜愛。當(dāng)你遇到以下類似問題而束手無策時，Arthas可以幫助你解決：

1.這個類從哪個 jar 包加載的？為什么會報各種類相關(guān)的 Exception？

2.我改的代碼為什么沒有執(zhí)行到？難道是我沒 commit？分支搞錯了？

3.遇到問題無法在線上 debug，難道只能通過加日志再重新發(fā)布嗎？

4.線上遇到某個用戶的數(shù)據(jù)處理有問題，但線上同樣無法 debug，線下無法重現(xiàn)！

5.是否有一個全局視角來查看系統(tǒng)的運行狀況？

6.有什么辦法可以監(jiān)控到JVM的實時運行狀態(tài)？

7.怎么快速定位應(yīng)用的熱點，生成火焰圖？

Arthas支持JDK 6+，支持Linux/Mac/Windows，采用命令行交互模式，同時提供豐富的 Tab 自動補(bǔ)全功能，進(jìn)一步方便進(jìn)行問題的定位和診斷。

一、快速安裝

使用`arthas-boot`（推薦）

下載arthas-boot.jar，然后用java -jar的方式啟動：

curl -O https://alibaba.github.io/arthas/arthas-boot.jar

java -jar arthas-boot.jar

打印幫助信息：

java -jar arthas-boot.jar -h

如果下載速度比較慢，可以使用aliyun的鏡像：

java -jar arthas-boot.jar --repo-mirror aliyun --use-http

如果從github下載有問題，可以使用gitee鏡像

 curl -O https://arthas.gitee.io/arthas-boot.jar

二、下載

從Maven倉庫下載

如果下載速度比較慢，可以嘗試用阿里云的鏡像倉庫，比如要下載3.x.x版本（替換3.x.x為最新版本），下載的url是：

https://maven.aliyun.com/repository/public/com/taobao/arthas/arthas-packaging/3.x.x/arthas-packaging-3.x.x-bin.zip

從Github Releases頁下載

https://github.com/alibaba/arthas/releases

用as.sh啟動

解壓后，在文件夾里有as.sh，直接用./as.sh的方式啟動：

./as.sh

打印幫助信息：

./as.sh -h

用arthas-boot啟動

或者在解壓后，在文件夾里有arthas-boot.jar，直接用java -jar的方式啟動：

java -jar arthas-boot.jar

打印幫助信息：

java -jar arthas-boot.jar -h

三、快速入門

1. 啟動Demo

curl -O https://alibaba.github.io/arthas/arthas-demo.jar

java -jar arthas-demo.jar

arthas-demo是一個簡單的程序，每隔一秒生成一個隨機(jī)數(shù)，再執(zhí)行質(zhì)因數(shù)分解，并打印出分解結(jié)果。

arthas-demo源代碼：查看

2. 啟動arthas

在命令行下面執(zhí)行（使用和目標(biāo)進(jìn)程一致的用戶啟動，否則可能attach失敗）：

curl -O https://alibaba.github.io/arthas/arthas-boot.jar

java -jar arthas-boot.jar

• 執(zhí)行該程序的用戶需要和目標(biāo)進(jìn)程具有相同的權(quán)限。比如以admin用戶來執(zhí)行：sudo su admin && java -jar arthas-boot.jar 或 sudo -u admin -EH java -jar arthas-boot.jar。

• 如果attach不上目標(biāo)進(jìn)程，可以查看~/logs/arthas/ 目錄下的日志。

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

• java -jar arthas-boot.jar -h 打印更多參數(shù)信息。

選擇應(yīng)用java進(jìn)程：

$ $ java -jar arthas-boot.jar

* [1]: 35542

  [2]: 71560 arthas-demo.jar

Demo進(jìn)程是第2個，則輸入2，再輸入回車/enter。Arthas會attach到目標(biāo)進(jìn)程上，并輸出日志：

[INFO] Try to attach process 71560

[INFO] Attach process 71560 success.

[INFO] arthas-client connect 127.0.0.1 3658

  ,---.  ,------. ,--------.,--.  ,--.  ,---.   ,---.

 /  O  \ |  .--. ''--.  .--'|  '--'  | /  O  \ '   .-'

|  .-.  ||  '--'.'   |  |   |  .--.  ||  .-.  |`.  `-.

|  | |  ||  |\  \    |  |   |  |  |  ||  | |  |.-'    |

`--' `--'`--' '--'   `--'   `--'  `--'`--' `--'`-----'

wiki: https://alibaba.github.io/arthas

version: 3.0.5.20181127201536

pid: 71560

time: 2018-11-28 19:16:24

$

3. 查看dashboard

輸入dashboard，按回車/enter，會展示當(dāng)前進(jìn)程的信息，按ctrl+c可以中斷執(zhí)行。

$ dashboard

ID     NAME                   GROUP          PRIORI STATE  %CPU    TIME   INTERRU DAEMON

17     pool-2-thread-1        system         5      WAITIN 67      0:0    false   false

27     Timer-for-arthas-dashb system         10     RUNNAB 32      0:0    false   true

11     AsyncAppender-Worker-a system         9      WAITIN 0       0:0    false   true

9      Attach Listener        system         9      RUNNAB 0       0:0    false   true

3      Finalizer              system         8      WAITIN 0       0:0    false   true

2      Reference Handler      system         10     WAITIN 0       0:0    false   true

4      Signal Dispatcher      system         9      RUNNAB 0       0:0    false   true

26     as-command-execute-dae system         10     TIMED_ 0       0:0    false   true

13     job-timeout            system         9      TIMED_ 0       0:0    false   true

1      main                   main           5      TIMED_ 0       0:0    false   false

14     nioEventLoopGroup-2-1  system         10     RUNNAB 0       0:0    false   false

18     nioEventLoopGroup-2-2  system         10     RUNNAB 0       0:0    false   false

23     nioEventLoopGroup-2-3  system         10     RUNNAB 0       0:0    false   false

15     nioEventLoopGroup-3-1  system         10     RUNNAB 0       0:0    false   false

Memory             used   total max    usage GC

heap               32M    155M  1820M  1.77% gc.ps_scavenge.count  4

ps_eden_space      14M    65M   672M   2.21% gc.ps_scavenge.time(m 166

ps_survivor_space  4M     5M    5M           s)

ps_old_gen         12M    85M   1365M  0.91% gc.ps_marksweep.count 0

nonheap            20M    23M   -1           gc.ps_marksweep.time( 0

code_cache         3M     5M    240M   1.32% ms)

Runtime

os.name                Mac OS X

os.version             10.13.4

java.version           1.8.0_162

java.home              /Library/Java/JavaVir

                       tualMachines/jdk1.8.0

                       _162.jdk/Contents/Hom

                       e/jre

4. 通過thread命令來獲取到`arthas-demo`進(jìn)程的Main Class

thread 1會打印線程ID 1的棧，通常是main函數(shù)的線程。

$ thread 1 | grep 'main('

    at demo.MathGame.main(MathGame.java:17)

5. 通過jad來反編譯Main Class

$ jad demo.MathGame

ClassLoader:

+-sun.misc.Launcher$AppClassLoader@3d4eac69

  +-sun.misc.Launcher$ExtClassLoader@66350f69

Location:

/tmp/arthas-demo.jar

/*

 * Decompiled with CFR 0_132.

 */

package demo;

import java.io.PrintStream;

import java.util.ArrayList;

import java.util.Iterator;

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 static void main(String[] args) throws InterruptedException {

        MathGame game = new MathGame();

        do {

            game.run();

            TimeUnit.SECONDS.sleep(1L);

        } while (true);

    }

    public void run() throws InterruptedException {

        try {

            int number = random.nextInt();

            List<Integer> primeFactors = this.primeFactors(number);

            MathGame.print(number, primeFactors);

        }

        catch (Exception e) {

            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 + "=");

        Iterator<Integer> iterator = primeFactors.iterator();

        while (iterator.hasNext()) {

            int factor = iterator.next();

            sb.append(factor).append('*');

        }

        if (sb.charAt(sb.length() - 1) == '*') {

            sb.deleteCharAt(sb.length() - 1);

        }

        System.out.println(sb);

    }

    public List<Integer> primeFactors(int number) {

        if (number < 2) {

            ++this.illegalArgumentCount;

            throw new IllegalArgumentException("number is: " + number + ", need >= 2");

        }

        ArrayList<Integer> result = new ArrayList<Integer>();

        int i = 2;

        while (i <= number) {

            if (number % i == 0) {

                result.add(i);

                number /= i;

                i = 2;

                continue;

            }

            ++i;

        }

        return result;

    }

}

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

6. watch

通過watch命令來查看demo.MathGame#primeFactors函數(shù)的返回值：

$ watch demo.MathGame primeFactors returnObj

Press Ctrl+C to abort.

Affect(class-cnt:1 , method-cnt:1) cost in 107 ms.

ts=2018-11-28 19:22:30; [cost=1.715367ms] result=null

ts=2018-11-28 19:22:31; [cost=0.185203ms] result=null

ts=2018-11-28 19:22:32; [cost=19.012416ms] result=@ArrayList[

    @Integer[5],

    @Integer[47],

    @Integer[2675531],

]

ts=2018-11-28 19:22:33; [cost=0.311395ms] result=@ArrayList[

    @Integer[2],

    @Integer[5],

    @Integer[317],

    @Integer[503],

    @Integer[887],

]

ts=2018-11-28 19:22:34; [cost=10.136007ms] result=@ArrayList[

    @Integer[2],

    @Integer[2],

    @Integer[3],

    @Integer[3],

    @Integer[31],

    @Integer[717593],

]

ts=2018-11-28 19:22:35; [cost=29.969732ms] result=@ArrayList[

    @Integer[5],

    @Integer[29],

    @Integer[7651739],

]

更多的功能可以查看進(jìn)階使用。

7. 退出arthas

如果只是退出當(dāng)前的連接，可以用quit或者exit命令。Attach到目標(biāo)進(jìn)程上的arthas還會繼續(xù)運行，端口會保持開放，下次連接時可以直接連接上。

如果想完全退出arthas，可以執(zhí)行stop命令。

4、項目地址

github地址：https://github.com/alibaba/arthas