jhat 简介

jhat 全称：Java Heap Analyse Tool(Java堆分析工具)，jhat 也是 jdk 内置的工具之一。

功能：主要是用来分析java堆的命令，可以将堆中的对象以 html 的形式显示出来，包括对象的数量，大小等等，并支持对象查询语言(OQL)。

jhat命令➜  jhat -h

Usage:  jhat [-stack ] [-refs ] [-port ] [-baseline ] [-debug ] [-version] [-h|-help]

-J          Pass  directly to the runtime system. For

example, -J-mx512m to use a maximum heap size of 512MB

-stack false:     Turn off tracking object allocation call stack.

-refs false:      Turn off tracking of references to objects

-port :     Set the port for the HTTP server.  Defaults to 7000

-exclude :  Specify a file that lists data members that should

be excluded from the reachableFrom query.

-baseline : Specify a baseline object dump.  Objects in

both heap dumps with the same ID and same class will

be marked as not being "new".

-debug :     Set debug level.

0:  No debug output

1:  Debug hprof file parsing

2:  Debug hprof file parsing, no server

-version          Report version number

-h|-help          Print this help and exit

The file to read

For a dump file that contains multiple heap dumps,

you may specify which dump in the file

by appending "#" to the file name, i.e. "foo.hprof#3".

All boolean options default to "true"

-stack false|true

关闭对象分配调用栈跟踪(tracking object allocation call stack)。

如果分配位置信息在堆转储中不可用，则必须将此标志设置为 false，默认值为 true.

-refs false|true

关闭对象引用跟踪(tracking of references to objects)。

默认值为 true，默认情况下，返回的指针是指向其他特定对象的对象，如反向链接或输入引用(referrers or incoming references)，会统计/计算堆中的所有对象。

-port port-number

设置 jhat HTTP server 的端口号，默认值 7000.

-exclude exclude-file

指定对象查询时需要排除的数据成员列表文件(a file that lists data members that should be excluded from the reachable objects query)。 例如，如果文件列列出了 java.lang.String.value，那么当从某个特定对象 Object o 计算可达的对象列表时，引用路径涉及 java.lang.String.value 的都会被排除。

-baseline exclude-file

指定一个基准堆转储(baseline heap dump)。 在两个 heap dumps 中有相同 object ID 的对象会被标记为不是新的(marked as not being new)，其他对象被标记为新的(new)，在比较两个不同的堆转储时很有用。

-debug int

设置 debug 级别，0 表示不输出调试信息。 值越大则表示输出更详细的 debug 信息.

-version

启动后只显示版本信息就退出

-J< flag >

因为 jhat 命令实际上会启动一个JVM来执行，通过 -J 可以在启动JVM时传入一些启动参数。

例如 -J-Xmx512m 则指定运行 jhat 的Java虚拟机使用的最大堆内存为 512 MB，如果需要使用多个JVM启动参数，则传入多个 -Jxxxxxx.

jhat使用

使用jmap可以生成Java堆的Dump文件。生成dump文件之后就可以用jhat命令，将dump文件转成html的形式，然后通过http访问可以查看堆情况。

jhat命令解析会Java堆dump并启动一个web服务器，然后就可以在浏览器中查看堆的dump文件了。

步骤1：jmap 导出文件

除了使用jmap命令，还可以通过以下方式：使用 jconsole 选项通过 HotSpotDiagnosticMXBean 从运行时获得堆转储(生成dump文件)、

虚拟机启动时如果指定了 -XX:+HeapDumpOnOutOfMemoryError 选项, 则在抛出 OutOfMemoryError 时, 会自动执行堆转储。

使用 hprof 命令jmap -dump:live,file=demo.hprof

步骤2：jhat 分析文件➜ jhat demo.hprof

Reading from demo.hprof...

Dump file created Thu Aug 01 13:15:47 CST 2019

Snapshot read, resolving...

Resolving 2289831 objects...

Chasing references, expect 457 dots.........................................................................................................................................................................................................................................................................................................................................................................................................................................................................

Eliminating duplicate references.........................................................................................................................................................................................................................................................................................................................................................................................................................................................................

Snapshot resolved.

Started HTTP server on port 7000

Server is ready.

有时你dump出来的堆很大，在启动时会报堆空间不足的错误，可以使用如下参数：jhat -J-Xmx512m

jhat 在分析完成后，使用HTTP服务器展示其分析结果。访问地址为http://:7000，可以看到类似如下的内容：

内容很长，拖拽到最下面看到 Other Queries

在“Other Queries”一栏中点击不同的链接可以展示不同的内容，如点击“Show heap histogram” 链接，展示堆快照直方图~

点击“Execute Object Query Language (OQL) query”链接，可以使用OQL查询~

对象查询语言(OQL)

OQL是类似于SQL的查询语言，用于查询Java堆。OQL允许筛选/选择Java堆所需的信息。HAT已支持诸如“显示类X的所有实例”之类的预定义查询，而OQL则增加了灵活性。OQL基于JavaScript表达式语言。select [ from [instanceof]

[ where  ] ]

可以点击 OQL Help 获取帮助

常用类直方图(类、实例数、总大小)：http://localhost:7000/histo/

所有类实例统计：http://localhost:7000/showInstanceCounts/includePlatform/

OQL查询：http://localhost:7000/oql/

oql语法帮助：http://localhost:7000/oqlhelp/