Arthas

概述

Arthas（阿尔萨斯） 能为你做什么？

Arthas 是Alibaba开源的Java诊断工具，深受开发者喜爱。

当你遇到以下类似问题而束手无策时，Arthas可以帮助你解决：

1. 这个类从哪个 jar 包加载的？为什么会报各种类相关的 Exception？
2. 我改的代码为什么没有执行到？难道是我没 commit？分支搞错了？
3. 遇到问题无法在线上 debug，难道只能通过加日志再重新发布吗？
4. 线上遇到某个用户的数据处理有问题，但线上同样无法 debug，线下无法重现！
5. 是否有一个全局视角来查看系统的运行状况？
6. 有什么办法可以监控到JVM的实时运行状态？
7. 怎么快速定位应用的热点，生成火焰图？

运行环境要求

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

快速安装

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

命令

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

注：在运行第2条命令之前，先运行一个java进程在内存中，不然会出现找不到java进程的错误。

打印帮助信息

java -jar arthas-boot.jar -h

如果下载速度比较慢，可以使用aliyun的镜像：

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

注：如果是Linux，可以使用以下命令解压到指定的arthas目录

unzip -d arthas arthas-packaging-3.1.7-bin.zip

卸载

在 Linux/Unix/Mac 平台

删除下面文件：

rm -rf ~/.arthas/
rm -rf ~/logs/arthas

小结

因为jar包是绿色，要卸载的话，直接删除2个目录

.arthas安装目录
logs的日志记录目录

快速入门：attach一个进程

启动Demo

命令

下载已经打包好的arthas-demo.jar
curl -O https://alibaba.github.io/arthas/arthas-demo.jar

在命令行下执行
java -jar arthas-demo.jar

效果

启动arthas

1. 因为arthas-demo.jar进程打开了一个窗口，所以另开一个命令窗口执行arthas-boot.jar
2. 选择要粘附的进程：arthas-demo.jar
   
3. 如果粘附成功，在arthas-demo.jar那个窗口中会出现日志记录的信息，记录在~/logs目录下
   
4. 如果端口号被占用，也可以通过以下命令换成另一个端口号执行

java -jar arthas-boot.jar --telnet-port 9998 --http-port -1

4. 通过浏览器连接arthas

Arthas目前支持Web Console，用户在attach成功之后，可以直接访问：http://127.0.0.1:3658/。

可以填入IP，远程连接其它机器上的arthas。

默认情况下，arthas只listen 127.0.0.1，所以如果想从远程连接，则可以使用 --target-ip参数指定listen的IP

快速入门：常用命令接触

目标

1. dashboard仪表板
2. 通过thread命令来获取到arthas-demo进程的Main Class
3. 通过jad来反编译Main Class
4. watch

命令介绍

1. dashboard仪表板

输入dashboard(仪表板)，按回车/enter，会展示当前进程的信息，按ctrl+c可以中断执行。

注：输入前面部分字母，按tab可以自动补全命令

1. 第一部分是显示JVM中运行的所有线程：所在线程组，优先级，线程的状态，CPU的占用率，是否是后台进程等
2. 第二部分显示的JVM内存的使用情况
3. 第三部分是操作系统的一些信息和Java版本号
   

2. 通过thread命令来获取到arthas-demo进程的Main Class

获取到arthas-demo进程的Main Class

thread 392会打印线程ID 392的栈，通常是main函数的线程。

3. 通过jad来反编译Main Class

jad demo.MathGame

4. watch监视

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

$ watch demo.MathGame primeFactors returnObj

5. 退出arthas

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

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

小结

1. 如何启动arthas?

   java -jar arthas-boot.jar
   

2. 说说以下命令的作用

命令	功能
dashboard	显示JVM中内存的情况，JVM中环境信息
thread	显示当前进程所有线程信息
jad	反编译指定的类或方法
watch	监视某个方法的执行情况，监视了返回值
quit，exit, stop	退出或停止arthas

基础命令之一

help

作用

查看命令帮助信息

效果

cat

作用

打印文件内容，和linux里的cat命令类似

如果没有写路径，则显示当前目录下的文件

效果

grep

作用

匹配查找，和linux里的grep命令类似，但它只能用于管道命令

语法

参数列表	作用
-n	显示行号
-i	忽略大小写查找
-m 行数	最大显示行数，要与查询字符串一起使用
-e “正则表达式”	使用正则表达式查找

举例

只显示包含java字符串的行系统属性
sysprop | grep java

显示包含java字符串的行和行号的系统属性
sysprop | grep java -n

显示包含system字符串的10行信息
thread | grep system -m 10

使用正则表达式，显示包含2个o字符的线程信息
thread | grep -e "o+"

pwd

作用

返回当前的工作目录，和linux命令类似

pwd: Print Work Directory 打印当前工作目录

效果

cls

作用

清空当前屏幕区域

基础命令之二

session

作用

查看当前会话的信息

效果

reset

作用

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

语法

还原指定类
reset Test

还原所有以List结尾的类
reset *List

还原所有的类
reset

效果

version

作用

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

效果

history

作用

打印命令历史

效果

quit

作用

退出当前 Arthas 客户端，其他 Arthas 客户端不受影响

stop

作用

关闭 Arthas 服务端，所有 Arthas 客户端全部退出

效果

keymap

作用

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

效果

Arthas 命令行快捷键

快捷键说明	命令说明
ctrl + a	跳到行首
ctrl + e	跳到行尾
ctrl + f	向前移动一个单词
ctrl + b	向后移动一个单词
键盘左方向键	光标向前移动一个字符
键盘右方向键	光标向后移动一个字符
键盘下方向键	下翻显示下一个命令
键盘上方向键	上翻显示上一个命令
ctrl + h	向后删除一个字符
ctrl + shift + /	向后删除一个字符
ctrl + u	撤销上一个命令，相当于清空当前行
ctrl + d	删除当前光标所在字符
ctrl + k	删除当前光标到行尾的所有字符
ctrl + i	自动补全，相当于敲TAB
ctrl + j	结束当前行，相当于敲回车
ctrl + m	结束当前行，相当于敲回车

• 任何时候 tab 键，会根据当前的输入给出提示
• 命令后敲 - 或 -- ，然后按 tab 键，可以展示出此命令具体的选项

后台异步命令相关快捷键

• ctrl + c: 终止当前命令
• ctrl + z: 挂起当前命令，后续可以 bg/fg 重新支持此命令，或 kill 掉
• ctrl + a: 回到行首
• ctrl + e: 回到行尾

小结

命令	说明
session	显示当前会话的信息：进程的ID，会话ID
reset	重置类的增强，服务器关闭的时候会自动重置所有的类
version	显示arthas版本号
quit	退出当前会话，不会影响其它的会话
stop	退出arthas服务器，所有的会话都停止
keymap	获取快捷键

jvm相关命令之一

dashboard

作用

显示当前系统的实时数据面板，按q或ctrl+c退出

效果

数据说明

• ID: Java级别的线程ID，注意这个ID不能跟jstack中的nativeID一一对应
• NAME: 线程名
• GROUP: 线程组名
• PRIORITY: 线程优先级, 1~10之间的数字，越大表示优先级越高
• STATE: 线程的状态
• CPU%: 线程消耗的cpu占比，采样100ms，将所有线程在这100ms内的cpu使用量求和，再算出每个线程的cpu使用占比。
• TIME: 线程运行总时间，数据格式为分：秒
• INTERRUPTED: 线程当前的中断位状态
• DAEMON: 是否是daemon线程

thread线程相关

作用

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

参数说明

参数名称	参数说明
数字	线程id
[n:]	指定最忙的前N个线程并打印堆栈
[b]	找出当前阻塞其他线程的线程
[i <value>]	指定cpu占比统计的采样间隔，单位为毫秒

举例

展示当前最忙的前3个线程并打印堆栈
thread -n 3

当没有参数时，显示所有线程的信息
thread

显示15号线程的运行堆栈
thread 15

找出当前阻塞其他线程的线程，有时候我们发现应用卡住了， 通常是由于某个线程拿住了某个锁， 并且其他线程都在等待这把锁造成的。 为了排查这类问题， arthas提供了thread -b， 一键找出那个罪魁祸首。
thread -b  //排查死锁，阻塞线程

指定采样时间间隔，每过1000毫秒采样，显示最占时间的3个线程
thread -i 1000 -n 3

查看处于等待状态的线程
thread --state WAITING