Table of Contents

vmtool

TIP

@since 3.5.1

vmtool online tutorialopen in new window

vmtool uses the JVMTI to support getInstances in jvm and forceGc.

getInstances

$ 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

Through the --limit parameter, you can limit the number of return values to avoid pressure on the JVM when obtaining large data. The default value of limit is 10.

Specify classloader name

vmtool --action getInstances --classLoaderClass org.springframework.boot.loader.LaunchedURLClassLoader --className org.springframework.context.ApplicationContext

Specify classloader hash

The classloader that loads the class can be found through the sc command.

$ 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

Then use the -c/--classloader parameter to specify:

vmtool --action getInstances -c 19469ea2 --className org.springframework.context.ApplicationContext

Specify the number of expanded layers of returned results

TIP

The return result of the getInstances action is bound to the instances variable, which is an array.

The expansion level of the result can be specified by the -x/--expand parameter, the default value is 1.

vmtool --action getInstances -c 19469ea2 --className org.springframework.context.ApplicationContext -x 2

Execute expression

TIP

The return result of the getInstances action is bound to the instances variable, which is an array. The specified expression can be executed through the --express parameter.

vmtool --action getInstances --classLoaderClass org.springframework.boot.loader.LaunchedURLClassLoader --className org.springframework.context.ApplicationContext --express'instances[0].getBeanDefinitionNames()'

Force GC

vmtool --action forceGc
  • Use the vmoption command to dynamically turn on the PrintGC option.

interrupt 指定线程

The thread id is specified by the -t parameter. It can be obtained using the thread command.

vmtool --action interruptThread -t 1