jcmd
是jdk自带的一个神器,能够很方便的对java程序进行profiling。jcmd其实可以替代很多常用的工具,比如jstak,jmap。接下来让我们了解下什么是jcmd,jcmd能够帮助我们定位什么问题?工作中我们如何使用jcmd。
从jdk7开始,jcmd就是jdk自带的一个工具。在正确配置了JDK的PATH的情况下,我们可以直接在命令行中执行jcmd
:
[root@vincent-testing ~]# jcmd -h
Usage: jcmd
or: jcmd -l
or: jcmd -h
command must be a valid jcmd command for the selected jvm.
Use the command "help" to see which commands are available.
If the pid is 0, commands will be sent to all Java processes.
The main class argument will be used to match (either partially
or fully) the class used to start Java.
If no options are given, lists Java processes (same as -p).
PerfCounter.print display the counters exposed by this process
-f read and execute commands from the file
-l list JVM processes on the local machine
-h this help
利用jcmd,我们能做很多事情,比如,抓现场堆栈(dump threads),抓运行时堆内存(dump heap),采集GC日志,定位高CPU占用问题等。
jcmd
jcmd -l
jcmd -h
描述
pid:接收诊断命令请求的进程ID。
main class :接收诊断命令请求的进程的main类。匹配进程时,main类名称中包含指定子字符串的任何进程均是匹配的。如果多个正在运行的Java进程共享同一个main类,诊断命令请求将会发送到所有的这些进程中。
command:接收诊断命令请求的进程的main类。匹配进程时,main类名称中包含指定子字符串的任何进程均是匹配的。如果多个正在运行的Java进程共享同一个main类,诊断命令请求将会发送到所有的这些进程中。
注意: 如果任何参数含有空格,你必须使用英文的单引号或双引号将其包围起来。 此外,你必须使用转义字符来转移参数中的单引号或双引号,以阻止操作系统shell处理这些引用标记。当然,你也可以在参数两侧加上单引号,然后在参数内使用双引号(或者,在参数两侧加上双引号,在参数中使用单引号)。
Perfcounter.print:打印目标Java进程上可用的性能计数器。性能计数器的列表可能会随着Java进程的不同而产生变化。
-f file:从文件file中读取命令,然后在目标Java进程上调用这些命令。在file中,每个命令必须写在单独的一行。以"#"开头的行会被忽略。当所有行的命令被调用完毕后,或者读取到含有stop关键字的命令,将会终止对file的处理。
-l:查看所有的进程列表信息。
-h:查看帮助信息。(同 -help)
在没有jcmd的时候,我们也有很多找出JVM进程的方法,比如:linux下通过ps,使用jdk自带的jps等。使用jcmd,我们同样可以做到:
[root@vincent-testing ~]# jcmd -l
13714 sun.tools.jcmd.JCmd -l
16324 org.rzo.yajsw.app.WrapperJVMMain
9350 org.rzo.yajsw.app.WrapperJVMMain
9815 org.apache.catalina.startup.Bootstrap start
通过jcmd -l
可以列出所有的Java程序,其功能和jps
其实是一样的。
列出所有的JVM程序,找到你感兴趣的进程id,运行jcmd
,看看我们可以做些什么:
[root@vincent-testing ~]# jcmd 9350 help
9350:
The following commands are available:
JFR.stop
JFR.start
JFR.dump
JFR.check
VM.native_memory
VM.check_commercial_features
VM.unlock_commercial_features
ManagementAgent.stop
ManagementAgent.start_local
ManagementAgent.start
GC.rotate_log
Thread.print
GC.class_stats
GC.class_histogram
GC.heap_dump
GC.run_finalization
GC.run
VM.uptime
VM.flags
VM.system_properties
VM.command_line
VM.version
help
For more information about a specific command use 'help '.
可以看到,jcmd给我们提供了很多的功能。这里我们先说几个简单的。
相信大部分的Java程序员肯定都用过jstack
,通过jstack
可以dump当前JVM的线程堆栈。通过jstack
可以达到一样的目的:
➜ ~ jcmd 3426 Thread.print
3426:
2018-08-02 21:36:07
Full thread dump Java HotSpot(TM) 64-Bit Server VM (25.144-b01 mixed mode):
"Attach Listener" #16 daemon prio=9 os_prio=31 tid=0x00007fd9a43d0000 nid=0xd07 waiting on condition [0x0000000000000000]
java.lang.Thread.State: RUNNABLE
"NettythreadDeathWatcher-2-1" #15 daemon prio=1 os_prio=31 tid=0x00007fd9a4ca1800 nid=0xa903 waiting on condition [0x0000700005924000]
java.lang.Thread.State: TIMED_WAITING (sleeping)
at java.lang.Thread.sleep(Native Method)
at io.netty.util.ThreadDeathWatcher$Watcher.run(ThreadDeathWatcher.java:152)
at io.netty.util.concurrent.DefaultThreadFactory$DefaultRunnableDecorator.run(DefaultThreadFactory.java:144)
at java.lang.Thread.run(Thread.java:748)
"DestroyJavaVM" #14 prio=5 os_prio=31 tid=0x00007fd9a3b7f800 nid=0x1a03 waiting on condition [0x0000000000000000]
java.lang.Thread.State: RUNNABLE
.... other threads ommited ...
如果想要在线程dump中包含锁信息,需要加上-l=true
:
➜ ~ jcmd 3426 Thread.print -l=true
3426:
2018-08-02 21:39:08
Full thread dump Java HotSpot(TM) 64-Bit Server VM (25.144-b01 mixed mode):
"Attach Listener" #16 daemon prio=9 os_prio=31 tid=0x00007fd9a43d0000 nid=0xd07 waiting on condition [0x0000000000000000]
java.lang.Thread.State: RUNNABLE
Locked ownable synchronizers:
- None
"NettythreadDeathWatcher-2-1" #15 daemon prio=1 os_prio=31 tid=0x00007fd9a4ca1800 nid=0xa903 waiting on condition [0x0000700005924000]
java.lang.Thread.State: TIMED_WAITING (sleeping)
at java.lang.Thread.sleep(Native Method)
at io.netty.util.ThreadDeathWatcher$Watcher.run(ThreadDeathWatcher.java:152)
at io.netty.util.concurrent.DefaultThreadFactory$DefaultRunnableDecorator.run(DefaultThreadFactory.java:144)
at java.lang.Thread.run(Thread.java:748)
Locked ownable synchronizers:
- None
.... other threads ommited
➜ ~ jcmd 3426 help GC.heap_dump
3426:
GC.heap_dump
Generate a HPROF format dump of the Java heap.
Impact: High: Depends on Java heap size and content. Request a full GC unless the '-all' option is specified.
Permission: java.lang.management.ManagementPermission(monitor)
Syntax : GC.heap_dump [options]
Arguments:
filename : Name of the dump file (STRING, no default value)
Options: (options must be specified using the or = syntax)
-all : [optional] Dump all objects, including unreachable objects (BOOLEAN, false)
如果你定位过内存泄漏相关的问题,那么你肯定知道如何dump堆内存,或者查看堆内存中的类分布。通常之前我们使用的工具是jmap
,使用jcmd转存堆内存的方法是使用GC.heap_dump
。
➜ ~ jcmd 3426 GC.heap_dump test.dump
3426:
Heap dump file created
通常情况,在dump堆内存钱会触发一次full GC,如果不希望触发full GC,可以指定参数all=true
,即:
➜ ~ jcmd 3426 GC.heap_dump test2.dump -all=true
3426:
Heap dump file created
转存堆内存并分析相对来说比较复杂,一个更简单的方法是统计堆中对象的直方图。在没有jcmd的时候,我通常是使用jmap来统计堆中对象的分布,如果想使用jcmd统计堆中对象的分布,使用jcmd
。
jcmd命令中包还有其他很多工具,大家如果感兴趣可以通过jcmd
查看。在没有jcmd工具之前,我们通常需要组合使用多个不同的工具进行问题定位,而现在只需要使用jcmd一个命令就可以了。除了替代现有的工具之后,jcmd还支持更高级的profiling功能,录制jfr来分析JVM的性能。