Arthas使用指南

原文链接：http://xiaoqiangge.com/aritcle/1538272842690.html

Arthas 是基于 Greys 进行二次开发的全新在线诊断工具，利用Java6的Instrumentation特性，动态增强你所指定的类，获取你想要到的信息, 采用命令行交互模式，同时提供丰富的 Tab 自动补全功能，让你在定位、分析诊断问题时看每一个操作都看起来是那么的 666

Arthas 能为你做什么？

• 这个类从哪个 jar 包加载的？为什么会报各种类相关的 Exception？
• 我改的代码为什么没有执行到？难道是我没 commit？分支搞错了？
• 遇到问题无法在预发 debug 一下，难道只能通过加日志再重新预发布吗？
• 线上遇到某个用户的数据处理有问题，但线上同样无法 debug，线下无法重现,怎么办?
• 是否有一个全局视角来查看系统的运行状况？
• 有什么办法可以监控到容器和中间件的实时运行状态？

Arthas 是基于 Greys 进行二次开发的全新在线诊断工具，利用Java6的Instrumentation特性，动态增强你所指定的类，获取你想要到的信息, 采用命令行交互模式，同时提供丰富的 Tab 自动补全功能，让你在定位、分析诊断问题时看每一个操作都看起来是那么的 666，官方问档

Arthas安装及使用

下载压缩包,上传到需要被诊断的机器， 解压缩

安装: 执行 ./install.sh

启动: 执行 ./as.sh pid

常用命令

dashboard

当前系统的实时数据面板

参数解释

ID: Java级别的线程ID，注意这个ID不能跟jstack中的nativeID一一对应

NAME: 线程名

GROUP: 线程组名

PRIORITY: 线程优先级, 1~10之间的数字，越大表示优先级越高

STATE: 线程的状态

CPU%: 线程消耗的cpu占比，采样100ms，将所有线程在这100ms内的cpu使用量求和，再算出每个线程的cpu使用占比。

TIME: 线程运行总时间

INTERRUPTE: 线程当前的中断位状态

thread

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

参数说明

id

线程id

-n

指定最忙的前N个线程并打印堆栈

b

找出当前阻塞其他线程的线程

-i

指定cpu占比统计的采样间隔，单位为毫秒

PS: 这里的cpu统计的是，一段采样间隔内，当前JVM里各个线程所占用的cpu时间占总cpu时间的百分比。其计算方法为： 首先进行一次采样，获得所有线程的cpu的使用时间(调用的是java.lang.management.ThreadMXBean#getThreadCpuTime这个接口)，然后睡眠一段时间，默认100ms，可以通过-i参数指定，然后再采样一次，最后得出这段时间内各个线程消耗的cpu时间情况，最后算出百分比。注意： 这个统计也会产生一定的开销（JDK这个接口本身开销比较大），因此会看到as的线程占用一定的百分比，为了降低统计自身的开销带来的影响，可以把采样间隔拉长一些，比如5000毫秒。

原文链接：http://xiaoqiangge.com/aritcle/1538272842690.html

sc

参数说明

class-pattern

类名表达式匹配

-d

输出当前类的详细信息，包括这个类所加载的原始文件来源、类的声明、加载的ClassLoader等详细信息。如果一个类被多个ClassLoader所加载，则会出现多次

-E

开启正则表达式匹配，默认为通配符匹配

-f

输出当前类的成员变量信息（需要配合参数-d一起使用）

-x

指定输出静态变量时属性的遍历深度，默认为 0，即直接使用 toString 输出

PS: class-pattern支持全限定名，如com.test.AAA，也支持com/test/AAA这样的格式，这样，我们从异常堆栈里面把类名拷贝过来的时候，不需要在手动把/替换为.啦,
sc 默认开启了子类匹配功能，也就是说所有当前类的子类也会被搜索出来，想要精确的匹配，请打开options disable-sub-class true开关

sm

查看已加载类的方法信息

参数说明

class-pattern

类名表达式匹配

method-pattern

方法名表达式匹配

-d
展示每个方法的详细信息

-E
开启正则表达式匹配，默认为通配符匹配

PS:查看已加载类的方法信息, “Search-Method” 的简写，这个命令能搜索出所有已经加载了 Class 信息的方法信息。
sm 命令只能看到由当前类所声明 (declaring) 的方法，父类则无法看到

monitor

方法执行监控

参数说明

class-pattern

类名表达式匹配

method-pattern

方法名表达式匹配

-c
统计周期，默认值为120秒

监控项

timestamp 时间戳
class java类
method 方法（构造方法、普通方法）
total 调用次数
success 成功次数
fail 失败次数
rt 平均rt
fail-rate 失败率

PS:方法执行监控, 对匹配 class-pattern／method-pattern的类、方法的调用进行监控。

trace

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

参数说明

class-pattern

类名表达式匹配

method-pattern

方法名表达式匹配

condition-express

条件表达式

-n

命令执行次数

#cost

方法执行耗时

PS： 很多时候我们只想看到某个方法的rt大于某个时间之后的trace结果，例如trace *StringUtils isBlank '$cost>100’表示当执行时间超过100ms的时候，才会输出trace的结果。

stack

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

输出当前方法被调用的调用路径, 很多时候我们都知道一个方法被执行，但这个方法被执行的路径非常多，或者你根本就不知道这个方法是从那里被执行了，此时你需要的是 stack 命令。

参数说明

class-pattern

类名表达式匹配

method-pattern

方法名表达式匹配

condition-express

条件表达式

-n

执行次数限制

watch

方法执行数据观测

方法执行数据观测, 让你能方便的观察到指定方法的调用情况。能观察到的范围为：返回值、抛出异常、入参，通过编写 groovy 表达式进行对应变量的查看。

参数说明

class-pattern

类名表达式匹配

method-pattern

方法名表达式匹配

express

观察表达式

condition-express

条件表达式

-b
在方法调用之前观察(默认关闭)

-e
在方法异常之后观察(默认关闭)

-s
在方法返回之后观察(默认关闭)

-f
在方法结束之后(正常返回和异常返回)观察 (默认开启)

-x
指定输出结果的属性遍历深度，默认为0

PS:这里重点要说明的是观察表达式，观察表达式的构成主要由 groovy 表达式组成，只要是一个合法的 groovy 表达式，都能被正常支持。

观察的维度也比较多，主要体现在参数 advice 的数据结构上。Advice 参数最主要是封装了通知节点的所有信息。

原文链接：http://xiaoqiangge.com/aritcle/1538272842690.html