一、前言
在本文中,我们总结下抓 Java dump 的几种不同方法。
Java Heap Dump 是特定时刻 JVM 内存中所有对象的快照。它们对于解决内存泄漏问题和分析 Java 应用程序中的内存使用情况非常有用。
Java Heap Dump 通常以二进制格式的 hprof 文件存储。我们可以使用 jhat 或 JVisualVM 之类的工具打开和分析这些文件。同样,使用 MAT 工具分析是很常见的。
二、JDK 工具包
JDK 附带了几个以不同方式 Heap Dump 的工具。所有这些工具都位于 JDK 主目录下的 bin 文件夹下。因此,只要这个目录包含在系统路径中,我们就可以直接从命令行启动它们。
1、jmap
jmap 是一种工具,用于打印有关正在运行的 JVM 中的内存的统计信息。我们可以将其用于本地或远端进程。
要使用 Jmap Heap Dump ,我们需要使用 Heap Dump 参数:
jmap -dump:[live],format=b,file=<file-path> <pid>
与该参数一起,我们应该指定几个参数:
-
live:如果设置,则仅打印具有活动引用的对象,并丢弃准备好进行垃圾回收的对象。此参数是可选的。
-
format = b
:指定转储文件将采用二进制格式。如果未设置,结果是相同的 -
file:将写入的文件
-
pid:Java 进程的 ID
举一个例子是这样的:
jmap -dump:live,format=b,file=/tmp/dump.hprof 12587
注意:我们可以使用 jps 命令轻松获取 Java 进程的pid。jmap 是作为实验工具在 JDK 中引入的。因此,在某些不支持的情况下,最好使用其他工具代替。
2、jcmd
jcmd 是一个非常完整的工具,可以通过向 JVM 发送命令请求来工作。我们必须在运行 Java 进程的同一台机器上使用它。
它的最多命令就是 GC.heap_dump
,我们可以通过指定进程的 pid 和输出文件路径来使用它来 Heap Dump:
jcmd <pid> GC.heap_dump <file-path>
我们可以使用上面例子中使用的相同参数执行它:
jcmd 12587 GC.heap_dump /tmp/dump.hprof
与 jmap 一样,生成的 dump 为二进制格式。
3、JVisualVM
JVisualVM 是带有图形用户界面的工具,它使我们可以监控 Java 应用程序,对其进行故障排除和分析。GUI 简单,直观并且易于使用。
我们可以右键单击 Java 进程并选择“线程dump”选项,该工具将创建 dump 并在新选项卡中将其打开:
JVisualVM
注意:我们可以在“基本信息” 部分中找到创建的文件的路径。从 JDK 9开始,Visual VM 不包括在 Oracle JDK 和 Open JDK 发行版中。因此,如果我们使用的是 Java 9 或更高版本,则可以从 Visual VM 开源项目站点获得 JVisualVM 。地址:https://visualvm.github.io/
三、自动抓取 heap dump
上面介绍所有工具均在特定时间手动去 dump 的。在某些情况下,我们希望在发生 java.lang.OutOfMemoryError
时获取 Heap Dump ,以帮助我们分析问题。
对于这种情况,Java 提供了 HeapDumpOnOutOfMemoryError
命令行参数,当抛出 java.lang.OutOfMemoryError
时,程序会生成 heap dump :
java -XX:+HeapDumpOnOutOfMemoryError
默认情况下,它将 dump 存储在我们正在运行应用程序的目录中的 java_pid <pid> .hprof
文件中。如果要指定另一个文件或目录,可以在 HeapDumpPath
参数中进行设置:
java -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=<file-or-dir-path>
使用此参数,当我们的应用程序内存不足时,我们将能够在日志中看到包含 dump 的已创建文件:
java.lang.OutOfMemoryError: Requested array size exceeds VM limit
Dumping heap to java_pid12587.hprof ...
Exception in thread "main" Heap dump file created [4744371 bytes in 0.029 secs]
java.lang.OutOfMemoryError: Requested array size exceeds VM limit
at com.baeldung.heapdump.App.main(App.java:7)
在上面的示例中,它已写入到 java_pid12587.hprof
文件中。
就像我们看到的,此参数非常有用,使用此参数运行应用程序时没有任何开销。因此,强烈建议始终使用此参数,尤其是在生产中。
最后,还可以在运行时通过使用 HotSpotDiagnostic MBean
来指定此参数。为此,我们可以使用 JConsole 工具并将HeapDumpOnOutOfMemoryError
VM 参数值设置为 true:
四、JMX
我们将使用在上一节中简要介绍的 HotSpotDiagnostic MBean
。该 MBean 提供了一个 dumpHeap 方法,该方法接受 2 个参数:
-
outputFile:dump 文件的路径。该文件应具有 hprof 扩展名
-
live:如果设置为 true,则它仅 dump 内存中的活动对象,就像我们之前在 jmap上看到的那样
下面我们将介绍两种不同的方法来调用此方法来 heap dump。
1、JConsole
使用 HotSpotDiagnostic MBean
的最简单方法是使用 JMX 客户端(例如JConsole)
打开 JConsole 并连接到正在运行的 Java 进程,则可以导航到 MBeans 选项卡并在 com.sun.management
下找到HotSpotDiagnostic。在操作中,我们可以找到我们之前描述的 dumpHeap 方法:
如所示,为了执行 dumpHeap 操作,我们只需要引入参数 outputFile 并将其存在于 p0 和 p1 文本字段中。
2、编程
使用 HotSpotDiagnostic MBean
的另一种方法是通过从 Java 编程方式调用它。
为此,我们首先需要获取一个 MBeanServer 实例,以便获取在应用程序中注册的 MBean。之后,我们只需要获取 HotSpotDiagnosticMXBean 的实例 并调用其 dumpHeap 方法。
import javax.management.MBeanServer;
import java.io.IOException;
import java.lang.management.ManagementFactory;
import java.nio.file.Paths;
public class HeapDump {
public static void dumpHeap(String filePath, boolean live) throws IOException {
MBeanServer server = ManagementFactory.getPlatformMBeanServer();
HotSpotDiagnosticMXBean mxBean = ManagementFactory.newPlatformMXBeanProxy(
server, "com.sun.management:type=HotSpotDiagnostic", HotSpotDiagnosticMXBean.class);
mxBean.dumpHeap(filePath, live);
}
public static void main(String[] args) throws IOException {
String file = Paths.get("dump.hprof").toFile().getPath();
dumpHeap(file, true);
}
}
注意,不能覆盖 hprof 文件。因此,在创建打印 heap dumps 的应用程序时应该考虑到这一点。如果我们没有这样做,就会得到一个异常:
Exception in thread "main" java.io.IOException: File exists
at sun.management.HotSpotDiagnostic.dumpHeap0(Native Method)
at sun.management.HotSpotDiagnostic.dumpHeap(HotSpotDiagnostic.java:60)
五、Arthas
Arthas 是阿里提供的一款 Java 开源诊断工具。能够查看应用的线程状态、JVM 信息等;并能够在线对业务问题诊断,比如查看方法调用的出入参数、执行过程、抛出的异常、输出方法执行耗时等,大大提升了线上问题的排查效率。
Arthas 提供 heapdump 命令:dump java heap, 类似 jmap命令的 heap dump功能。
dump 到指定文件:
[arthas@58205]$ heapdump /tmp/dump.hprof
Dumping heap to /tmp/dump.hprof...
Heap dump file created
只 dump live对象:
[arthas@58205]$ heapdump --live /tmp/dump.hprof
Dumping heap to /tmp/dump.hprof...
Heap dump file created
dump 到临时文件:
[arthas@58205]$ heapdump
Dumping heap to /var/folders/my/wy7c9w9j5732xbkcyt1mb4g40000gp/T/heapdump2019-09-03-16-385121018449645518991.hprof...
Heap dump file created
更多参考:https://arthas.gitee.io/heapdump.html
六、结论
在本文中,我们展示了用 Java 捕获 Heap Dump 方法 的多种方法。
常见的dump方式
从经验上来说,我们应该记得在运行 Java 应用程序时始终使用 HeapDumpOnOutOfMemoryError 参数。