arthas/site/docs/doc/vmtool.md
2023-04-19 11:32:31 +00:00

100 lines
3.2 KiB
Markdown

# vmtool
::: tip
@since 3.5.1
:::
[`vmtool`在线教程](https://arthas.aliyun.com/doc/arthas-tutorials.html?language=cn&id=command-vmtool)
`vmtool` 利用`JVMTI`接口,实现查询内存对象,强制 GC 等功能。
- [JVM Tool Interface](https://docs.oracle.com/javase/8/docs/platform/jvmti/jvmti.html)
## 获取对象
```bash
$ vmtool --action getInstances --className java.lang.String --limit 10
@String[][
@String[com/taobao/arthas/core/shell/session/Session],
@String[com.taobao.arthas.core.shell.session.Session],
@String[com/taobao/arthas/core/shell/session/Session],
@String[com/taobao/arthas/core/shell/session/Session],
@String[com/taobao/arthas/core/shell/session/Session.class],
@String[com/taobao/arthas/core/shell/session/Session.class],
@String[com/taobao/arthas/core/shell/session/Session.class],
@String[com/],
@String[java/util/concurrent/ConcurrentHashMap$ValueIterator],
@String[java/util/concurrent/locks/LockSupport],
]
```
::: tip
通过 `--limit`参数,可以限制返回值数量,避免获取超大数据时对 JVM 造成压力。默认值是 10。
:::
## 指定 classloader name
```bash
vmtool --action getInstances --classLoaderClass org.springframework.boot.loader.LaunchedURLClassLoader --className org.springframework.context.ApplicationContext
```
## 指定 classloader hash
可以通过`sc`命令查找到加载 class 的 classloader。
```bash
$ sc -d org.springframework.context.ApplicationContext
class-info org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext
code-source file:/private/tmp/demo-arthas-spring-boot.jar!/BOOT-INF/lib/spring-boot-1.5.13.RELEASE.jar!/
name org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext
...
class-loader +-org.springframework.boot.loader.LaunchedURLClassLoader@19469ea2
+-sun.misc.Launcher$AppClassLoader@75b84c92
+-sun.misc.Launcher$ExtClassLoader@4f023edb
classLoaderHash 19469ea2
```
然后用`-c`/`--classloader` 参数指定:
```bash
vmtool --action getInstances -c 19469ea2 --className org.springframework.context.ApplicationContext
```
## 指定返回结果展开层数
::: tip
`getInstances` action 返回结果绑定到`instances`变量上,它是数组。
通过 `-x`/`--expand` 参数可以指定结果的展开层次,默认值是 1。
:::
```bash
vmtool --action getInstances -c 19469ea2 --className org.springframework.context.ApplicationContext -x 2
```
## 执行表达式
::: tip
`getInstances` action 返回结果绑定到`instances`变量上,它是数组。可以通过`--express`参数执行指定的表达式。
:::
```bash
vmtool --action getInstances --classLoaderClass org.springframework.boot.loader.LaunchedURLClassLoader --className org.springframework.context.ApplicationContext --express 'instances[0].getBeanDefinitionNames()'
```
## 强制 GC
```bash
vmtool --action forceGc
```
- 可以结合 [`vmoption`](vmoption.md) 命令动态打开`PrintGC`开关。
## interrupt 指定线程
thread id 通过`-t`参数指定,可以使用 `thread`命令获取。
```bash
vmtool --action interruptThread -t 1
```