Arthas使用方法

傷城~ 2023-01-11 03:51 201阅读 0赞

## 1、简介 ##

Arthas 是Alibaba开源的Java诊断工具。安装在系统所在服务器。可以帮助开发人员或者运维人员查找问题，分析性能，bug追踪。

下载路径：[https://arthas.aliyun.com/arthas-boot.jar][https_arthas.aliyun.com_arthas-boot.jar]

## 2、工具使用 ##

### 2.1 启动 ###

$ java -jar arthas-boot.jar
    * [1]: 35542
      [2]: 71560 arthas-demo.jar

Demo进程是第2个，则输入2，再输入`回车/enter`。Arthas会attach到目标进程上，并输出日志：

[INFO] Try to attach process 71560
    [INFO] Attach process 71560 success.
    [INFO] arthas-client connect 127.0.0.1 3658
      ,---.  ,------. ,--------.,--.  ,--.  ,---.   ,---.
     /  O  \ |  .--. ''--.  .--'|  '--'  | /  O  \ '   .-'
    |  .-.  ||  '--'.'   |  |   |  .--.  ||  .-.  |`.  `-.
    |  | |  ||  |\  \    |  |   |  |  |  ||  | |  |.-'    |
    `--' `--'`--' '--'   `--'   `--'  `--'`--' `--'`-----'
     
    wiki: https://arthas.aliyun.com/doc
    version: 3.0.5.20181127201536
    pid: 71560
    time: 2021-01-28 19:16:24
    
    $

至此，启动完成。后续操作可在此基础上实现相应功能。

### 2.2 线上反编译代码 ###

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

### 2.3 dashboard查看jvm详情 ###

输入[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

### 2.4 线上调试，查看函数返回值-watch ###

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

$ 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],
    ]

### 完整的查看线上函数调用入参出参异常的命令： ###

# watch com.test.global.integration.service.idempotentCache getIdemponetResult -x 5 "{params,returnObj,throwExp}"

### 2.5 方法调用路径耗时解析 ###

方法内部调用路径，并输出方法路径上的每个节点上耗时。

$ trace cn.asae.e.contract.web.ContractController getContract -j
    
    ###########################################################################
    -j 过滤掉jdk方法
    __________________________________________________________________________________________________________________________________________________________________
    |      时间戳                  线程名称                           线程id 是否守护进程    优先级      线程上下文类加载器                                                  
    |  `---ts=2019-10-21 16:33:13;thread_name=http-nio-37080-exec-5;id=52;is_daemon=true;priority=5;TCCL=org.apache.catalina.loader.WebappClassLoader@67fff846       |
    |           调用信息 - 方法拦截器 - 目标方法
    |      `---[1483.931493ms] cn.asae.e.contract.web.ContractController$$EnhancerBySpringCGLIB$$feabdb7f:getContract()                                              |
    |          `---[1483.715988ms] org.springframework.cglib.proxy.MethodInterceptor:intercept() #0                                                                  |
    |              `---[1482.519392ms] cn.asae.e.contract.web.ContractController:getContract()                                                                       |
    |                  +---[0.03355ms] cn.asae.core.common.response.v2.ResponseBodyV2:<init>() #243                                                                  |
    |                  +---[0.016195ms] cn.asae.core.common.token.TokenCache:getInstance() #246                                                                      |
    |                  +---[0.01442ms] cn.asae.core.common.token.TokenCache:get() #246                                                                               |
    |                  +---[0.02442ms] cn.asae.e.common.model.Op:createOp() #246                                                                                     |
    |                  +---[161.579687ms] cn.asae.e.contract.service.ContractService:getContract() #249                                                              |
    |                  +---[164.980125ms] cn.asae.e.contract.service.ContractService:getContractOcrs() #251                                                          |
    |                  +---[0.036474ms] com.google.common.collect.Maps:newHashMap() #255                                                                             |
    |                  +---[158.223852ms] cn.asae.e.contract.service.ContractService:getContractMembers() #260                                                       |
    |                  +---[0.025848ms] com.google.common.collect.Lists:newArrayList() #263                                                                          |
    |                  +---[0.024837ms] cn.asae.e.contract.model.ContractVO:getContractNum() #264                                                                    |
    |                  +---[160.942618ms] cn.asae.e.contract.service.ContractService:getContracts() #266                                                             |
    |                  +---[0.024172ms] org.apache.commons.collections.MapUtils:isNotEmpty() #271                                                                    |
    |                  +---[198.281335ms] cn.asae.e.organization.service.AccountService:getAccountLite() #291                                                        |
    |                  +---[159.761087ms] cn.asae.e.organization.service.DepartmentService:getDepartment() #295                                                      |
    |                  +---[0.009013ms] org.apache.commons.collections.MapUtils:isNotEmpty() #297                                                                    |
    |                  +---[0.013967ms] cn.asae.e.contract.model.ContractVO:getSignId() #312                                                                         |
    |                  +---[0.006482ms] com.google.common.collect.Lists:newArrayList() #312                                                                          |
    |                  +---[160.503511ms] cn.asae.e.organization.service.AccountService:getAccountLite() #312                                                        |
    |                  +---[0.015528ms] cn.asae.e.contract.model.ContractVO:getDepartmentId() #316                                                                   |
    |                  +---[0.006504ms] com.google.common.collect.Lists:newArrayList() #316                                                                          |
    |                  +---[159.023976ms] cn.asae.e.organization.service.DepartmentService:getDepartment() #316                                                      |
    |                  +---[0.005827ms] cn.asae.e.contract.model.ContractVO:getSignId() #319                                                                         |
    |                  +---[0.017222ms] cn.asae.e.organization.model.Account:<init>() #319                                                                           |
    |                  +---[0.0142ms] cn.asae.e.organization.model.Account:getFullname() #319                                                                        |
    |                  +---[0.012931ms] cn.asae.e.contract.model.ContractVO:setSignName() #319                                                                       |
    |                  +---[0.00492ms] cn.asae.e.contract.model.ContractVO:getDepartmentId() #321                                                                    |
    |                  +---[0.010856ms] cn.asae.e.organization.model.DepartmentVO:<init>() #321                                                                      |
    |                  +---[0.018637ms] cn.asae.e.organization.model.DepartmentVO:getName() #323                                                                     |
    |                  +---[0.011019ms] cn.asae.e.contract.model.ContractVO:setDepartmentName() #323                                                                 |
    |                  +---[0.010145ms] cn.asae.e.organization.model.DepartmentVO:getOrganizationName() #324                                                         |
    |                  +---[0.010541ms] cn.asae.e.contract.model.ContractVO:setOrganizationName() #324                                                               |
    |                  +---[0.005493ms] com.google.common.collect.Maps:newHashMap() #326                                                                             |
    |                  +---[0.014093ms] cn.asae.core.common.response.v2.ResponseBodyV2:init() #333                                                                   |
    |                  +---[145.783843ms] cn.asae.e.contract.service.ContractService:addContractLog() #335                                                           |
    |                  `---[0.386367ms] cn.asae.core.common.response.v2.ResponseBodyV2:toResponse() #342                                                             |

### 2.6 退出 ###

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

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

参考文档：

[https://arthas.aliyun.com/doc/arthas-tutorials.html?language=cn][https_arthas.aliyun.com_doc_arthas-tutorials.html_language_cn]

[https://www.jianshu.com/p/95449939cca3][https_www.jianshu.com_p_95449939cca3]

[https_arthas.aliyun.com_arthas-boot.jar]: https://arthas.aliyun.com/arthas-boot.jar
[dashboard]: https://arthas.aliyun.com/doc/dashboard.html
[watch]: https://arthas.aliyun.com/doc/watch.html
[https_arthas.aliyun.com_doc_arthas-tutorials.html_language_cn]: https://arthas.aliyun.com/doc/arthas-tutorials.html?language=cn
[https_www.jianshu.com_p_95449939cca3]: https://www.jianshu.com/p/95449939cca3