Arthas在线java进程诊断工具在线调试神器详解
`Arthas` 是 Alibaba 开源的Java诊断工具，深受开发者喜爱。
当你遇到以下类似问题而束手无策时，`Arthas`可以帮助你解决：
1. 这个类从哪个 jar 包加载的？为什么会报各种类相关的 Exception？
2. 我改的代码为什么没有执行到？难道是我没 commit？分支搞错了？
3. 遇到问题无法在线上 debug，难道只能通过加日志再重新发布吗？
4. 线上遇到某个用户的数据处理有问题，但线上同样无法 debug，线下无法重现！
5. 是否有一个全局视角来查看系统的运行状况？
6. 有什么办法可以监控到JVM的实时运行状态？
7. 怎么快速定位应用的热点，生成火焰图？
8. 怎样直接从JVM内查找某个类的实例？
`Arthas`支持JDK 6+，支持Linux/Mac/Windows，采用命令行交互模式，同时提供丰富的 `Tab` 自动补全功能，进一步方便进行问题的定位和诊断。
tag: java 诊断 堆栈 在线调试 耗时 死锁 arthas 阿里巴巴
Arthas （阿尔萨斯）
Arthas 是 Alibaba 开源的Java诊断工具，深受开发者喜爱。
官网文档：https://arthas.aliyun.com/doc/
当你遇到以下类似问题而束手无策时，Arthas可以帮助你解决：
这个类从哪个 jar 包加载的？为什么会报各种类相关的 Exception？我改的代码为什么没有执行到？难道是我没 commit？分支搞错了？遇到问题无法在线上 debug，难道只能通过加日志再重新发布吗？线上遇到某个用户的数据处理有问题，但线上同样无法 debug，线下无法重现！是否有一个全局视角来查看系统的运行状况？有什么办法可以监控到JVM的实时运行状态？怎么快速定位应用的热点，生成火焰图？怎样直接从JVM内查找某个类的实例？
Arthas支持JDK 6+，支持Linux/Mac/Windows，采用命令行交互模式，同时提供丰富的 Tab 自动补全功能，进一步方便进行问题的定位和诊断。
安装
快速安装
1.1.1 使用arthas-boot（推荐）
下载arthas-boot.jar，然后用java -jar的方式启动：
curl -O https://arthas.aliyun.com/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
使用as.sh方式安装
Arthas 支持在 Linux/Unix/Mac 等平台上一键安装，请复制以下内容，并粘贴到命令行中，敲 回车 执行即可：
curl -L https://arthas.aliyun.com/install.sh | sh
上述命令会下载启动脚本文件 as.sh 到当前目录，你可以放在任何地方或将其加入到 $PATH 中。
直接在shell下面执行./as.sh，就会进入交互界面。
也可以执行./as.sh -h来获取更多参数信息。
全量安装 （线上环境无外网访问权限）
# java -jar arthas-boot.jar
[INFO] arthas-boot version: 3.5.3
[INFO] Found existing java process, please choose one and input the serial number of the process, eg : 1. Then hit ENTER.
* [1]: 24438 org.elasticsearch.bootstrap.Elasticsearch
1
[ERROR] Can not read arthas version from: https://arthas.aliyun.com/api/latest_version
[ERROR] Can not find Arthas under local: /root/.arthas/lib and remote repo mirror: aliyun
[ERROR] Unable to download arthas from remote server, please download the full package according to wiki: https://github.com/alibaba/arthas
当使用快速安装方式在线上环境进行连接Java服务的时候，很有可能因为线上环境无外部网络访问权限，导致Arthas无法获取 arthas-core 等jar包，无法运行。
这时候就需要全量安装Arthas包。
安装方法 ： ( 包大小13MB )
#### 获取 arthas 全量包 curl -Lo arthas-packaging-latest-bin.zip 'https://arthas.aliyun.com/download/latest_version?mirror=aliyun' unzip -d arthas-latest-bin arthas-packaging-latest-bin.zip #### 开始运行 java -jar ahthas-boot.jar [INFO] arthas-boot version: 3.5.4 [INFO] Found existing java process, please choose one and input the serial number of the process, eg : 1. Then hit ENTER. * [1]: 27878 /data/tsf/tsf-oss/tsf-ratelimit/tsf-ratelimit-1.29.1/lib/tsf-ratelimit-1.29.1.jar 1 [INFO] arthas home: /root [INFO] Try to attach process 27878 [INFO] Attach process 27878 success. [INFO] arthas-client connect 127.0.0.1 3658 ,---. ,------. ,--------.,--. ,--. ,---. ,---. / O \ | .--. ''--. .--'| '--' | / O \ ' .-' | .-. || '--'.' | | | .--. || .-. |`. `-. | | | || |\ \ | | | | | || | | |.-' | `--' `--'`--' '--' `--' `--' `--'`--' `--'`-----' wiki https://arthas.aliyun.com/doc tutorials https://arthas.aliyun.com/doc/arthas-tutorials.html version 3.5.4 main_class pid 27878 time 2021-09-07 19:31:47
通过 rpm/deb 来安装
这部分见官方文档.
快速入门
arthas 需要使用到 jps 命令，所以要保证 openjdk-devel 包已经安装。
jps || yum -y install java-1.8.0-openjdk-devel
运行 arthas：
# java -jar arthas-boot.jar
[INFO] arthas-boot version: 3.5.3
[INFO] Process 5201 already using port 3658
[INFO] Process 5201 already using port 8563
[INFO] Found existing java process, please choose one and input the serial number of the process, eg : 1. Then hit ENTER.
* [1]: 5201 cloud-access-auth-1.18.1.jar
[2]: 14419 tsf-stack-base-1.0.0.jar
[3]: 27862 cloud-access-gateway-1.18.1.jar
[4]: 6550 tsfmanager-operation-1.29.1.jar
提示1：当 arthas 给出的进程列表不能确定进程信息的时候，我们可以通过在命令行输入jps -lmv 查看详细的 java 进程信息，来确定我们要查看的 java 进程号。
提示2：当提示如下信息时：
Arthas script version: 3.0.4
Calculating attach execution time...
Attaching to 24110 using version 3.0.4...
Start arthas failed, exception stack trace:
java.lang.InternalError: instrument library is missing in target VM
at sun.tools.attach.HotSpotVirtualMachine.loadAgent(HotSpotVirtualMachine.java:105)
at com.taobao.arthas.core.Arthas.attachAgent(Arthas.java:84)
at com.taobao.arthas.core.Arthas.<init>(Arthas.java:25)
at com.taobao.arthas.core.Arthas.main(Arthas.java:96)
Caused by: com.sun.tools.attach.AgentLoadException: Failed to load agent library
at sun.tools.attach.LinuxVirtualMachine.execute(LinuxVirtualMachine.java:224)
at sun.tools.attach.HotSpotVirtualMachine.loadAgentLibrary(HotSpotVirtualMachine.java:58)
at sun.tools.attach.HotSpotVirtualMachine.loadAgentLibrary(HotSpotVirtualMachine.java:79)
at sun.tools.attach.HotSpotVirtualMachine.loadAgent(HotSpotVirtualMachine.java:103)
... 3 more
attach to target jvm (24110) failed, check /root/logs/arthas/arthas.log or stderr of target jvm for any exceptions.
我们需要重新启动一下该进程，然后再运行 arthas ，连接到后台 java 进程即可。
下面的 java 进程编号即当前主机已经运行的 java 服务，输入编号即可进入 arthas 的交互式界面。
[INFO] Found existing java process, please choose one and input the serial number of the process, eg : 1. Then hit ENTER. * [1]: 5201 cloud-access-auth-1.18.1.jar [2]: 14419 tsf-stack-base-1.0.0.jar [3]: 27862 cloud-access-gateway-1.18.1.jar [4]: 6550 tsfmanager-operation-1.29.1.jar 1 [INFO] local lastest version: 3.5.3, remote lastest version: 3.5.4, try to download from remote. [INFO] Start download arthas from remote server: https://arthas.aliyun.com/download/3.5.4?mirror=aliyun [INFO] Download arthas success. [INFO] arthas home: /root/.arthas/lib/3.5.4/arthas [INFO] The target process already listen port 3658, skip attach. [INFO] arthas-client connect 127.0.0.1 3658 ,---. ,------. ,--------.,--. ,--. ,---. ,---. / O \ | .--. ''--. .--'| '--' | / O \ ' .-' | .-. || '--'.' | | | .--. || .-. |`. `-. | | | || |\ \ | | | | | || | | |.-' | `--' `--'`--' '--' `--' `--' `--'`--' `--'`-----' wiki https://arthas.aliyun.com/doc tutorials https://arthas.aliyun.com/doc/arthas-tutorials.html version 3.5.3 main_class pid 5201 time 2021-09-03 09:55:42 [arthas@5201]$
当出现上述彩条 ARTHAS 字符提示的时候，就表示已经正常连接到指定的 Java 进程，随即进入到下面的 arthas@PID 命令提示符。
功能使用
dashboard 指令 -- 总览JVM信息
在 arthas 命令提示符下键入dashboard 回车，会展示当前进程的信息，按q 退出。
dashboard 会实时输出该java进程的JVM信息，包括线程、进程、内存、堆栈、以及当前系统运行时信息。
[arthas@5201]$ dashboard -h USAGE: dashboard [-h] [-i <value>] [-n <value>] SUMMARY: Overview of target jvm's thread, memory, gc, vm, tomcat info. EXAMPLES: dashboard dashboard -n 10 dashboard -i 2000 WIKI: https://arthas.aliyun.com/doc/dashboard OPTIONS: -h, --help this help -i, --interval <value> The interval (in ms) between two executions, default is 5000 ms. -n, --number-of-execution <value> The number of times this command will be executed.
help 指令
该指令用以列出所有 arthas 交互式界面支持的 子命令 列表。
[arthas@5201]$ help NAME DESCRIPTION help Display Arthas Help auth Authenticates the current session keymap Display all the available keymap for the specified connection. sc Search all the classes loaded by JVM sm Search the method of classes loaded by JVM classloader Show classloader info jad Decompile class getstatic Show the static field of a class monitor Monitor method execution statistics, e.g. total/success/failure count, average rt, fail rate, etc. stack Display the stack trace for the specified class and method thread Display thread info, thread stack trace Trace the execution time of specified method invocation. watch Display the input/output parameter, return object, and thrown exception of specified method invocation tt Time Tunnel jvm Display the target JVM information perfcounter Display the perf counter information. ognl Execute ognl expression. mc Memory compiler, compiles java files into bytecode and class files in memory. redefine Redefine classes. @see Instrumentation#redefineClasses(ClassDefinition...) retransform Retransform classes. @see Instrumentation#retransformClasses(Class...) dashboard Overview of target jvm's thread, memory, gc, vm, tomcat info. dump Dump class byte array from JVM heapdump Heap dump options View and change various Arthas options cls Clear the screen reset Reset all the enhanced classes version Display Arthas version session Display current session information sysprop Display, and change the system properties. sysenv Display the system env. vmoption Display, and update the vm diagnostic options. logger Print logger info, and update the logger level history Display command history cat Concatenate and print files base64 Encode and decode using Base64 representation echo write arguments to the standard output pwd Return working directory name mbean Display the mbean information grep grep command for pipes. tee tee command for pipes. profiler Async Profiler. https://github.com/jvm-profiling-tools/async-profiler vmtool jvm tool stop Stop/Shutdown Arthas server and exit the console.
每个子命令，都可以跟上 -h 来进一步获取帮助用法信息。
thread 指令
[arthas@5201]$ thread -h
USAGE:
thread [--all] [-h] [-b] [--lockedMonitors] [--lockedSynchronizers] [-i <value>] [--state <value>] [-n <value>] [id]
SUMMARY:
Display thread info, thread stack
EXAMPLES:
thread
thread 51
thread -n -1
thread -n 5
thread -b
thread -i 2000
thread --state BLOCKED
WIKI:
https://arthas.aliyun.com/doc/thread
OPTIONS:
--all Display all thread results instead of the first page
-h, --help this help
-b, --include-blocking-thread Find the thread who is holding a lock that blocks the most number of threads.
--lockedMonitors Find the thread info with lockedMonitors flag, default value is false.
--lockedSynchronizers Find the thread info with lockedSynchronizers flag, default value is false.
-i, --sample-interval <value> Specify the sampling interval (in ms) when calculating cpu usage.
--state <value> Display the thead filter by the state. NEW, RUNNABLE, TIMED_WAITING, WAITING, BLOCKED, TERMINATED is optional.
-n, --top-n-threads <value> The number of thread(s) to show, ordered by cpu utilization, -1 to show all.
<id> Show thread stack
$ thread -i 5000 ## 获取时间跨度为5s的计算汇总数据 $ thread -n 3 ## 根据 CPU 使用率排序，获取从高到低的 3 个线程堆栈信息 $ thread -b ## 仅查看死锁线程的堆栈信息 $ thread --lockedSynchronizers ## 仅查看同步器死锁的线程堆栈信息
stop / exit 停止 和 离开
stop: 停止和退出 Arthas consol ，正常退出步骤。
exit: 仅离开 Arthas consol，但是绑定到 Java 进程的 arthas 任务不会退出。
[SHELL]# java -jar arthas-boot.jar [INFO] arthas-boot version: 3.5.3 [INFO] Found existing java process, please choose one and input the serial number of the process, eg : 1. Then hit ENTER. * [1]: 5201 cloud-access-auth-1.18.1.jar [2]: 14419 tsf-stack-base-1.0.0.jar [3]: 27862 cloud-access-gateway-1.18.1.jar [4]: 6550 tsfmanager-operation-1.29.1.jar 1 [INFO] arthas home: /root/.arthas/lib/3.5.4/arthas [INFO] Try to attach process 5201 [INFO] Attach process 5201 success. [INFO] arthas-client connect 127.0.0.1 3658 ,---. ,------. ,--------.,--. ,--. ,---. ,---. / O \ | .--. ''--. .--'| '--' | / O \ ' .-' | .-. || '--'.' | | | .--. || .-. |`. `-. | | | || |\ \ | | | | | || | | |.-' | `--' `--'`--' '--' `--' `--' `--'`--' `--'`-----' wiki https://arthas.aliyun.com/doc tutorials https://arthas.aliyun.com/doc/arthas-tutorials.html version 3.5.4 main_class pid 5201 time 2021-09-03 13:05:51 [arthas@5201]$ exit [SHELL]# java -jar arthas-boot.jar [INFO] arthas-boot version: 3.5.3 [INFO] Process 5201 already using port 3658 ## 由于上次并没有 shutdown 关闭arthas与java进程的绑定，所以Arthas重新启动的时候，检测到仍然绑定到 5201 进程上面的。 [INFO] Process 5201 already using port 8563 [INFO] Found existing java process, please choose one and input the serial number of the process, eg : 1. Then hit ENTER. * [1]: 5201 cloud-access-auth-1.18.1.jar [2]: 14419 tsf-stack-base-1.0.0.jar [3]: 27862 cloud-access-gateway-1.18.1.jar [4]: 6550 tsfmanager-operation-1.29.1.jar
我们通过 jstack -l 5201 来证实这一点
[root@VM-0-4-centos ~]# jstack -l 5201 | more 2021-09-03 13:08:16 Full thread dump OpenJDK 64-Bit Server VM (25.302-b08 mixed mode): "arthas-NettyHttpTelnetBootstrap-3-3" #169 daemon prio=5 os_prio=0 tid=0x00007f314000b800 nid=0x5632 runnable [0x00007f30cb51a000] java.lang.Thread.State: RUNNABLE at sun.nio.ch.EPollArrayWrapper.epollWait(Native Method) at sun.nio.ch.EPollArrayWrapper.poll(EPollArrayWrapper.java:269) at sun.nio.ch.EPollSelectorImpl.doSelect(EPollSelectorImpl.java:93) at sun.nio.ch.SelectorImpl.lockAndDoSelect(SelectorImpl.java:86) - locked <0x00000000e8cafb00> (a com.alibaba.arthas.deps.io.netty.channel.nio.SelectedSelectionKeySet) - locked <0x00000000e8caf8a8> (a java.util.Collections$UnmodifiableSet) - locked <0x00000000e8caf790> (a sun.nio.ch.EPollSelectorImpl) at sun.nio.ch.SelectorImpl.select(SelectorImpl.java:97) at sun.nio.ch.SelectorImpl.select(SelectorImpl.java:101) at com.alibaba.arthas.deps.io.netty.channel.nio.SelectedSelectionKeySetSelector.select(SelectedSelectionKeySetSelector.java:68) at com.alibaba.arthas.deps.io.netty.channel.nio.NioEventLoop.select(NioEventLoop.java:810) at com.alibaba.arthas.deps.io.netty.channel.nio.NioEventLoop.run(NioEventLoop.java:457) at com.alibaba.arthas.deps.io.netty.util.concurrent.SingleThreadEventExecutor$4.run(SingleThreadEventExecutor.java:989) at com.alibaba.arthas.deps.io.netty.util.internal.ThreadExecutorMap$2.run(ThreadExecutorMap.java:74) at com.alibaba.arthas.deps.io.netty.util.concurrent.FastThreadLocalRunnable.run(FastThreadLocalRunnable.java:30) at java.lang.Thread.run(Thread.java:748) Locked ownable synchronizers: - None "arthas-NettyHttpTelnetBootstrap-3-2" #168 daemon prio=5 os_prio=0 tid=0x00007f314000a000 nid=0x51ce runnable [0x00007f30d09f9000] java.lang.Thread.State: RUNNABLE at sun.nio.ch.EPollArrayWrapper.epollWait(Native Method) at sun.nio.ch.EPollArrayWrapper.poll(EPollArrayWrapper.java:269) at sun.nio.ch.EPollSelectorImpl.doSelect(EPollSelectorImpl.java:93) at sun.nio.ch.SelectorImpl.lockAndDoSelect(SelectorImpl.java:86) - locked <0x00000000e8cac058> (a com.alibaba.arthas.deps.io.netty.channel.nio.SelectedSelectionKeySet) - locked <0x00000000e8cabe00> (a java.util.Collections$UnmodifiableSet) - locked <0x00000000e8cabce8> (a sun.nio.ch.EPollSelectorImpl) at sun.nio.ch.SelectorImpl.select(SelectorImpl.java:97) at sun.nio.ch.SelectorImpl.select(SelectorImpl.java:101) at com.alibaba.arthas.deps.io.netty.channel.nio.SelectedSelectionKeySetSelector.select(SelectedSelectionKeySetSelector.java:68)
我们可以看到 5201 进程的java堆栈信息，有 arthas 的线程正在运行中。
正常退出步骤：
[arthas@5201]$ stop Resetting all enhanced classes ... Affect(class count: 0 , method count: 0) cost in 0 ms, listenerId: 0 Arthas Server is going to shutdown... [arthas@5201]$ session (f0151617-7fd2-4b4b-b79f-31d366a72fc5) is closed because server is going to shutdown. [SHELL]# jstack -l 5201 | more 2021-09-03 13:10:16 Full thread dump OpenJDK 64-Bit Server VM (25.302-b08 mixed mode): "Abandoned connection cleanup thread" #51 daemon prio=5 os_prio=0 tid=0x00007f30e0246000 nid=0x1d86 in Object.wait() [0x00007f3120393000] java.lang.Thread.State: TIMED_WAITING (on object monitor) at java.lang.Object.wait(Native Method) at java.lang.ref.ReferenceQueue.remove(ReferenceQueue.java:144) - locked <0x00000000e3280300> (a java.lang.ref.ReferenceQueue$Lock) at com.mysql.jdbc.AbandonedConnectionCleanupThread.run(AbandonedConnectionCleanupThread.java:64) at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149) at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624) at java.lang.Thread.run(Thread.java:748) Locked ownable synchronizers: - <0x00000000e3280390> (a java.util.concurrent.ThreadPoolExecutor$Worker) "Tomcat JDBC Pool Cleaner[1450495309:1630634377161]" #50 daemon prio=5 os_prio=0 tid=0x00007f30e01e4800 nid=0x1d85 in Object.wait() [0x00007f3120494000] java.lang.Thread.State: TIMED_WAITING (on object monitor) at java.lang.Object.wait(Native Method) at java.util.TimerThread.mainLoop(Timer.java:552) - locked <0x00000000e3280540> (a java.util.TaskQueue) at java.util.TimerThread.run(Timer.java:505) Locked ownable synchronizers: - None
可以看到，使用 stop 指令关闭arthas诊断程序后，java 进程上面的arthas线程绑定也一并退出了。
watch 指令 ⭐ -- 方法执行数据观测
watch指令算是 Arthas 中最常用的指令之一了，它能够获取指定包.类.方法的入参、自身类方法体内部对象以及返回对象值。
[arthas@5201]$ watch -h
USAGE:
watch [-b] [-e] [--exclude-class-pattern <value>] [-x <value>] [-f] [-h] [-n <value>] [--listenerId <value>] [-E] [-M <value>] [-s] [-v] class-pattern method-pattern [express] [condition-express]
SUMMARY:
Display the input/output parameter, return object, and thrown exception of specified method invocation
The express may be one of the following expression (evaluated dynamically):
target : the object
clazz : the object's class
method : the constructor or method
params : the parameters array of method
params[0..n] : the element of parameters array
returnObj : the returned object of method
throwExp : the throw exception of method
isReturn : the method ended by return
isThrow : the method ended by throwing exception
#cost : the execution time in ms of method invocation
Examples:
watch org.apache.commons.lang.StringUtils isBlank
watch org.apache.commons.lang.StringUtils isBlank '{params, target, returnObj, throwExp}' -x 2
watch *StringUtils isBlank params[0] params[0].length==1
watch *StringUtils isBlank params '#cost>100'
watch -f *StringUtils isBlank params
watch *StringUtils isBlank params[0]
watch -E -b org\.apache\.commons\.lang\.StringUtils isBlank params[0]
watch javax.servlet.Filter * --exclude-class-pattern com.demo.TestFilter
WIKI:
https://arthas.aliyun.com/doc/watch
OPTIONS:
-b, --before Watch before invocation
-e, --exception Watch after throw exception
--exclude-class-pattern <value> exclude class name pattern, use either '.' or '/' as separator
-x, --expand <value> Expand level of object (1 by default)
-f, --finish Watch after invocation, enable by default
-h, --help this help
-n, --limits <value> Threshold of execution times
--listenerId <value> The special listenerId
-E, --regex Enable regular expression to match (wildcard matching by default)
-M, --sizeLimit <value> Upper size limit in bytes for the result (10 * 1024 * 1024 by default)
-s, --success Watch after successful invocation
-v, --verbose Enables print verbose information, default value false.
<class-pattern> The full qualified class name you want to watch
<method-pattern> The method name you want to watch
<express> The content you want to watch, written by ognl. Default value is '{params, target, returnObj}'
Examples:
params
params[0]
'params[0]+params[1]'
'{params[0], target, returnObj}'
returnObj
throwExp
target
clazz
method
<condition-express> Conditional expression in ognl style, for example:
TRUE : 1==1
TRUE : true
FALSE : false
TRUE : 'params.length>=0'
FALSE : 1==2
'#cost>100'
参数说明
| 参数名称 | 参数说明 |
|---|---|
| class-pattern | 类名表达式匹配 |
| method-pattern | 方法名表达式匹配 |
| express | 观察表达式，默认值：{params, target, returnObj} |
| condition-express | 条件表达式 |
| [b] | 在方法调用之前观察 |
| [e] | 在方法异常之后观察 |
| [s] | 在方法返回之后观察 |
| [f] | 在方法结束之后(正常返回和异常返回)观察 |
| [E] | 开启正则表达式匹配，默认为通配符匹配 |
| [x:] | 指定输出结果的属性遍历深度，默认为 1 |
这里重点要说明的是观察表达式，观察表达式的构成主要由 #OGNL 表达式组成，所以你可以这样写"{params,returnObj}"，只要是一个合法的 ognl 表达式，都能被正常支持。
观察的维度也比较多，主要体现在参数 advice 的数据结构上。Advice 参数最主要是封装了通知节点的所有信息。请参考表达式核心变量中关于该节点的描述。
使用举例：
我需要观察cloud-access-auth-1.18.1.jar进程在处理登录信息时的登录方法信息，日志如下：
13:42:54.205 INFO [http-nio-7001-exec-4] c.t.c.access.sso.service.impl.AuthenticateService - [Access Auth] account login parameter. accountName:qcloudAdmin ,password:******
得到指定类名为AuthenticateService。
我们带到 Arthas 中进行 watch：
### 报名在日志文件中是简写，所以我这里使用通配符方式匹配类名，第二个参数方法名我也用*代替，全部匹配 [arthas@5201]$ watch *AuthenticateService * Press Q or Ctrl+C to abort. Affect(class count: 2 , method count: 6) cost in 130 ms, listenerId: 16 ### 从输出信息得知，在这个 Java 进程所有代码中匹配到有两个类，一共6个方法
我们来点击页面登录按钮，看看 watch 中能观察到哪些动作：
[arthas@5201]$ watch *AuthenticateService *
Press Q or Ctrl+C to abort.
Affect(class count: 2 , method count: 6) cost in 130 ms, listenerId: 16
#### 第一个方法开始执行 Begin
method=com.tencent.cloud.access.sso.service.impl.AuthenticateService.login location=AtExit
ts=2021-09-03 13:51:25; [cost=2.217281ms] result=@ArrayList[
@Object[][isEmpty=false;size=3],
@AuthenticateService[com.tencent.cloud.access.sso.service.impl.AuthenticateService@f5cadbf],
@AccessAuthPrincipal[com.tencent.cloud.access.sso.model.AccessAuthPrincipal@72f71bf6],
]
#### 第一个方法执行结束 End
#### 第二个方法开始执行 Begin
method=com.tencent.cloud.access.sso.service.impl.AuthenticateService.updateSession location=AtExit
ts=2021-09-03 13:51:25; [cost=0.956478ms] result=@ArrayList[
@Object[][isEmpty=false;size=2],
@AuthenticateService[com.tencent.cloud.access.sso.service.impl.AuthenticateService@f5cadbf],
@AuthenticationResponse[com.tencent.cloud.access.sso.model.AuthenticationResponse@6b2bae10],
]
#### 第二个方法执行退出 End
..............
在输出信息中我们可以看到，第一行有完整的方法路径，以及获取的退出状态location。
- AtExit：表示正常退出。
- AtExceptionExit：表示异常退出。
第二行有方法执行的开始时间戳以及cost 开销 ，最后一个为watch的结果。
这里result的 ArrayList 数组是 watch 指令的强大之处，它默认包含三个对象：
params: 入参，通常为数组，这里为@Object对象target: 运行中当前 this 对象，也就是这个类对象本身，这里为@AuthenticateService实体类对象returnObj: 返回对象值，这里为返回的@AccessAuthPrincipal对象
我们重新执行一次 watch 指令，这次咱们精确指定类名和方法名，以及加一个-x解析深度参数：
[arthas@5201]$ watch com.tencent.cloud.access.sso.service.impl.AuthenticateService login -x 2
Press Q or Ctrl+C to abort.
Affect(class count: 1 , method count: 2) cost in 74 ms, listenerId: 17
method=com.tencent.cloud.access.sso.service.impl.AuthenticateService.login location=AtExit
ts=2021-09-03 14:10:15; [cost=3.289679ms] result=@ArrayList[
@Object[][
@String[qcloudAdmin],
@String[Bgi8c0yC+IAvRLkuQRy6kLQ6T2J/9PNrL6G/+KX9ppE=],
@String[127.0.0.1],
],
@AuthenticateService[
log=@Logger[Logger[com.tencent.cloud.access.sso.service.impl.AuthenticateService]],
sessionDAO=@RedisSessionDAO[com.tencent.cloud.access.sso.shiro.RedisSessionDAO@61813e98],
accountSessionService=@AccountSessionService[com.tencent.cloud.access.account.service.impl.AccountSessionService@30e815ac],
accessAuthRealm=@AccessAuthRealm[com.tencent.cloud.access.sso.shiro.AccessAuthRealm@1faea5],
accountService=@AccountService[com.tencent.cloud.access.account.service.impl.AccountService@197459d8],
ssoProperties=@SsoProperties[com.tencent.cloud.access.sso.config.SsoProperties@461879b2],
securityManager=@DefaultSecurityManager[org.apache.shiro.mgt.DefaultSecurityManager@3b0f92f0],
ssoService=@QCloudSsoService[com.tencent.cloud.access.sso.service.impl.QCloudSsoService@4f8704f5],
userService=@UserService[com.tencent.cloud.access.user.service.impl.UserService@5e69da74],
],
@AccessAuthPrincipal[
serialVersionUID=@Long[-2856270666386831504],
accountName=@String[qcloudAdmin],
userId=null,
accountId=@String[account-96a79v5b],
password=@String[VYUQeJrC5EJq21t/f9rb1Djm+4+eanqXY3ZkW2oiiwA=],
serviceCode=null,
isAdmin=null,
loginName=null,
serialVersionUID=@Long[8229738167949958388],
token=@String[54158a08d8104de57a855249eb6ffe06],
serialVersionUID=@Long[-4556824360581761962],
appId=null,
subAccountUin=null,
uin=null,
requestId=null,
region=null,
kv=null,
],
]
method=com.tencent.cloud.access.sso.service.impl.AuthenticateService.login location=AtExit
ts=2021-09-03 14:10:15; [cost=9.571541ms] result=@ArrayList[
@Object[][
@LoginRequest[com.tencent.cloud.access.sso.model.LoginRequest@3dd2bbb0],
],
@AuthenticateService[
log=@Logger[Logger[com.tencent.cloud.access.sso.service.impl.AuthenticateService]],
sessionDAO=@RedisSessionDAO[com.tencent.cloud.access.sso.shiro.RedisSessionDAO@61813e98],
accountSessionService=@AccountSessionService[com.tencent.cloud.access.account.service.impl.AccountSessionService@30e815ac],
accessAuthRealm=@AccessAuthRealm[com.tencent.cloud.access.sso.shiro.AccessAuthRealm@1faea5],
accountService=@AccountService[com.tencent.cloud.access.account.service.impl.AccountService@197459d8],
ssoProperties=@SsoProperties[com.tencent.cloud.access.sso.config.SsoProperties@461879b2],
securityManager=@DefaultSecurityManager[org.apache.shiro.mgt.DefaultSecurityManager@3b0f92f0],
ssoService=@QCloudSsoService[com.tencent.cloud.access.sso.service.impl.QCloudSsoService@4f8704f5],
userService=@UserService[com.tencent.cloud.access.user.service.impl.UserService@5e69da74],
],
@AuthenticationResponse[
serialVersionUID=@Long[-6134589862066278677],
token=@String[54158a08d8104de57a855249eb6ffe06],
accountId=@String[account-96a79v5b],
changePwd=@String[N],
users=@ArrayList[isEmpty=false;size=1],
],
]
..............
watch 指令的-x选项表示解析三个阶段的对象深度，默认值为 1，也就是只解析到对象层，不解析对象的下一级属性等信息。
通过上述指令，我们获取到了更加详细的入参、this对象、返回值的信息，依次解析如下：
params 方法入参：
- @String[qcloudAdmin]: 参数一，用户名
- @String[Bgi8c0yC+IAvRLkuQRy6kLQ6T2J/9PNrL6G/+KX9ppE=]: 密码加密串
- @String[127.0.0.1]: 来源主机信息
this方法体内部对象：
- log=@Logger: 定义 Logger 对象
- sessionDAO=@RedisSessionDAO: 会话session数据入口，为 RedisSessionDAO 对象
- accountSessionService=@AccountSessionService: 私有对象........
returnObj 返回值对象，这里为@AccessAuthPrincipal对象：
- serialVersionUID: 用户
- UIDaccountName: 登录用户名
- password: 用户密码加密串token: token串
- ........
条件表达式过滤
[arthas@5201]$ watch com.tencent.cloud.access.sso.service.impl.AuthenticateService login '{params[0]=qcloudAdmin,returnObj}' -x 2
诊断返回信息包含params[0]和returnObj对象，而且仅获取入参params[0] == "qcloudAdmin"的方法调用，最后解析深度为 2。
只有满足条件的调用，才会被 Arthas 捕获到。
观察异常信息
[arthas@5201]$ watch com.tencent.cloud.access.sso.service.impl.AuthenticateService login '{params[0],throwExp}' -e -x 2
- -e: 表示在抛出异常之后观察
- express观察表达式第二个参数
throwExp: 表示异常信息的变量是throwExp
按方法执行耗时进行过滤
[arthas@5201]$ watch com.tencent.cloud.access.sso.service.impl.AuthenticateService login '{params[0],returnObj}' '#cost>200' -x 2
watch指令的第四个参数 condition-express 为#cost>200，表示诊断处理耗时大于 200ms 才会被捕获输出。-x 2: 解析深度为 2。
仅观察当前对象的属性
[arthas@5201]$ watch com.tencent.cloud.access.sso.service.impl.AuthenticateService login 'target' -x 3
Press Q or Ctrl+C to abort.
Affect(class count: 1 , method count: 2) cost in 76 ms, listenerId: 23
method=com.tencent.cloud.access.sso.service.impl.AuthenticateService.login location=AtExit
ts=2021-09-03 14:48:33; [cost=3.189525ms] result=@AuthenticateService[
log=@Logger[
serialVersionUID=@Long[5454405123156820674],
FQCN=@String[ch.qos.logback.classic.Logger],
name=@String[com.tencent.cloud.access.sso.service.impl.AuthenticateService],
level=null,
effectiveLevelInt=@Integer[20000],
parent=@Logger[
serialVersionUID=@Long[5454405123156820674],
FQCN=@String[ch.qos.logback.classic.Logger],
name=@String[com.tencent.cloud.access.sso.service.impl],
level=null,
effectiveLevelInt=@Integer[20000],
parent=@Logger[Logger[com.tencent.cloud.access.sso.service]],
childrenList=@CopyOnWriteArrayList[isEmpty=false;size=2],
aai=null,
additive=@Boolean[true],
loggerContext=@LoggerContext[ch.qos.logback.classic.LoggerContext[default]],
],
childrenList=null,
aai=null,
additive=@Boolean[true],
loggerContext=@LoggerContext[
DEFAULT_PACKAGING_DATA=@Boolean[false],
root=@Logger[Logger[ROOT]],
size=@Integer[501],
noAppenderWarning=@Integer[0],
loggerContextListenerList=@ArrayList[isEmpty=false;size=1],
loggerCache=@ConcurrentHashMap[isEmpty=false;size=501],
loggerContextRemoteView=@LoggerContextVO[LoggerContextVO{name='default', propertyMap={}, birthTime=1630634095948}],
turboFilterList=@TurboFilterList[isEmpty=true;size=0],
packagingDataEnabled=@Boolean[false],
maxCallerDataDepth=@Integer[8],
resetCount=@Integer[2],
frameworkPackages=@ArrayList[isEmpty=true;size=0],
birthTime=@Long[1630634095948],
name=@String[default],
sm=@BasicStatusManager[ch.qos.logback.core.BasicStatusManager@612c57fb],
propertyMap=@HashMap[isEmpty=true;size=0],
objectMap=@HashMap[isEmpty=false;size=6],
configurationLock=@LogbackLock[ch.qos.logback.core.spi.LogbackLock@36566db5],
scheduledExecutorService=null,
scheduledFutures=@ArrayList[isEmpty=true;size=0],
lifeCycleManager=@LifeCycleManager[ch.qos.logback.core.LifeCycleManager@44477e6],
started=@Boolean[false],
],
],
sessionDAO=@RedisSessionDAO[
.............
扩展思维，我们可以直接透过一次调用，观察到底层连接 jdbc 的信息：
[arthas@5201]$ watch com.tencent.cloud.access.sso.service.impl.AuthenticateService login 'target.userService.userDao.jdbcTemplate.dataSource.pool.poolProperties.url' -x 2
Press Q or Ctrl+C to abort.
Affect(class count: 1 , method count: 2) cost in 69 ms, listenerId: 34
method=com.tencent.cloud.access.sso.service.impl.AuthenticateService.login location=AtExit
ts=2021-09-03 15:09:55; [cost=2.682966ms] result=@String[jdbc:mysql://*.*.*.*:3306/access_auth?useSSL=false&characterEncoding=utf8]
method=com.tencent.cloud.access.sso.service.impl.AuthenticateService.login location=AtExit
ts=2021-09-03 15:09:55; [cost=21.373065ms] result=@String[jdbc:mysql://*.*.*.*:3306/access_auth?useSSL=false&characterEncoding=utf8]
这里就从顶层往下，获取到了该次调用，涉及到查库的 jdbc dataSource 连接配置信息。
result返回的是一个 String 类型对象，值为 jdbc:mysql://*.*.*.*:3306/access_auth?useSSL=false&characterEncoding=utf8。
排除指定的类
[arthas@5201]$ watch com.tencent.cloud.access.sso.service.impl.* * 'target' -x 1 --exclude-class-pattern AuthorizeService | grep --color AuthorizeService Press Q or Ctrl+C to abort.
--exclude-class-pattern：排除指定的类
Trace 指令 ⭐
方法内部调用路径，并输出方法路径上的每个节点上耗时
trace 命令能主动搜索 class-pattern／method-pattern 对应的方法调用路径，渲染和统计整个调用链路上的所有性能开销和追踪调用链路
参数说明
| 参数名称 | 参数说明 |
|---|---|
| class-pattern | 类名表达式匹配 |
| method-pattern | 方法名表达式匹配 |
| condition-express | 条件表达式 |
| [E] | 开启正则表达式匹配，默认为通配符匹配 |
| [n:] | 命令执行次数 |
| #cost | 方法执行耗时 |
这里重点要说明的是观察表达式，观察表达式的构成主要由 #OGNL 表达式组成，所以你可以这样写"{params,returnObj}"，只要是一个合法的 ognl 表达式，都能被正常支持。
观察的维度也比较多，主要体现在参数 advice 的数据结构上。Advice 参数最主要是封装了通知节点的所有信息。
请参考表达式核心变量中关于该节点的描述。
- 特殊用法请参考：https://github.com/alibaba/arthas/issues/71
- OGNL表达式官网：https://commons.apache.org/proper/commons-ognl/language-guide.html
很多时候我们只想看到某个方法的rt大于某个时间之后的trace结果，现在Arthas可以按照方法执行的耗时来进行过滤了，例如trace *StringUtils isBlank '#cost>100'表示当执行时间超过100ms的时候，才会输出trace的结果。
watch/stack/trace这个三个命令都支持#cost
使用举例：
[arthas@5201]$ trace com.tencent.cloud.access.sso.service.impl.AuthenticateService login
Press Q or Ctrl+C to abort.
Affect(class count: 1 , method count: 2) cost in 114 ms, listenerId: 49
`---ts=2021-09-03 15:37:52;thread_name=http-nio-7001-exec-5;id=18;is_daemon=true;priority=5;TCCL=org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedWebappClassLoader@1cfd053
`---[6.69059ms] com.tencent.cloud.access.sso.service.impl.AuthenticateService:login()
+---[0.045058ms] com.tencent.cloud.access.sso.model.LoginRequest:getOpt() #87
+---[0.011503ms] com.tencent.cloud.access.sso.constant.LoginType:getType() #88
+---[0.004858ms] com.tencent.cloud.access.sso.constant.LoginType:getType() #89
+---[0.005082ms] com.tencent.cloud.access.sso.model.LoginRequest:getAccountName() #93
+---[0.005074ms] com.tencent.cloud.access.sso.model.LoginRequest:getPassword() #94
+---[min=0.002257ms,max=0.010395ms,total=0.012652ms,count=2] org.springframework.util.StringUtils:isEmpty() #95
+---[0.008128ms] com.tencent.cloud.access.sso.config.SsoProperties:isPasswordTextPrintable() #100
+---[0.084201ms] org.slf4j.Logger:info() #99
+---[0.00653ms] com.tencent.cloud.access.sso.model.AuthenticationResponse:<init>() #101
+---[0.004871ms] com.tencent.cloud.access.sso.model.LoginRequest:getRemoteHost() #102
+---[3.317607ms] com.tencent.cloud.access.sso.service.impl.AuthenticateService:login() #102
| `---[3.285177ms] com.tencent.cloud.access.sso.service.impl.AuthenticateService:login()
| +---[0.008045ms] org.apache.shiro.authc.UsernamePasswordToken:<init>() #139
| +---[0.011232ms] org.apache.shiro.subject.SimplePrincipalCollection:<init>() #141
| +---[0.00843ms] org.apache.shiro.subject.support.DelegatingSubject:<init>() #142
| +---[0.015667ms] org.apache.shiro.util.ThreadContext:bind() #143
| +---[1.051658ms] org.apache.shiro.subject.support.DelegatingSubject:login() #144
| +---[0.988623ms] org.apache.shiro.subject.support.DelegatingSubject:getSession() #145
| +---[0.015629ms] org.apache.shiro.session.Session:getId() #146
| +---[0.323618ms] org.apache.shiro.subject.support.DelegatingSubject:getPrincipal() #147
| +---[0.009258ms] com.tencent.cloud.access.sso.model.AccessAuthPrincipal:setToken() #149
| +---[0.007608ms] com.tencent.cloud.access.sso.model.AccessAuthPrincipal:setAccountName() #150
| +---[0.429798ms] org.apache.shiro.session.Session:setAttribute() #151
| `---[0.207347ms] com.tencent.cloud.access.account.service.IAccountSessionService:bind() #152
+---[0.010654ms] com.tencent.cloud.access.account.Account:<init>() #103
+---[0.824315ms] com.tencent.cloud.access.account.service.IAccountService:find() #103
+---[0.006474ms] com.tencent.cloud.access.account.Account:getLock() #104
+---[0.004144ms] com.tencent.cloud.access.account.Account:getChangePassword() #107
+---[0.005663ms] com.tencent.cloud.access.sso.model.AuthenticationResponse:setChangePwd() #107
+---[0.004683ms] com.tencent.cloud.access.sso.model.AccessAuthPrincipal:getToken() #108
+---[0.00414ms] com.tencent.cloud.access.sso.model.AuthenticationResponse:setToken() #108
+---[0.003733ms] com.tencent.cloud.access.account.Account:getAccountId() #109
+---[0.005164ms] com.tencent.cloud.access.sso.model.AuthenticationResponse:setAccountId() #109
+---[0.002866ms] com.tencent.cloud.access.sso.model.AccessAuthPrincipal:setAccountName() #110
+---[0.00399ms] com.tencent.cloud.access.sso.model.AccessAuthPrincipal:getAccountId() #112
+---[0.014922ms] com.tencent.cloud.access.user.User:<init>() #112
+---[0.004781ms] com.tencent.cloud.access.user.User:setAppIsolate() #113
+---[0.83272ms] com.tencent.cloud.access.user.service.IUserService:findAccountList() #114
+---[0.006398ms] com.tencent.cloud.access.user.User:getUserId() #116
+---[0.005214ms] com.tencent.cloud.access.sso.model.AccessAuthPrincipal:setUserId() #116
+---[0.00349ms] com.tencent.cloud.access.sso.model.AccessAuthPrincipal:getToken() #118
+---[0.002987ms] com.tencent.cloud.access.user.User:getUserId() #118
+---[0.887095ms] com.tencent.cloud.access.sso.service.impl.AuthenticateService:updateSession() #118
`---[0.004734ms] com.tencent.cloud.access.sso.model.AuthenticationResponse:setUsers() #120
`---ts=2021-09-03 15:37:52;thread_name=http-nio-7001-exec-1;id=14;is_daemon=true;priority=5;TCCL=org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedWebappClassLoader@1cfd053
`---[1.28437ms] com.tencent.cloud.access.sso.service.impl.AuthenticateService:login()
+---[0.003596ms] com.tencent.cloud.access.sso.model.LoginRequest:getOpt() #87
+---[0.006076ms] com.tencent.cloud.access.sso.constant.LoginType:getType() #88
+---[0.002865ms] com.tencent.cloud.access.sso.constant.LoginType:getType() #89
+---[0.010558ms] com.tencent.cloud.access.sso.model.LoginRequest:getAccessToken() #123
+---[0.003959ms] com.tencent.cloud.access.sso.model.LoginRequest:getUid() #124
+---[0.003368ms] org.springframework.util.StringUtils:isEmpty() #125
+---[0.002671ms] org.springframework.util.StringUtils:isEmpty() #128
`---[1.166953ms] com.tencent.cloud.access.sso.service.impl.AuthenticateService:updateSession() #131
耗时过滤诊断
[arthas@5201]$ trace com.tencent.cloud.access.sso.service.impl.AuthenticateService login '#cost > 2000'
#cost > 2000: 仅捕获开销时间大于 2000ms 的路径。
仅过滤方法一次调用
[arthas@5201]$ trace com.tencent.cloud.access.sso.service.impl.AuthenticateService login -n 1
仅捕获一次指定方法的调用，然后退出任务。
sysprop 指令 -- 获取/设置进程系统属性
sysprop 主要用来查看、设置当前进程的系统属性信息。
使用举例
查看当前java进程的系统属性
[arthas@27878]$ sysprop
KEY VALUE
-------------------------------------------------------------------------
awt.toolkit sun.awt.X11.XToolkit
file.encoding.pkg sun.io
java.specification.version 1.8
sun.cpu.isalist
sun.jnu.encoding UTF-8
java.class.path /data/tsf/tsf-oss/tsf-ratelimit/tsf-ratelimit-1.29.1/lib/tsf-ratelimit-1.29.1.jar
java.vm.vendor Tencent
sun.arch.data.model 64
java.vendor.url http://jdk.oa.com/
catalina.useNaming false
user.timezone Asia/Shanghai
org.jboss.logging.provider slf4j
os.name Linux
java.vm.specification.version 1.8
@appId tsf-ratelimit
user.country US
sun.java.launcher SUN_STANDARD
sun.boot.library.path /data/TencentKona-8.0.2-252/jre/lib/amd64
sun.java.command /data/tsf/tsf-oss/tsf-ratelimit/tsf-ratelimit-1.29.1/lib/tsf-ratelimit-1.29.1.jar
sun.cpu.endian little
user.home /root
user.language en
java.specification.vendor Oracle Corporation
java.home /data/TencentKona-8.0.2-252/jre
file.separator /
line.separator
java.vm.specification.vendor Oracle Corporation
java.specification.name Java Platform API Specification
java.awt.graphicsenv sun.awt.X11GraphicsEnvironment
java.awt.headless true
LOG_LEVEL_PATTERN %5p [bootstrap,%X{X-B3-TraceId:-},%X{X-B3-SpanId:-},%X{X-Span-Export:-}]
sun.boot.class.path /data/TencentKona-8.0.2-252/jre/lib/resources.jar:/data/TencentKona-8.0.2-252/jre/lib/rt.jar:/data/TencentKona-8.0.2-252/jre/lib/sunrsasign.jar:/data/TencentKona-8.0.2-252/jre/lib/jsse.jar:/data/TencentKona-8.0.2-2
52/jre/lib/jce.jar:/data/TencentKona-8.0.2-252/jre/lib/charsets.jar:/data/TencentKona-8.0.2-252/jre/lib/jfr.jar:/data/TencentKona-8.0.2-252/jre/classes
java.protocol.handler.pkgs org.springframework.boot.loader
sun.management.compiler HotSpot 64-Bit Tiered Compilers
java.runtime.version 1.8.0_252-b1
java.net.preferIPv4Stack true
user.name root
path.separator :
os.version 3.10.0-1127.19.1.el7.x86_64
java.endorsed.dirs /data/TencentKona-8.0.2-252/jre/lib/endorsed
java.runtime.name OpenJDK Runtime Environment
file.encoding UTF-8
spring.beaninfo.ignore true
sun.nio.ch.bugLevel
java.vm.name OpenJDK 64-Bit Server VM
LOG_FILE /var/log/tsf-oss/tsf-ratelimit/tsf-ratelimit
java.vendor.url.bug http://ce.oa.com/bia
java.io.tmpdir /tmp
catalina.home /tmp/tomcat.8220305148167761737.23000
java.version 1.8.0_252
user.dir /data/tsf/tsf-oss/tsf-ratelimit/tsf-ratelimit-1.29.1
os.arch amd64
PID 27878
java.vm.specification.name Java Virtual Machine Specification
java.awt.printerjob sun.print.PSPrinterJob
sun.os.patch.level unknown
catalina.base /tmp/tomcat.8220305148167761737.23000
loader.path /data/tsf/tsf-oss/tsf-ratelimit/tsf-ratelimit-1.29.1/config
java.library.path /data/tsf/tsf-oss/tsf-ratelimit/tsf-ratelimit-1.29.1/lib::/usr/java/packages/lib/amd64:/usr/lib64:/lib64:/lib:/usr/lib
java.vm.info mixed mode, sharing
java.vendor Tencent
java.vm.version 25.252-b1
java.ext.dirs /data/TencentKona-8.0.2-252/jre/lib/ext:/usr/java/packages/lib/ext
sun.io.unicode.encoding UnicodeLittle
java.class.version 52.0
临时设置当前进程的系统属性
[arthas@29749]$ sysprop java.class.path /data/jdk/latest Successfully changed the system property. KEY VALUE ----------------------------------------------------------------------------------- java.class.path /data/jdk/latest
logger 指令 -- *查看or设置logger
参数说明
[arthas@29749]$ logger -h
USAGE:
logger [-c <value>] [--classLoaderClass <value>] [-h] [--include-no-appender] [-l <value>] [-n <value>]
SUMMARY:
Print logger info, and update the logger level
Examples:
logger
logger -c 327a647b
logger -c 327a647b --name ROOT --level debug
logger --include-no-appender
WIKI:
https://arthas.aliyun.com/doc/logger
OPTIONS:
-c, --classloader <value> classLoader hashcode, if no value is set, default value is SystemClassLoader
--classLoaderClass <value> The class name of the special class's classLoader.
-h, --help this help
--include-no-appender include the loggers which don't have appenders, default value false
-l, --level <value> set logger level
-n, --name <value> logger name
使用举例
设置 logger 的 ROOT appender 的日志级别
##### 获取 logger 类信息 [arthas@29749]$ logger name ROOT class ch.qos.logback.classic.Logger classLoader org.springframework.boot.loader.LaunchedURLClassLoader@5674cd4d classLoaderHash 5674cd4d level INFO effectiveLevel INFO ...................... ##### 设置 ROOT 名称日志级别为 DEBUG [arthas@29749]$ logger -c 5674cd4d -n ROOT -l DEBUG
heapdump 指令 -- 堆转储
参数说明
[arthas@29749]$ heapdump -h USAGE: heapdump [-h] [-l] [file] SUMMARY: Heap dump Examples: heapdump ## hprof 文件保存到当前目录下 heapdump --live ## 活跃对象 heapdump --live /tmp/dump.hprof WIKI: https://arthas.aliyun.com/doc/heapdump OPTIONS: -h, --help this help -l, --live Dump only live objects; if not specified, all objects in the heap are dumped. <file> Output file
sc 指令 -- 获取已加载类列表
参数说明
[arthas@29749]$ sc -h
USAGE:
sc [-c <value>] [--classLoaderClass <value>] [-d] [-x <value>] [-f] [-h] [-n <value>] [-E] class-pattern
SUMMARY:
Search all the classes loaded by JVM
EXAMPLES:
sc -d org.apache.commons.lang.StringUtils
sc -d org/apache/commons/lang/StringUtils
sc -d *StringUtils
sc -d -f org.apache.commons.lang.StringUtils
sc -E org\\.apache\\.commons\\.lang\\.StringUtils
WIKI:
https://arthas.aliyun.com/doc/sc
OPTIONS:
-c, --classloader <value> The hash code of the special class's classLoader
--classLoaderClass <value> The class name of the special class's classLoader.
-d, --details Display the details of class
-x, --expand <value> Expand level of object (0 by default)
-f, --field Display all the member variables
-h, --help this help
-n, --limits <value> Maximum number of matching classes with details (100 by default)
-E, --regex Enable regular expression to match (wildcard matching by default)
<class-pattern> Class name pattern, use either '.' or '/' as separator
使用举例
#### 根据通配符获取已加载的包名类名列表 [arthas@29749]$ sc com.tencent.tsf.* com.sun.proxy.$Proxy132 com.sun.proxy.$Proxy143 com.tencent.tsf.TsfApplicationStarter com.tencent.tsf.TsfApplicationStarter$$EnhancerBySpringCGLIB$$e6e6d3dc com.tencent.tsf.common.TsfBaseEntity com.tencent.tsf.common.TsfPage com.tencent.tsf.common.TsfPageQuery com.tencent.tsf.common.aop.ControllerCommonLog ..............
-d 参数获取具体类的基础信息：
[arthas@29749]$ sc com.tencent.tsf.TsfApplicationStarter -d
class-info com.tencent.tsf.TsfApplicationStarter
code-source file:/data/tsf/tsf-oss/tsf-ratelimit/tsf-ratelimit-1.29.1/lib/tsf-ratelimit-1.29.1.jar!/BOOT-INF/lib/tsf-common-1.29.1.jar!/
name com.tencent.tsf.TsfApplicationStarter
isInterface false
isAnnotation false
isEnum false
isAnonymousClass false
isArray false
isLocalClass false
isMemberClass false
isPrimitive false
isSynthetic false
simple-name TsfApplicationStarter
modifier public
annotation org.springframework.boot.autoconfigure.SpringBootApplication,org.springframework.cloud.client.discovery.EnableDiscoveryClient,org.springframework.cloud.netflix.feign.EnableFeignClients,org.springframework.transaction.annotation.EnableTransactionManag
ement,org.springframework.scheduling.annotation.EnableScheduling,org.springframework.context.annotation.EnableAspectJAutoProxy
interfaces
super-class +-java.lang.Object
class-loader +-org.springframework.boot.loader.LaunchedURLClassLoader@5674cd4d
+-sun.misc.Launcher$AppClassLoader@70dea4e
+-sun.misc.Launcher$ExtClassLoader@65e2dbf3
classLoaderHash 5674cd4d
class-info com.tencent.tsf.TsfApplicationStarter$$EnhancerBySpringCGLIB$$e6e6d3dc
code-source file:/data/tsf/tsf-oss/tsf-ratelimit/tsf-ratelimit-1.29.1/lib/tsf-ratelimit-1.29.1.jar!/BOOT-INF/lib/tsf-common-1.29.1.jar!/
name com.tencent.tsf.TsfApplicationStarter$$EnhancerBySpringCGLIB$$e6e6d3dc
isInterface false
isAnnotation false
isEnum false
isAnonymousClass false
isArray false
isLocalClass false
isMemberClass false
isPrimitive false
isSynthetic false
simple-name TsfApplicationStarter$$EnhancerBySpringCGLIB$$e6e6d3dc
modifier public
annotation
interfaces org.springframework.context.annotation.ConfigurationClassEnhancer$EnhancedConfiguration
super-class +-com.tencent.tsf.TsfApplicationStarter
+-java.lang.Object
class-loader +-org.springframework.boot.loader.LaunchedURLClassLoader@5674cd4d
+-sun.misc.Launcher$AppClassLoader@70dea4e
+-sun.misc.Launcher$ExtClassLoader@65e2dbf3
classLoaderHash 5674cd4d
Affect(row-cnt:2) cost in 17 ms.
sm 指令 -- 获取指定类的method信息
该指令参数与 sc 指令参数类似。
使用举例：
## 获取 com.tencent.tsf.common.TsfPageQuery 类的所有方法列表 [arthas@29749]$ sm com.tencent.tsf.common.TsfPageQuery * com.tencent.tsf.ratelimit.domain.Ratelimit <init>(Lcom/tencent/tsf/ratelimit/domain/Ratelimit;)V com.tencent.tsf.ratelimit.domain.Ratelimit <init>()V com.tencent.tsf.ratelimit.domain.Ratelimit toString()Ljava/lang/String; com.tencent.tsf.ratelimit.domain.Ratelimit getRules()Ljava/util/List; com.tencent.tsf.ratelimit.domain.Ratelimit lambda$containsIn$0(Lcom/tencent/tsf/ratelimit/domain/Ratelimit$Rule;Lcom/tencent/tsf/ratelimit/domain/Ratelimit$Rule;)Z com.tencent.tsf.ratelimit.domain.Ratelimit setRules(Ljava/util/List;)V com.tencent.tsf.ratelimit.domain.Ratelimit isValidRequest(Z)Z com.tencent.tsf.ratelimit.domain.Ratelimit getRequestIdentity()Ljava/lang/String; com.tencent.tsf.ratelimit.domain.Ratelimit setNamespaceId(Ljava/lang/String;)V com.tencent.tsf.ratelimit.domain.Ratelimit containsIn(Ljava/util/List;)Z com.tencent.tsf.ratelimit.domain.Ratelimit isDimensionConflict(Ljava/util/List;)Z com.tencent.tsf.ratelimit.domain.Ratelimit getNamespaceId()Ljava/lang/String; com.tencent.tsf.ratelimit.domain.Ratelimit getServiceName()Ljava/lang/String; com.tencent.tsf.ratelimit.domain.Ratelimit setServiceName(Ljava/lang/String;)V com.tencent.tsf.common.proxy.Application <init>()V com.tencent.tsf.common.proxy.Application setApplicationId(Ljava/lang/String;)V com.tencent.tsf.common.proxy.Application getMicroserviceType()Ljava/lang/String; com.tencent.tsf.common.proxy.Application setMicroserviceType(Ljava/lang/String;)V com.tencent.tsf.common.proxy.Application getApplicationId()Ljava/lang/String; com.tencent.tsf.ratelimit.proxy.Microservice <init>()V com.tencent.tsf.ratelimit.proxy.Microservice setMicroserviceName(Ljava/lang/String;)V com.tencent.tsf.ratelimit.proxy.Microservice setNamespaceId(Ljava/lang/String;)V com.tencent.tsf.ratelimit.proxy.Microservice getMicroserviceName()Ljava/lang/String; com.tencent.tsf.ratelimit.proxy.Microservice getNamespaceId()Ljava/lang/String; com.tencent.tsf.ratelimit.proxy.Microservice getMicroserviceId()Ljava/lang/String; com.tencent.tsf.ratelimit.proxy.Microservice setMicroserviceId(Ljava/lang/String;)V com.tencent.tsf.common.TsfPageQuery <init>()V com.tencent.tsf.common.TsfPageQuery clear()V com.tencent.tsf.common.TsfPageQuery getOffset()Ljava/lang/Integer; com.tencent.tsf.common.TsfPageQuery setOffset(Ljava/lang/Integer;)V com.tencent.tsf.common.TsfPageQuery initDefault()V com.tencent.tsf.common.TsfPageQuery setSearchWord(Ljava/lang/String;)V com.tencent.tsf.common.TsfPageQuery getOrderType()Ljava/lang/Integer; com.tencent.tsf.common.TsfPageQuery getOrderTypeStr()Ljava/lang/String; com.tencent.tsf.common.TsfPageQuery setOrderType(Ljava/lang/Integer;)V com.tencent.tsf.common.TsfPageQuery getOrderBy()Ljava/lang/String; com.tencent.tsf.common.TsfPageQuery setOrderBy(Ljava/lang/String;)V com.tencent.tsf.common.TsfPageQuery getRealPage()I com.tencent.tsf.common.TsfPageQuery transerPageQuery(Lcom/tencent/tsf/common/TsfPageQuery;)V com.tencent.tsf.common.TsfPageQuery getSearchWordLikeStr()Ljava/lang/String; com.tencent.tsf.common.TsfPageQuery getLimit()Ljava/lang/Integer; com.tencent.tsf.common.TsfPageQuery setLimit(Ljava/lang/Integer;)V com.tencent.tsf.common.TsfPageQuery getSearchWord()Ljava/lang/String; Affect(row-cnt:43) cost in 12 ms.
monitor 指令 -- 方法执行监控
该指令为非实时返回指令，默认 120s 返回一次统计值。
统计区间时间段内，方法执行的总数、成功次数、失败次数、平均执行率、失败比例 等信息。
参数说明
[arthas@8738]$ monitor -h
USAGE:
monitor [-b] [-c <value>] [--exclude-class-pattern <value>] [-h] [-n <value>] [--listenerId <value>] [-E <value>] [-v] class-pattern method-pattern [condition-express]
SUMMARY:
Monitor method execution statistics, e.g. total/success/failure count, average rt, fail rate, etc.
Examples:
monitor org.apache.commons.lang.StringUtils isBlank
monitor org.apache.commons.lang.StringUtils isBlank -c 5
monitor org.apache.commons.lang.StringUtils isBlank params[0]!=null
monitor -b org.apache.commons.lang.StringUtils isBlank params[0]!=null
monitor -E org\.apache\.commons\.lang\.StringUtils isBlank
WIKI:
https://arthas.aliyun.com/doc/monitor
OPTIONS:
-b, --before Evaluate the condition-express before method invoke
-c, --cycle <value> The monitor interval (in seconds), 60 seconds by default
--exclude-class-pattern <value> exclude class name pattern, use either '.' or '/' as separator
-h, --help this help
-n, --limits <value> Threshold of execution times
--listenerId <value> The special listenerId
-E, --regex <value> Enable regular expression to match (wildcard matching by default)
-v, --verbose Enables print verbose information, default value false.
<class-pattern> Path and classname of Pattern Matching
<method-pattern> Method of Pattern Matching
<condition-express> Conditional expression in ognl style, for example:
TRUE : 1==1
TRUE : true
FALSE : false
TRUE : 'params.length>=0'
FALSE : 1==2
'#cost>100'
使用举例
[arthas@8738]$ monitor com.tencent.tsf.resource.ns.dao.NamespaceDao * Press Q or Ctrl+C to abort. Affect(class count: 1 , method count: 15) cost in 104 ms, listenerId: 6 timestamp class method total success fail avg-rt(ms) fail-rate ---------------------------------------------------------------------------------------------------------------------------------------------------- 2021-09-09 18:26:58 com.tencent.tsf.resource.ns.dao.NamespaceDao countList 12 12 0 1.08 0.00% 2021-09-09 18:26:58 com.tencent.tsf.resource.ns.dao.NamespaceDao getAuthWhereClause 28 28 0 0.18 0.00% 2021-09-09 18:26:58 com.tencent.tsf.resource.ns.dao.NamespaceDao findList 2 2 0 1.09 0.00%
到此这篇关于Arthas在线java进程诊断工具 在线调试神器的文章就介绍到这了,更多相关Arthas在线java进程诊断工具 在线调试神器内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！
相关推荐
-
java定位死锁的三种方法（jstack、Arthas和Jvisualvm）
目录 死锁 死锁发生的原因 死锁发生的条件 1:通过jstack定位死锁信息 1.2:查看死锁线程的pid 2:通过Arthas工具定位死锁 3. 通过 Jvisualvm 定位死锁 死锁的预防 总结 死锁 死锁:是指两个或两个以上的进程在执行过程中,因争夺资源而造成的一种互相等待的现象,若无外力作用,它们都将无法推进下去. 死锁发生的原因 死锁的发生是由于资源竞争导致的,导致死锁的原因如下: 系统资源不足,如果系统资源充足,死锁出现的可能性就很低. 进程(线程)运行推进的顺序不合适. 资源分配
-
使用arthas命令redefine实现Java热更新(推荐)
arthas 是一个 Java 开源诊断神器. 今天分享一个非常重要的命令 redefine ,主要作用是加载外部的 .class 文件,用来替换 JVM 已经加载的类,总结起来就是实现了 Java 的热更新. redefine 在一下几种情况中会失败:1.增加了 field :2.增加了 method :3.替换正在运行的方法. 前两个比较好理解,第三个意思就是这个方法必须结束之后才会被替换,如果有个方法开始运行之后就不会跳出,那么这个方法所在的类是无法被替换的,类似无限循环的方法. 中间提到
-
Java动态追踪技术探究之从JSP到Arthas
从JSP说起 对于大多数Java程序员来说,早期的时候,都会接触到一个叫做JSP(Java Server Pages)的技术.虽然这种技术,在前后端代码分离.前后端逻辑分离.前后端组织架构分离的今天来看,已经过时了,但是其中还是有一些有意思的东西,值得拿出来说一说. 当时刚刚处于Java入门时期的我们,大多数精力似乎都放在了JSP的页面展示效果上了: "这个表格显示的行数不对" "原来是for循环写的有问题,改一下,刷新页面再试一遍" "嗯,好了,表格显示
-
Java开源诊断工具Arthas使用方法详解
一.前言 1.热更新代码的场景 (1)当线上服务器出现问题时,有些时候现有的手段不足以发现问题所在,可能需要追加打印日志或者增加一些调试代码,如果我们去改代码重新部署,会破坏问题现场,可以通过热部署的手段来增加调试代码 (2)线上出现紧急bug,通过Review代码找到问题,修改好后打包部署的流程可能比较久,可以通过热部署代码及时解决问题 二.使用阿里巴巴开源的Java诊断工具 ---Arthas,他可以附着在我们的Java服务器进程上面,查看服务器状态,jvm状态等各种参数指标,还可以进行热更
-
Arthas在线java进程诊断工具在线调试神器详解
`Arthas` 是 Alibaba 开源的Java诊断工具,深受开发者喜爱. 当你遇到以下类似问题而束手无策时,`Arthas`可以帮助你解决: 1. 这个类从哪个 jar 包加载的?为什么会报各种类相关的 Exception? 2. 我改的代码为什么没有执行到?难道是我没 commit?分支搞错了? 3. 遇到问题无法在线上 debug,难道只能通过加日志再重新发布吗? 4. 线上遇到某个用户的数据处理有问题,但线上同样无法 debug,线下无法重现! 5. 是否有一个全局视角来查看系统的运
-
Java进程内缓存框架EhCache详解
目录 一:目录 二: 简介 2.1.基本介绍 2.2.主要的特性 2.3. 集成 2.4. ehcache 和 redis 比较 三:事例 3.1.在pom.xml中引入依赖 3.2.在src/main/resources/创建一个配置文件 ehcache.xml 3.3.测试类 3.4.缓存配置 一:xml配置方式: 二:编程方式配置 3.5.Ehcache API 四:Spring整合 4.1.pom.xml 引入spring和ehcache 4.2.在src/main/resources添
-
Java异步编程工具Twitter Future详解
目录 异步编程(Twitter Future) 为啥要异步 基本用法 1.封装计算逻辑,异步返回. 2.异步计算结果串联异步处理 3.并行多个异步任务,统一等待结果 4.异步错误处理 Twitter包装 pom依赖 1.封装计算逻辑,异步返回 2.异步计算结果串联异步处理 3.并行多个异步任务 4.错误处理 其他用法 其他工具 异步编程(Twitter Future) 为啥要异步 异步编程有点难以理解,这东西感觉不符合常理,因为我们思考都是按照串行的逻辑,事都是一件一件办.但在异步计算的情况下,
-
Java多线程同步工具类CountDownLatch详解
目录 简介 核心方法 CountDownLatch如何使用 CountDownLatch运行流程 运用场景 总结 简介 CountDownLatch是一个多线程同步工具类,在多线程环境中它允许多个线程处于等待状态,直到前面的线程执行结束.从类名上看CountDown既是数量递减的意思,我们可以把它理解为计数器. 核心方法 countDown():计数器递减方法. await():使调用此方法的线程进入等待状态,直到计数器计数为0时主线程才会被唤醒. await(long, TimeUnit):在
-
Java日期处理工具类DateUtils详解
本文实例为大家分享了Java日期处理工具类DateUtils的具体代码,供大家参考,具体内容如下 import java.sql.Timestamp; import java.text.ParseException; import java.text.SimpleDateFormat; import java.util.Calendar; import java.util.Date; /** * <日期时间处理工具类> */ public class DateUtils { /** * Dat
-
Java操作XML工具类XmlUtil详解
本文实例为大家分享了Java操作XML工具类的具体代码,供大家参考,具体内容如下 一.代码 public class XmlUtil { /** * 将XML文件输出到指定的路径 * * @param doc * @param fileName * @throws Exception */ public static void outputXml(Document doc, String fileName) throws Exception { TransformerFactory tf = T
-
node进程管理工具PM2用法详解
PM2是node进程管理工具,可以利用它来简化很多node应用管理的繁琐任务,如性能监控.自动重启.负载均衡等,而且使用非常简单. 安装 npm install -g pm2 常用命令 $ npm install pm2 -g # 命令行安装 pm2 $ pm2 start app.js -i 4 #后台运行pm2,启动4个app.js # 也可以把'max' 参数传递给 start # 正确的进程数目依赖于Cpu的核心数目 $ pm2 start app.js --name my-api #
-
Java编码辅助工具Lombok用法详解
前言 在项目开发过程中,经常会涉及到一些调整很少但又必不可少的环节,比如实体类的Getter/Setter方法,ToString方法等.这时可以使用Lombok来避免这种重复的操作,减少非核心代码的臃肿,提高编码效率. 如何在IntelliJ IDEA中引入Lombok 安装Lombok 插件(否则在调用setter/getter方法时IDE会提示报错): File -> Settings -> Plugins 搜索Lombok Plugin完成安装. pom.xml中引入lombok依赖(其
-
Java编码辅助工具Mapstruct用法详解
前言 项目开发中,业务分层会涉及不同类型的Bean之间需要相互转换,如PO与DTO之间,PO与VO之间等.手动编码setter/getter各个对应属性,会显得臃肿繁琐.通过Mapstruct框架可简单方便地完成这一工作. 如何引入: IntelliJ IDEA中安装MapStruct Support插件:File -> Settings -> Plugins 搜索 MapStruct support 安装,同时File -> Settings -> Compiler ->
-
java property配置文件管理工具框架过程详解
这篇文章主要介绍了java property配置文件管理工具框架过程详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下 property property 是 java 实现的 property 框架. 特点 优雅地进行属性文件的读取和更新 写入属性文件后属性不乱序 灵活定义编码信息 使用 OO 的方式操作 property 文件 支持多级对象引用 快速开始 环境依赖 Maven 3.x Jdk 1.7+ Maven 引入依赖 <depende