Alibaba開源的Java診斷工具Arthas（阿爾薩斯） 安裝文檔

Arthas 是Alibaba開源的Java診斷工具，深受開發者喜好。

當你遇到如下相似問題而一籌莫展時，Arthas能夠幫助你解決：

1. 這個類從哪一個 jar 包加載的？爲何會報各類類相關的 Exception？
2. 我改的代碼爲何沒有執行到？難道是我沒 commit？分支搞錯了？
3. 遇到問題沒法在線上 debug，難道只能經過加日誌再從新發布嗎？
4. 線上遇到某個用戶的數據處理有問題，但線上一樣沒法 debug，線下沒法重現！
5. 是否有一個全局視角來查看系統的運行情況？
6. 有什麼辦法能夠監控到JVM的實時運行狀態？

Arthas採用命令行交互模式，同時提供豐富的 Tab 自動補全功能，進一步方便進行問題的定位和診斷。

官網連接：https://alibaba.github.io/arthas/   ps詳細的命令以及說明能夠去官網查看。

1：安裝環境 jdk1.8+,ubuntu 14.04, ubuntu要有telnet unzip等基本經常使用工具。

2：官網提供兩種安裝方式 

        自動安裝：

                Linux/Unix/Mac

                Arthas 支持在 Linux/Unix/Mac 等平臺上一鍵安裝，請複製如下內容，並粘貼到命令行中，敲 回車 執行便可：

           curl -L https://alibaba.github.io/arthas/install.sh | sh

                 我最開始使用自動安裝遇到一個問題 ：Unable to access jarfile /root/.arthas/lib/3.0.4/arthas/arthas-core.jar

                 發現這個arthas-core.jar 一直下載不下來，後來換成手動安裝方式。

        手動安裝：

                Linux/Unix/Mac

                    1:獲取安裝包

                    wget https://maven.aliyun.com/repository/public/com/taobao/arthas/arthas-packaging/3.0.4/arthas-packaging-3.0.4-bin.zip 

                    2:解壓安裝包

                        unzip arthas-packaging-3.0.4-bin.zip

                    3：安裝

                        ./install-local.sh

                    4:運行

                        ./as.sh

                        官網提供的手動安裝 版本的as.sh腳本運行時報錯，後來我先自動安裝了一下，拿到自動安裝的as.sh腳本，替換了手動的as.sh

快速入門

1. 啓動Demo

import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicInteger;
public class Demo {
    static class Counter {
        private static AtomicInteger count = new AtomicInteger(0);
        public static void increment() {
            count.incrementAndGet();
        }
        public static int value() {
            return count.get();
        }
    }

    public static void main(String[] args) throws InterruptedException {
        while (true) {
            Counter.increment();
            System.out.println("counter: " + Counter.value());
            TimeUnit.SECONDS.sleep(1);
        }
    }
}

把上面的內容保存到Demo.java裏，而後在命令行下編繹啓動：

javac Demo.java
java Demo

也能夠把代碼保存到IDE裏，而後啓動。

2. 啓動arthas

Linux/Unix/Mac

在命令行下面執行：

./as.sh

執行該腳本的用戶須要和目標進程具備相同的權限。好比以admin用戶來執行： sudo su admin && ./as.sh 或 sudo -u admin -EH ./as.sh。 詳細的啓動腳本說明，請參考這裏。 若是attatch不上目標進程，能夠查看~/logs/arthas/ 目錄下的日誌。

選擇應用java進程：

$ ./as.sh
Arthas script version: 3.0.2
Found existing java process, please choose one and hit RETURN.
* [1]: 95428 
  [2]: 22647 org.jetbrains.jps.cmdline.Launcher
  [3]: 21736
  [4]: 13560 Demo

Demo進程是第4個，則輸入4，再輸入回車/enter。Arthas會attach到目標進程上，並輸出日誌：

Connecting to arthas server... current timestamp is 1536656867
Trying 127.0.0.1...
Connected to 127.0.0.1.
Escape character is '^]'.
  ,---.  ,------. ,--------.,--.  ,--.  ,---.   ,---.
 /  O  \ |  .--. ''--.  .--'|  '--'  | /  O  \ '   .-'
|  .-.  ||  '--'.'   |  |   |  .--.  ||  .-.  |`.  `-.
|  | |  ||  |\  \    |  |   |  |  |  ||  | |  |.-'    |
`--' `--'`--' '--'   `--'   `--'  `--'`--' `--'`-----'

wiki: https://alibaba.github.io/arthas
version: 3.0.1-RC-SNAPSHOT
pid: 13560
timestamp: 1536656867894

Windows

打開Dos命令行窗口，在解壓的arthas目錄下執行as.bat pid。

3. 查看dashboard

輸入dashboard，按enter/回車，會展現當前進程的信息，按ctrl+c能夠中斷執行。

$ 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. watch

經過watch命令來查看Counter.value()函數的返回值：

$ watch Demo$Counter value returnObj
Press Ctrl+C to abort.
Affect(class-cnt:1 , method-cnt:1) cost in 29 ms.
ts=2018-09-10 17:53:11;result=@Integer[621]
ts=2018-09-10 17:53:12;result=@Integer[622]
ts=2018-09-10 17:53:13;result=@Integer[623]
ts=2018-09-10 17:53:14;result=@Integer[624]
ts=2018-09-10 17:53:15;result=@Integer[625]

更多的功能能夠查看進階使用。

5. 退出arthas

若是隻是退出當前的鏈接，能夠用quit或者exit命令。Attach到目標進程上的arthas還會繼續運行，端口會保持開放，下次鏈接時能夠直接鏈接上。

若是想徹底退出arthas，能夠執行shutdown命令。