JVM 常用命令行工具

时间:2021-03-16 17:21:03

本文部分摘自《深入理解 Java 虚拟机第三版》

基础故障处理工具

Java 开发人员肯定都知道 JDK 的 bin 目录下有许多小工具,这些小工具除了用于编译和运行 Java 程序外,打包、部署、签名、调试、监控、运维等各种场景都可能会见到它们的影子

本文主要介绍的是用于监视虚拟机运行状态和进行故障处理的工具,根据软件可用性和授权的不同,可以分成三类:

  • 商业授权工具:主要是 JMC(Java Mission Control)及它要使用到的 JFR(Java Flight Recorder)。JMC 在个人开发环境中使用是免费的,但在商业环境中使用则需付费
  • 正式支持工具:这一类工具属于长期被支持的工具
  • 实验性工具:这一类工具带有实验性质,日后可能会转正,也可能会在某个 JDK 版本中无声无息地消失

虚拟机进程状况工具

使用 jps(JVM Process Status Tool)可以列出正在运行的虚拟机进程,并显示虚拟机执行主类(main 函数所在的类)名称以及这些进程的本地虚拟机唯一 ID(LVMID,Local Virtual Machine Identifier)

该命令可以获取虚拟机进程的 LVMID,从而定位想要监控的程序,而 LVMID 一般与操作系统的进程 ID 一致

jps [options] [hostid]

jps 也可以通过 RMI 协议查询开启了 RMI 服务的远程 Java 虚拟机进程状态,参数 hostid 为 RMI 注册表中注册的主机名

jps 的其他常用选项如表:

选项 作用
-q 只输出 LVMID,省略主类的名称
-m 输出虚拟机进程启动时传递给主类 main() 函数的参数
-l 输出主类的全名,如果进程执行的是 JAR 包,则输出
-v 输出虚拟机进程启动时的 JVM 参数

虚拟机统计信息监视工具

jstat(JVM Statistics Monitoring Tool)是用于监视虚拟机各种运行状态信息的命令行工具,可以显示本地或者远程虚拟机进程中的类加载、内存、垃圾收集、即时编译等运行时数据

jstat [ option vmid [interval[s|ms] [count]] ]

如果是本地虚拟机进程,VMID 与 LVMID 是一致的;如果是远程虚拟机进程,那 VMID 的格式应当是

[protocaol:][//]lvmid[@hostname[:port]/servername]

参数 interval 和 count 代表查询间隔和次数,如果省略这两个参数,说明只查询一次。假设需要每 250 毫秒查询一次进程 2764 的垃圾收集情况,一共查询 20 次,那命令应当是

jstat -gc 2764 250 20

选项 option 代表用户希望查询的虚拟机信息,主要分三类:类加载、垃圾收集、运行期编译状况等

选项 作用
-class 监视类加载、卸载数量、总空间以及类装载所耗费的时间
-gc 监视 Java 堆状况,包括 Eden 区、两个 Survivor 区、老年代、永久代等的容量、已用空间、垃圾收集时间合计等信息
-gccapacity 监视内容与 -gc 基本相同,但输出主要关注 Java 堆各个区域使用到的最大、最小空间
-gcutil 监视内容与 -gc 基本相同,但输出主要关注已使用空间占总空间的百分比
-gccause 与 -gcutil 功能一样,但会额外输出导致上一次垃圾收集产生的原因
-gcnew 监视新生代垃圾收集情况
-gcnewcapacity 监视内容与 -gcnew 基本相同,但输出主要关注使用到的最大、最小空间
-gcold 监视老年代垃圾收集情况
-gcoldcapacity 监视内容与 -gcold 基本相同,但输出主要关注使用到的最大、最小空间
-gcpermcapacity 输出永久代使用到的最大、最小空间
-compiler 输出即时编译器编译过的方法、耗时等信息
-printcompilation 输出已经被即时编译的方法

Java 配置信息工具

jinfo(Configuration Info for Java)的作用是实时查看和调整虚拟机各项参数,使用 jps 命令的 -v 参数可以查看虚拟机启动时显示指定的参数列表,获取 pid

jinfo [option] pid

使用 -flag <name> 选项打印虚拟机标记参数的值,name 表示虚拟机标记参数的名称

jinfo -flag PrintGC 21768

使用 -flag [+|-]<name> 选项可以开启或关闭虚拟机表示参数,+ 表示开启,- 表示关闭

jinfo -flag +PrintGC 21768
jinfo -flag -PrintGC 21768

使用 -flag <name> = <value> 可以设置虚拟机标记参数的值,但并不是每个参数都可以被动态修改

jinfo -flag HeapDumpPath=C:\error.hprof 21768

剩下的常用选项如表

选项 作用
-flags 打印虚拟机参数,如 -XX:NewSize
no option 不带任何选项时,会同时打印虚拟机参数和系统参数
-sysprops 打印系统参数
-h | -help 打印帮助信息

Java 内存映射工具

jmap(Memory Map for Java)命令用于生成堆转储快照,还可以查询 finalize 执行队列、Java 堆和方法区的详细信息,如空间使用率、当前用的是哪种收集器等

jmap [option] vmid

option 选项的合法值与具体含义

选项 作用
-dump 生成 Java 堆转储快照,格式为 -dump:[live,]format=b,file=<filename>,其中 live 子参数说明是否只 dump 出存活的对象
-finalizerinfo 显示在 F-Queue 中等待 Finalizer 线程执行 finalize 方法的对象
-heap 显示 Java 堆详细信息,如使用哪种回收期、参数配置、分代状况
-histo 显示堆中对象统计信息,包括类、实例数量、合计容量
-permstat 以 ClassLoader 为统计口径显示永久代内存状态
-F 当虚拟机进程对 -dump 选项没有响应时,可使用该选项强制生成 dump 快照

虚拟机堆转储快照分析工具

JDK 提供 jhat(JVM Heap Analysis Tool)命令和 jmap 搭配使用,用来分析 jmap 生成的堆转储快照。不过 jhat 的分析功能相等简陋,一般会使用其他功能更强大的分析工具

jhat 内置一个简单的 web 服务器,此命令执行后,jhat 在命令行里显示分析结果的访问地址,可以用 -port 选项指定端口

有时 dump 出来的堆很大,在启动时会报堆空间不足的错误,可以使用如下参数

jhat -J-Xmx512m <heap dump file>	# 这个内存大小可根据自己电脑进行设置

Java 堆栈跟踪工具

jstack(Stack Trace for Java)命令用于生成虚拟机当前时刻的线程快照(一般称为 threaddump 或 javacore 文件)。线程快照就是当前虚拟机内每一条线程正在执行的方法堆栈的集合,生成线程快照的目的通常是定位线程出现长时间停顿的原因,如线程间死锁、死循环、请求外部资源导致的长时间挂起等

jstack [option] vmid

option 选项的合法值与具体含义如表

选项 作用
-F 当正常输出的请求不被响应时,强制输出线程堆栈
-l 除堆栈外,显示关于锁的附加信息
-m 如果调用到本地方法的话,可以显示 C/C++ 的堆栈

从 JDK5 开始,java.lang.Thread 类新增了一个 getAllStackTraces() 方法用于获取虚拟机中所有线程的 StackTraceElement 对象,使用这个方法可以完成 jstack 的大部分功能,在实际项目中可以调用这个方法做一个管理员页面,随时使用浏览器来查阅线程堆栈