阿里内部的那个牛逼带闪电的Java诊断工具终于开源了

在阿里巴巴内部,有很多自研工具供开发者使用,其中有一款工具,是几乎每个Java开发都使用过的工具,那就是Arthas,这是一款Java诊断工具,是一款牛逼带闪电的工具。该工具已于2018年9月份开源。

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

用户文档:https://alibaba.github.io/arthas/

在日常开发中,你是否遇到过以下问题:

这个类从哪个 jar 包加载的?为什么会报各种类相关的 Exception?

我改的代码为什么没有执行到?难道是我没 commit?分支搞错了?

遇到问题无法在线上 debug,难道只能通过加日志再重新发布吗?

线上遇到某个用户的数据处理有问题,但线上同样无法 debug,线下无法重现!

是否有一个全局视角来查看系统的运行状况?

有什么办法可以监控到JVM的实时运行状态?

以上问题,通通可以通过Arthas来进行问题诊断!!!是不是很好很强大。

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

Arthas安装

1、使用arthas-boot安装

下载arthas-boot.jar,然后用java -jar的方式启动:

wget 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

2、使用as.sh安装

Arthas 支持在 Linux/Unix/Mac 等平台上一键安装,请复制以下内容,并粘贴到命令行中,敲 回车 执行即可:

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

上述命令会下载启动脚本文件 as.sh 到当前目录,你可以放在任何地方或将其加入到 $PATH 中。

直接在shell下面执行./as.sh,就会进入交互界面。

也可以执行./as.sh -h来获取更多参数信息。

快速入门

1. 启动Demo

wget https://alibaba.github.io/arthas/arthas-demo.jar

java -jar arthas-demo.jar

arthas-demo是一个简单的程序,每隔一秒生成一个随机数,再执行质因式分解,并打印出分解结果。

2. 启动arthas

在命令行下面执行:

wget https://alibaba.github.io/arthas/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。

如果attatch不上目标进程,可以查看~/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]: 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://alibaba.github.io/arthas

version: 3.0.5.20181127201536

pid: 71560

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

$

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 Dispatchersystem  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  32M155M1820M1.77% gc.ps_scavenge.count4

ps_eden_space14M65M 672M 2.21% gc.ps_scavenge.time(m 166

ps_survivor_space4M 5M5M           s)

ps_old_gen 12M85M 1365M0.91% gc.ps_marksweep.count 0

nonheap20M23M -1 gc.ps_marksweep.time( 0

code_cache 3M 5M240M 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. 通过sysenv命令来获取到进程的Main Class

$ sysenv | grep MAIN

JAVA_MAIN_CLASS_71560              demo.MathGame

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 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 primeFactors) {

StringBuffer sb = new StringBuffer("" + number + "=");

Iterator 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 primeFactors(int number) {

if (number < 2) {

++this.illegalArgumentCount;

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

}

ArrayList result = new ArrayList();

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函数的返回值:

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

]

5. 退出arthas

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

如果想完全退出arthas,可以执行shutdown命令。

常用命令

基础命令

help——查看命令帮助信息

cls——清空当前屏幕区域

session——查看当前会话的信息

reset——重置增强类,将被 Arthas 增强过的类全部还原,Arthas 服务端关闭时会重置所有增强过的类

version——输出当前目标 Java 进程所加载的 Arthas 版本号

quit——退出当前 Arthas 客户端,其他 Arthas 客户端不受影响

shutdown——关闭 Arthas 服务端,所有 Arthas 客户端全部退出

keymap——Arthas快捷键列表及自定义快捷键


 jvm相关

dashboard——当前系统的实时数据面板

thread——查看当前 JVM 的线程堆栈信息

jvm——查看当前 JVM 的信息

sysprop——查看和修改JVM的系统属性

New! getstatic——查看类的静态属性

class/classloader相关

sc——查看JVM已加载的类信息

sm——查看已加载类的方法信息

dump——dump 已加载类的 byte code 到特定目录

redefine——加载外部的.class文件,redefine到JVM里

jad——反编译指定已加载类的源码

classloader——查看classloader的继承树,urls,类加载信息,使用classloader去getResource

monitor/watch/trace相关

monitor——方法执行监控

watch——方法执行数据观测

trace——方法内部调用路径,并输出方法路径上的每个节点上耗时

stack——输出当前方法被调用的调用路径

tt——方法执行数据的时空隧道,记录下指定方法每次调用的入参和返回信息,并能对这些不同的时间下调用进行观测

请注意,这些命令,都通过字节码增强技术来实现的,会在指定类的方法中插入一些切面来实现数据统计和观测,因此在线上、预发使用时,请尽量明确需要观测的类、方法以及条件,诊断结束要执行 shutdown 或将增强过的类执行 reset 命令。

options

options——查看或设置Arthas全局开关

管道

        Arthas支持使用管道对上述命令的结果进行进一步的处理,如sm org.apache.log4j.Logger | grep


grep——搜索满足条件的结果

plaintext——将命令的结果去除颜色

wc——按行统计输出结果

以上,就是关于Arthas的简单介绍,要想真正的融会贯通,真正的把他作为一个排查问题的利器,还需要自己动手实践下!所谓实践出真知。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,271评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,275评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,151评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,550评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,553评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,559评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,924评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,580评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,826评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,363评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,940评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2 342

推荐阅读更多精彩内容

  • 11.9感激 感激今天舒老师的形象清晰的讲解,让我更加晴晰地明白唤醒力、连接力、创造力和整合力以及它们之间的关系,...
    我和榕树阅读 133评论 0 0
  • 从宜宾到成都的大巴车上,望着窗外快速后退的树,我的想法既然是冬天是真的来了…… 以前不喜欢冬天是真的太冷了,脸上被...
    四夕花花阅读 248评论 2 1
  • 目录写在前面如何使用该指北写作目的 1. 写在前面 如果只是需要完成一个常规的任务,请首先考虑使用成熟的【爬虫】软...
    ArthurN阅读 382评论 0 0