[TOC]
一、安装方式
1.1 本地安装
使用arthas-boot（推荐）
下载arthas-boot.jar，然后用java -jar的方式启动：
curl -O https://alibaba.github.io/arthas/arthas-boot.jar
java -jar arthas-boot.jar
1.2 通过rpm/deb来安装
在releases页面下载rpm/deb包： https://github.com/alibaba/arthas/releases
1.2.1 安装deb
sudo dpkg -i arthas*.deb
1.2.2 安装rpm
sudo rpm -i arthas*.rpm
1.2.3 deb/rpm安装的用法
在安装后，可以直接执行：
as.sh
1.3 如何在docker中使用
1.3.1 诊断Docker里的Java进程
docker exec -it ${containerId} /bin/bash -c "wget https://alibaba.github.io/arthas/arthas-boot.jar && java -jar arthas-boot.jar"
1.3.2 诊断k8s里容器里的Java进程
kubectl exec -it ${pod} --container ${containerId} -- /bin/bash -c "wget https://alibaba.github.io/arthas/arthas-boot.jar && java -jar arthas-boot.jar"
1.3.3 把Arthas安装到基础镜像里
可以很简单把Arthas安装到你的Docker镜像里。
FROM openjdk:8-jdk-alpine
# copy arthas
COPY --from=hengyunabc/arthas:latest /opt/arthas /opt/arthas
1.4 全量安装（离线安装时推荐使用）
1.4.1 下载全量包
最新版本，点击下载：
如果下载速度比较慢，可以尝试用阿里云的镜像仓库，比如要下载3.x.x版本（替换3.x.x为最新版本），下载的url是：
https://maven.aliyun.com/repository/public/com/taobao/arthas/arthas-packaging/3.x.x/arthas-packaging-3.x.x-bin.zip
用as.sh启动
解压后，在文件夹里有as.sh，直接用./as.sh的方式启动：
./as.sh
打印帮助信息：
./as.sh -h
二、如何使用watch功能
2.1 参数说明
watch 的参数比较多，主要是因为它能在 4 个不同的场景观察对象
| 参数名称 | 参数说明 |
|---|---|
| class-pattern | 类名表达式匹配 |
| method-pattern | 方法名表达式匹配 |
| express | 观察表达式 |
| condition-express | 条件表达式 |
| [b] | 在方法调用之前观察 |
| [e] | 在方法异常之后观察 |
| [s] | 在方法返回之后观察 |
| [f] | 在方法结束之后(正常返回和异常返回)观察 |
| [E] | 开启正则表达式匹配，默认为通配符匹配 |
| [x:] | 指定输出结果的属性遍历深度，默认为 1 |
比如
watch org.elasticsearch.action.index.IndexRequest validate “target”
执行后，就看到了我们希望了解到的内容。
2.2 注意事项
-
1、默认f参数，返回方法执行后的结果
-
2、可以同时监控方法执行前和方法执行后
三、常见用户案例
Github完整案例见用户案例,对应项目issue中使用label:user-case 搜索结果
筛选出部分和自己相关的部分案例如下
| 案例标题 | 使用特性 |
|---|---|
| Arthas协助排查线上skywalking不可用问题 #Issue557 | 该案例使用了watch特性，能够动态监控指定类、指定方法、输出的指定结果 |
| Arthas源码分析–jad反编译原理 | jad线上反编译代码 |
| 引发线程cpu占用率持续飙升的根因分析 | thread线程分析 |
| Arthas排查Kubernetes中的应用频繁挂掉重启问题 u | jvm堆分析 |
| Alibaba Arthas实践–获取到Spring Context，然后为所欲为 | tt命令结合-w参数 |
| 分享及其资料：当DUBBO遇上Arthas - 排查问题的实践 | watch命令 watch com.example.UserService * -e -x 2 ‘{params,throwExp}’ |
| …….省略 | |
