不坠青云志

严律己，宽待人

Jcmd 命令

发表于 分类于 Valine：
本文字数： 5.6k 阅读时长 ≈ 5 分钟


jcmd 是 JDK1.7 之后出的命令行工具，如果你是 JDK1.7 之后的项目，建议你用 jcmd 替换掉 jps。
你可以使用它来查看堆信息：jcmd pid GC.heap_dump
也可以用来查看当前所有的 VM 虚拟机：jcmd -l
以及还有当前 VM 虚拟机的参数信息：jcmd PID VM.flags
具体更多命令：jcmd help jcmd PID help

1 概述

在JDK1.7以后，新增了一个命令行工具 jcmd。他是一个多功能的工具，可以用它来导出堆、查看Java进程、导出线程信息、执行GC、还可以进行采样分析（jmc 工具的飞行记录器）。

2 命令格式

1
2
3
jcmd <pid | main class> <command ... | PerfCounter.print | -f  file>
jcmd -l
jcmd -h

2.1 描述

  • 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）

3. 查看进程

命令格式：

1
jcmd -l

3.1 描述

查看 当前机器上所有的 jvm 进程信息

1
2
3
jcmd 
jcmd -l
jps

这三个命令的效果是一样的

4 查看性能统计

命令格式：

1
jcmd pid PerfCounter.print

4.1 描述

查看指定进程的性能统计信息。

1
2
3
4
5
6
7
8
9
10
11
C:\Windows\system32>jcmd 9592 PerfCounter.print
9592:
java.ci.totalTime=16704
java.cls.loadedClasses=438
java.cls.sharedLoadedClasses=0
java.cls.sharedUnloadedClasses=0
java.cls.unloadedClasses=0
java.property.java.class.path="D:\work\git\test\target\classes"
java.property.java.endorsed.dirs="D:\Program Files\Java\jre1.8.0_91\lib\endorsed"
java.property.java.ext.dirs="D:\Program Files\Java\jre1.8.0_91\lib\ext;C:\Windows\Sun\Java\lib\ext"
java.property.java.home="D:\Program Files\Java\jre1.8.0_91"

5 列出当前运行的 java 进程可以执行的操作

命令格式：

1
jcmd PID help

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
C:\Windows\system32>jcmd 9592 help
9592:
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

查看具体命令的选项
如果想查看命令的选项，比如想查看 JFR.dump 命令选项，可以通过如下命令:
jcmd 11772 help JFR.dump

6 JRF

6.1 JRF 相关命令

JRF 功能跟 jmc.exe 工具的飞行记录器的功能一样的。
要使用 JRF 相关的功能，必须使用 VM.unlock_commercial_features 参数取消锁定商业功能 。

jmc.exe 显示的提示
启动JFR
执行命令：jcmd $PID JFR.start name=abc,duration=120s

Dump JFR
等待至少duration（本文设定120s）后，执行命令：jcmd PID JFR.dump name=abc,duration=120s filename=abc.jfr（注意，文件名必须为.jfr后缀）

检查JFR状态
执行命令：jcmd $PID JFR.check name=abc,duration=120s

停止JFR
执行命令：jcmd $PID JFR.stop name=abc,duration=120s

JMC分析
切回开发机器，下载步骤3中生成的abc.jfr，打开jmc，导入abc.jfr即可进行可视化分析

7 VM.uptime

命令：jcmd PID VM.uptime
描述：查看 JVM 的启动时长：

8 GC.class_histogram

命令：jcmd PID GC.class_histogram
描述：查看系统中类统计信息

这里和jmap -histo pid的效果是一样的
这个可以查看每个类的实例数量和占用空间大小。

9 Thread.print

命令：jcmd PID Thread.print
描述：查看线程堆栈信息。

该命令同 jstack 命令。

10 GC.heap_dump

命令：jcmd PID GC.heap_dump FILE_NAME
描述：查看 JVM 的Heap Dump

1
2
3
C:\Users\jjs>jcmd 10576 GC.heap_dump d:\dump.hprof
10576:
Heap dump file created

跟 jmap命令：jmap -dump:format=b,file=heapdump.phrof pid 效果一样。
导出的 dump 文件，可以使用MAT 或者 Visual VM 等工具进行分析。

注意：如果只指定文件名，默认会生成在启动 JVM 的目录里。

11 VM.system_properties

命令：jcmd PID VM.system_properties
描述：查看 JVM 的属性信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
C:\Users\jjs>jcmd 10576 VM.system_properties
10576:
#Wed Jan 31 22:30:20 CST 2018
java.vendor=Oracle Corporation
osgi.bundles.defaultStartLevel=4
......
os.version=10.0
osgi.arch=x86_64
path.separator=;
java.vm.version=25.91-b15
org.osgi.supports.framework.fragment=true
user.variant=
osgi.framework.shape=jar
java.awt.printerjob=sun.awt.windows.WPrinterJob
osgi.instance.area.default=file\:/C\:/Users/jjs/eclipse-workspace/
sun.io.unicode.encoding=UnicodeLittle
org.osgi.framework.version=1.8.0
......

12 VM.flags

命令：jcmd PID VM.flags
描述：查看 JVM 的启动参数

1
2
3
4
5
6
7
8
9
10
C:\Users\jjs>jcmd 10576 VM.flags
10576:
-XX:CICompilerCount=3 -XX:ConcGCThreads=1 
-XX:G1HeapRegionSize=1048576 -XX:InitialHeapSize=268435456 
-XX:MarkStackSize=4194304 -XX:MaxHeapSize=1073741824 
-XX:MaxNewSize=643825664 -XX:MinHeapDeltaBytes=1048576 
-XX:+UseCompressedClassPointers -XX:+UseCompressedOops 
-XX:+UseFastUnorderedTimeStamps -XX:+UseG1GC 
-XX:-UseLargePagesIndividualAllocation -XX:+UseStringDeduplication
VM.command_line

13 命令：jcmd PID VM.command_line

描述：查看 JVM 的启动命令行

1
2
3
4
5
6
7
8
9
C:\Users\jjs>jcmd 10576 VM.command_line
10576:
VM Arguments:
jvm_args: -Dosgi.requiredJavaVersion=1.8 
-Dosgi.instance.area.default=@user.home/eclipse-workspace 
-XX:+UseG1GC -XX:+UseStringDeduplication 
-Dosgi.requiredJavaVersion=1.8 -Xms256m -Xmx1024m
java_command: <unknown>
java_class_path (initial): D:\tool\...\org.eclipse.equinox.launcher.jar

14 GC.run_finalization

命令：jcmd PID GC.run_finalization
描述： 对 JVM 执行 java.lang.System.runFinalization()

1
2
3
C:\Users\jjs>jcmd 10576 GC.run_finalization
10576:
Command executed successfully

执行一次finalization操作，相当于执行java.lang.System.runFinalization()

15 GC.run

命令：jcmd PID GC.run
描述：对 JVM 执行 java.lang.System.gc()

1
2
3
C:\Users\jjs>jcmd 10576 GC.run
10576:
Command executed successfully

告诉垃圾收集器打算进行垃圾收集，而垃圾收集器进不进行收集是不确定的。

16 PerfCounter.print

命令：jcmd PID PerfCounter.print
描述：查看 JVM 性能相关的参数

1
2
3
4
5
6
7
C:\Users\jjs>jcmd 10576 PerfCounter.print
10576:
java.ci.totalTime=93024843
java.cls.loadedClasses=18042
java.cls.sharedLoadedClasses=0
java.cls.sharedUnloadedClasses=0
java.cls.unloadedClasses=3

17 VM.version

命令：jcmd PID VM.version
描述：查看目标jvm进程的版本信息

1
2
3
4
C:\Users\jjs>jcmd 10576 VM.version
10576:
Java HotSpot(TM) 64-Bit Server VM version 25.91-b15
JDK 8.0_91

上文转载自：[jijs | jvm 性能调优工具之 jcmd][00]

18 总结

参数用的最多还是 jcmd -l、jcmd PID GC.heap_dump dump.hprof、jstat -gc PID 5000

相关文章