可观测性与稳定性 / 知识点
JVM 诊断命令与 JFR 性能分析速查
进程定位
jps [-q] [-mlvV] [hostid]列出当前可访问的 Java HotSpot JVM 及其本地 JVM 标识,通常用于排障第一步查找目标 Java 服务的进程 ID。
查看 Java 进程
jps 用于快速列出当前主机上可访问的 JVM,并取得后续执行 jstack、jcmd、jmap 等诊断命令所需的本地 JVM 标识,通常表现为操作系统进程 ID。
基本语法
jps [-q] [-mlvV] [hostid]不指定 hostid 时查询本机。远程查询依赖目标环境提供相应的 JStat 远程监控能力,生产环境通常不会默认开放。
关键选项
-q:只输出 JVM 标识,不显示主类或 JAR 名称,适合脚本只需要 PID 的场景。-m:同时显示传给main方法的应用参数。-l:显示应用主类的完整包名,或通过java -jar启动时的完整 JAR 路径。-v:显示 JVM 启动参数,例如堆大小和-D系统属性。-V:显示通过 JVM flags 文件传入的参数。
常用示例
先直接查看 JVM 列表,根据应用名称定位目标进程:
jps预期输出:目标 Java 服务会以“JVM 标识 + 主类或 JAR 名称”的形式出现,实际进程数量和标识会不同。
<ID> orders-service.jar
<ID> Jps取得目标 <ID> 后,再把它传给具体的 JVM 诊断工具。不要仅凭 PID 长期保存诊断目标,因为服务重启后 PID 可能改变。
风险与边界
jps 只能看到当前环境中可访问且能够被 JVM 监控机制发现的进程,因此它不是通用操作系统进程清单。不同操作系统用户、容器 PID 命名空间或权限隔离都可能导致目标 JVM 不出现。
如果明确知道服务已经运行却查不到,应先确认命令是否在正确的主机或容器内执行,以及执行用户是否能够访问目标 JVM。不要因为 jps 结果为空就直接判断 Java 服务没有运行。
jps -lv [hostid]同时显示应用主类或 JAR 完整名称以及 JVM 启动参数,适合存在多个相似 Java 进程时确认具体服务和内存配置。
查看进程与 JVM 参数
当主机上存在多个名称相似的 Java 服务时,jps -lv 可以同时显示完整主类或 JAR 路径以及 JVM 启动参数,便于确认目标实例是否使用了预期的堆大小、系统属性和运行环境。
命令含义
jps -lv [hostid]这里组合了两个选项:-l 输出完整主类名或 JAR 路径,-v 输出传给 JVM 的启动参数。它不会因为使用了 -v 而显示传给应用 main 方法的普通业务参数;需要查看这类参数时应使用 -m。
常用示例
在本机列出 Java 进程并核对 JVM 配置:
jps -lv预期输出:每行以 JVM 标识开头,随后是完整主类或 JAR 路径以及该 JVM 的启动参数;实际路径、参数和 <ID> 会因部署方式而不同。
<ID> /opt/apps/orders-service.jar -Xms512m -Xmx2g -Dspring.profiles.active=prod
<ID> sun.tools.jps.Jps -Dapplication.home=<PATH> -Xms8m例如需要核对内存配置时,可直接检查目标服务所在行是否包含预期的 -Xms、-Xmx 等参数;需要区分同名 JAR 时,则重点检查 -l 给出的完整路径。
使用边界
jps -lv 展示的是 JVM 启动信息,不等同于完整的操作系统命令行,也不能代替运行时状态诊断。服务启动后动态变化的堆占用、线程状态或 GC 情况,应继续使用 jcmd、jstat 等工具检查。
如果目标 JVM 未出现,优先检查当前用户权限、主机或容器边界,而不是据此认定服务没有启动。
jcmd [-l]列出当前用户能够通过 jcmd 访问的 JVM 进程及启动信息,可直接作为后续执行线程、堆和 JFR 诊断命令的入口。
列出可诊断 JVM
需要先确定目标 JVM 的进程 ID,再执行线程、堆、类加载或 JFR 诊断时,先用 jcmd 列出当前环境中可访问的 Java 进程。-l 会补充主类、JAR 路径及可获得的启动参数,通常更适合作为诊断入口。
基本语法
jcmd [-l]不带参数时,jcmd 列出可发现的 JVM 及其简要启动信息。-l 要求尽可能显示应用主类的完整名称或可执行 JAR 的完整路径,并附带可获得的应用参数。
常用示例
jcmd -l预期输出:进程 ID 和启动信息取决于当前机器,实际数值可能不同。
<ID> com.example.OrderService --spring.profiles.active=prod
<ID> /<PATH>/worker.jar从左侧 <ID> 取得目标 JVM 的进程 ID 后,即可继续执行 jcmd <ID> help 等诊断命令。
可见范围与排查
jcmd 只能操作当前环境中允许 Attach 的 JVM。目标进程由其他用户运行、权限不足、处于隔离的容器或进程命名空间中,或者 JVM 不支持相应诊断机制时,都可能无法出现在列表中或无法继续连接。
jcmd <pid> help [command]查询目标 JVM 当前实际支持的诊断命令,或继续查看某个命令的参数说明;不同 JDK 和 JVM 实现存在差异时应优先检查这里。
查看可用诊断命令
准备对目标 JVM 执行诊断操作时,先让 JVM 自己报告当前支持的命令和参数。这样可以避免按照其他 JDK 版本的文档直接执行不存在、已改名或选项不同的诊断命令。
基本语法
jcmd <pid> help [command]<pid>:目标 JVM 的进程 ID,可先通过jcmd -l获取。help:列出目标 JVM 当前注册的诊断命令。[command]:可选;指定后只查看该命令的用途、影响级别、语法和可用选项。
查看命令说明
例如要确认目标 JVM 是否支持 Thread.print,以及该命令当前接受哪些选项,可执行:
jcmd <ID> help Thread.print预期输出:具体字段和选项会随 JDK 版本及 JVM 实现变化,但会返回该诊断命令的帮助信息;<ID> 替换为实际 JVM 进程 ID。
<ID>:
Thread.print
Print all threads with stacktraces.
Impact: <IMPACT>
Syntax : Thread.print [options]
...如果尚不知道命令名称,则执行 jcmd <ID> help,先查看该 JVM 实际提供的命令列表,再针对某一项查询详细帮助。
风险与边界
help 查询本身用于读取命令元数据,不会执行被查询的诊断动作,但帮助列表中包含的命令并不都同样安全。堆转储、类直方图、JFR 控制等操作可能产生明显的 CPU、停顿、磁盘或文件写入开销。
运行状态与配置
jcmd <pid> VM.command_line输出目标 JVM 实例启动时使用的命令行,适合确认实际运行的应用入口及线上启动配置是否与部署预期一致。
查看 JVM 启动命令
当需要确认线上进程究竟以哪个入口、哪些 JVM 参数和应用参数启动时,使用 VM.command_line。它读取目标 JVM 记录的启动命令信息,不修改进程状态,适合核对部署脚本、启动参数与实际运行实例是否一致。
基本语法
jcmd <pid> VM.command_line<pid>:目标 JVM 的进程 ID。VM.command_line:输出该 JVM 实例的启动命令行信息,不接受额外业务参数。
执行 jcmd 时应与目标 JVM 位于同一台机器,并具备访问该进程所需的用户权限;在容器环境中还要确保当前环境能看到目标 JVM 的 PID。
常用示例
jcmd 12345 VM.command_line预期结果:首行是目标 PID,随后通常可看到 JVM 参数、Java 启动入口、初始类路径和启动器类型。具体字段与内容会随 JDK、启动方式和应用参数不同。
12345:
VM Arguments:
jvm_args: -Xms512m -Xmx2g
java_command: <MAIN_CLASS_OR_JAR> <ARGS>
java_class_path (initial): <PATH>
Launcher Type: <TYPE>其中 jvm_args 用于核对传给虚拟机的选项,java_command 更适合确认主类或 JAR 以及应用参数。若应用通过脚本、服务管理器或容器启动,这里反映的是 JVM 实际接收到的信息,不等同于完整还原外层 shell 命令。
风险与边界
该命令开销低且只读,无需恢复操作。但应用参数可能包含令牌、密码、连接串等敏感信息,不应直接粘贴到工单、群聊或公开日志。若命令无法附加到进程,优先检查 PID 是否正确、执行用户是否与目标 JVM 匹配,以及容器或 PID 命名空间是否隔离了目标进程。
jcmd <pid> VM.flags [-all]查看目标 JVM 当前生效的 VM Flag;需要核对完整可用参数和值时可增加 -all,常用于确认堆大小、GC 和运行参数。
查看 JVM 参数
当需要确认目标 JVM 当前真正生效的 VM Flag,而不是只查看部署脚本里写了什么时,使用 VM.flags。它适合核对堆大小、垃圾收集器及其他运行参数;带 -all 时还能列出该 VM 支持的全部 Flag 及其当前值。
基本语法
jcmd <pid> VM.flags [-all]<pid>:目标 JVM 的进程 ID。- 不带
-all:输出当前实例的一组生效 Flag,通常包含显式设置和部分由 JVM 选择的值。 -all:输出该 VM 支持的全部 Flag 及当前值,信息量会显著增加。
VM.flags 展示的是查询时的当前值,因此不应把结果简单理解为“原始启动参数列表”。某些 Flag 可能由 JVM 根据环境自动选择,也可能在运行期间被允许的诊断操作调整。
常用示例
jcmd 12345 VM.flags预期结果:首行是 PID,后续为当前生效的 VM Flag。具体名称、数量和值依赖 JDK 版本、硬件环境和启动配置;堆大小一类数值通常以字节值显示。
12345:
-XX:InitialHeapSize=<BYTES> -XX:MaxHeapSize=<BYTES> <OTHER_EFFECTIVE_FLAGS>需要完整排查时再增加 -all,避免在日常检查中产生大量无关输出。布尔型 Flag 常以 -XX:+Name 或 -XX:-Name 表示启用或关闭;数值型 Flag 则直接显示当前数值。
风险与边界
该命令开销低且只读,无需恢复操作。-all 的输出可能很长,保存到日志或工单前应避免无差别收集,并留意其中可能出现的路径或环境细节。若无法连接目标 JVM,先确认命令与 JVM 位于同一机器、PID 正确且执行用户具备相应权限;容器场景还需确认目标 PID 在当前命名空间可见。
jcmd <pid> VM.system_properties输出目标 JVM 的 Java 系统属性,适合核对 Java 版本、文件编码、时区、临时目录以及通过 -D 注入的运行配置。
查看系统属性
当编码、目录、JDK 环境或 -D 参数与预期不一致时,可用 VM.system_properties 读取目标 JVM 当前可见的 Java 系统属性。该命令用于配置核对,不会修改目标进程中的属性值。
基本语法
jcmd <pid> VM.system_properties<pid> 是目标 Java 进程的 PID。VM.system_properties 本身没有需要配置的附加选项;实际可用的诊断命令取决于目标 JVM,可用 jcmd <pid> help 检查命令列表。
高频核对项
java.version、java.home:确认实际运行的 Java 版本和安装目录。file.encoding:确认默认字符编码,排查文本读写乱码。java.io.tmpdir、user.dir:确认临时目录和当前工作目录。user.timezone:应用显式设置时可用于核对时区;不要仅凭这一项推断所有时间处理行为。- 自定义
-Dkey=value:通常可按属性名直接查找,适合确认启动脚本中的运行配置是否真正进入 JVM。
常用示例
jcmd 12345 VM.system_properties预期输出:下面仅展示常见属性,实际属性数量、顺序和值会因 JDK 和运行环境而不同。
12345:
java.version=<JAVA_VERSION>
java.home=<PATH>
file.encoding=<ENCODING>
java.io.tmpdir=<PATH>
user.dir=<PATH>如果要核对某个自定义参数,例如启动时传入 -Dapp.region=ap-southeast,可直接在输出中查找 app.region,避免只检查启动脚本文本而忽略实际进程配置。
风险与排障
jcmd 需要能够附加到目标 JVM;通常应在目标进程所在主机上,以与目标进程匹配的有效用户和组身份执行。附加失败时先确认 PID、操作系统权限以及容器中的 PID 命名空间。
系统属性中可能包含数据库地址、令牌或其他通过 -D 注入的敏感配置。采集结果用于工单、聊天或公开日志前应先脱敏,不要直接传播完整输出。
jcmd <pid> VM.info输出 JVM 环境和运行状态的综合信息,适合故障发生后快速采集基础现场,再根据异常方向继续检查线程、GC 或堆。
查看 JVM 综合状态
故障刚发生而原因尚不明确时,可先用 VM.info 获取目标 JVM 的综合现场。它一次输出多类环境和运行状态信息,适合作为后续线程、GC、内存或启动参数分析的基线。
基本语法
jcmd <pid> VM.info<pid> 是目标 Java 进程的 PID。VM.info 不需要额外参数;不同 JDK 和 JVM 实现提供的具体报告区段可能存在差异,因此分析时应以当前目标进程的实际输出为准。
重点查看什么
常见 HotSpot JVM 的报告会汇总多类现场信息,例如 VM 与运行环境、启动参数、堆和 GC 状态、内部事件、动态库以及操作系统和硬件信息。不要要求不同 JDK 版本的字段名称和排列完全一致。
初步排查时可以先确认 JVM 版本与启动配置,再检查堆和 GC 是否出现明显异常,最后结合系统资源和内部事件判断下一步工具。若问题明显指向线程阻塞,应继续使用 Thread.print;若需要更具体的堆状态,则继续使用对应的 GC 或堆诊断命令。
常用示例
jcmd 12345 VM.info预期输出:报告通常较长,下列占位表示目标 JVM 返回的多段综合状态文本,具体字段随 JDK、JVM 和操作系统变化。
12345:
<VM_INFO_REPORT>成功执行后应保存完整输出,而不是只截取异常附近几行。综合报告的价值在于保留同一时刻的 JVM 配置、运行状态和系统环境,便于后续交叉判断。
风险与边界
VM.info 适合快速采集基线,但不能替代针对性诊断:它不是堆转储,也不应代替专门的线程转储或对象存活分析。发现明确方向后,应切换到更聚焦的诊断命令。
报告可能包含环境变量、命令行参数、目录和其他运行环境信息,分享前需要脱敏。若目标 JVM 提示命令不可用,可先用 jcmd <pid> help 查看该进程实际支持的诊断命令;附加失败时还应检查目标主机、有效用户与组权限以及容器 PID 命名空间。
GC 与堆内存
jstat -gcutil [-t] [-h <lines>] <vmid> [<interval> [<count>]]按固定间隔观察各内存区域利用率和 Young GC、Full GC 次数及耗时,适合快速判断服务是否存在持续 GC 压力。
持续观察 GC 利用率
jstat -gcutil 适合用低成本采样快速判断 JVM 是否持续承受 GC 压力。它输出各区域当前容量的利用率,以及 Young GC、Full GC 的累计次数和累计耗时;判断趋势时应比较相邻采样,而不是只看某一行的绝对值。
基本语法
jstat -gcutil [-t] [-h <lines>] <vmid> [<interval> [<count>]]<vmid> 是目标 JVM 标识;本地 HotSpot 场景通常对应目标 Java 进程的本地 VM ID。<interval> 是采样间隔,默认单位为毫秒,也可显式使用 ms 或 s;省略 <count> 时会持续采样,直到目标 JVM 结束或手动终止命令。
关键选项
| 参数 | 作用 |
|---|---|
-t |
在首列增加 JVM 启动后的经过秒数,便于计算相邻采样的时间跨度 |
-h <lines> |
每输出指定行数后重复打印表头,长时间观察时更容易阅读 |
<interval> |
控制采样频率,例如 1000 表示 1000 ms |
<count> |
控制采样次数,建议临时诊断时显式限制 |
核心列中,S0、S1、E、O、M、CCS 表示对应区域相对当前容量的使用百分比;YGC、FGC 是累计 GC 次数,YGCT、FGCT、GCT 是累计耗时,单位为秒。
高频示例
将 <ID> 替换为目标 JVM 的实际标识后,每秒采样一次,共采样 3 次:
jstat -gcutil -t <ID> 1000 3预期输出形态如下,具体数值会随 JVM 和采样时刻变化:
Timestamp S0 S1 E O M CCS YGC YGCT FGC FGCT GCT
120.0 0.00 72.10 48.30 61.20 95.40 88.30 42 0.315 1 0.084 0.399
121.0 0.00 72.10 79.60 61.20 95.40 88.30 42 0.315 1 0.084 0.399
122.0 65.40 0.00 8.20 61.80 95.40 88.30 43 0.322 1 0.084 0.406第二、三行之间 YGC 增加 1、E 明显下降,说明发生了一次 Young GC。判断压力时重点看单位时间内 YGC、FGC 和各耗时列的增量,以及 GC 后 O 是否长期抬升;Eden 周期性升高再回落本身通常是正常现象。
风险与边界
jstat 是只读诊断工具,但过短的采样间隔会增加观测开销,也容易制造噪声;线上临时排查通常从 1 秒级采样开始更稳妥。单次看到 O 较高不能直接判定内存泄漏,应结合多轮 GC 后的 Old 区基线、GC 日志或堆分析继续验证。
如果命令无法连接目标 JVM,先确认 <ID> 属于当前可见的 Java 进程,并检查账号权限、容器或 PID 命名空间是否隔离。不要把 jstat 的列布局当作长期稳定的机器接口,跨 JDK 版本做自动解析前应重新校验输出格式。
jstat -gc [-t] [-h <lines>] <vmid> [<interval> [<count>]]查看 Eden、Survivor、Old、Metaspace 等区域容量和使用量以及 GC 次数与耗时,适合进一步分析堆空间变化。
查看 GC 详细统计
jstat -gc 用于从“利用率异常”继续下钻到各区域的实际容量与使用量。它同时给出 Survivor、Eden、Old、Metaspace、Compressed Class Space 的容量或已用空间,以及 GC 次数和累计耗时,适合判断空间增长、扩容和回收后的占用变化。
基本语法
jstat -gc [-t] [-h <lines>] <vmid> [<interval> [<count>]]<interval> 默认以毫秒计,也可显式写成 ms 或 s;指定 <count> 可限制采样次数。-t 会增加 JVM 启动后经过秒数,-h <lines> 用于周期性重复表头。
关键列
| 列 | 含义 |
|---|---|
S0C/S1C、S0U/S1U |
两个 Survivor 空间的当前容量与使用量,单位 KB |
EC/EU |
Eden 当前容量与使用量,单位 KB |
OC/OU |
Old 当前容量与使用量,单位 KB |
MC/MU |
Metaspace 已提交容量与使用量,单位 KB |
CCSC/CCSU |
Compressed Class Space 已提交容量与使用量,单位 KB |
YGC/YGCT |
Young GC 累计次数与累计耗时 |
FGC/FGCT |
Full GC 累计次数与累计耗时 |
GCT |
GC 累计总耗时 |
与 -gcutil 相比,-gc 更适合回答“用了多少 KB、当前容量是多少”。例如 OU 持续增长时,应同时观察 OC 是否扩容,以及 GC 后 OU 能否回落,不能只根据一个瞬时值判断异常。
高频示例
将 <ID> 替换为目标 JVM 的实际标识后,每秒采样一次,共采样 3 次:
jstat -gc -t <ID> 1000 3预期输出形态如下,实际容量和使用量取决于堆配置、GC 算法与运行负载:
Timestamp S0C S1C S0U S1U EC EU OC OU MC MU CCSC CCSU YGC YGCT FGC FGCT GCT
240.0 0.0 8192 0.0 6400 65536 24800 262144 151200 89600 85400 11264 10120 86 0.642 2 0.151 0.793
241.0 0.0 8192 0.0 6400 65536 51200 262144 151200 89600 85400 11264 10120 86 0.642 2 0.151 0.793
242.0 8192 0.0 5900 0.0 65536 7200 262144 154600 89600 85400 11264 10120 87 0.650 2 0.151 0.801第三行 YGC 增加 1,同时 EU 从较高值降到较低值,且 OU 略有增加,说明本次 Young GC 回收了 Eden 中的对象,并有部分对象进入更老的区域。真正排查堆压力时应持续看多次采样后的趋势,而不是把一次晋升误判为泄漏。
风险与边界
-gc 输出很宽,人工查看时优先关注与问题直接相关的列。若目的是快速判断 GC 频率和利用率,先用 -gcutil 更简洁;只有需要容量与使用量细节时再切换到 -gc。
如果目标 JVM 无法被采样,检查 <ID>、运行账号以及容器或 PID 命名空间。对于长期趋势、停顿原因或对象来源,jstat -gc 只能提供统计快照,仍需结合 GC 日志、JFR 或堆转储进一步定位;自动化脚本也不应假设不同 JDK 版本的列格式永久不变。
jstat -gccause [-t] [-h <lines>] <vmid> [<interval> [<count>]]在 GC 利用率统计基础上增加最近一次和当前 GC 的触发原因,适合确认频繁回收是分配压力还是其他条件导致。
查看 GC 触发原因
jstat -gccause 在 GC 利用率摘要上增加最近一次和当前 GC 的触发原因,适合连续观察“回收次数在增长,但为什么触发”。单次采样只能看到一个时点,排查频繁 GC 时应配合采样间隔和次数看趋势。
基本语法
jstat -gccause [-t] [-h <lines>] <vmid> [<interval> [<count>]]| 参数 | 作用 |
|---|---|
-t |
在首列显示目标 JVM 启动以来的经过时间,便于对齐采样时点。 |
-h <lines> |
每隔指定采样行数重复输出表头,长时间观察时更易读。 |
<vmid> |
目标虚拟机标识;本机 HotSpot 中通常与进程 PID 相同,但不保证始终等同。 |
<interval> |
正整数采样间隔,可使用 ms 或 s;不写单位时按毫秒解释。 |
<count> |
采样次数;省略时会持续输出,直到目标 JVM 或 jstat 结束。 |
读取触发原因
LGCC 表示最近一次 GC 的原因,GCC 表示当前正在发生的 GC 原因(如适用)。判断是否真的“频繁回收”时,还要同时看 YGC、FGC 及对应耗时是否持续增长,不能只凭某个原因字符串下结论。
GC 原因名称由具体收集器和 JDK 实现决定。例如同样是分配压力,不同收集器可能使用不同标签;GCC 在当前没有 GC 时也可能显示无活动状态。因此它更适合做定位线索,而不是直接当作根因证明。
常用示例
jstat -gccause 12345 1000 10预期结果:每隔 1000 毫秒采样一次,共输出 10 行数据。列集合可能随 JDK 与收集器变化,但末尾会包含最近一次和当前 GC 原因;单个采样行可按下面的形态理解。
S0 S1 E O M CCS YGC YGCT FGC FGCT GCT LGCC GCC
<PCT> <PCT> <PCT> <PCT> <PCT> <PCT> <COUNT> <TIME> <COUNT> <TIME> <TIME> <LAST_GC_CAUSE> <CURRENT_GC_CAUSE>若 YGC 快速增加且 LGCC 长期指向分配相关原因,通常应继续检查对象分配速率和年轻代容量;若 FGC 增长,则需要结合堆占用、晋升压力和 GC 日志进一步确认。
风险与边界
jstat 是采样工具,不会替你证明内存泄漏,也不应把一次采样当成趋势。过短的采样间隔会增加诊断输出和观测开销,生产环境通常先从秒级采样开始,再按问题持续时间调整。
不要依赖固定列位置编写长期解析脚本,JDK 版本和收集器可能改变输出格式。若无法读取目标 JVM,优先核对 <vmid>、运行用户以及容器或进程命名空间是否一致。
jcmd <pid> GC.heap_info快速查看目标 JVM 当前 Java 堆的整体信息,适合确认堆布局和基本使用状态,不需要立即生成体积较大的 Heap Dump。
查看堆概要
jcmd <pid> GC.heap_info 用于读取目标 JVM 当前堆的概要,而不生成 Heap Dump 文件。它适合先确认正在使用的堆布局、当前容量与使用量以及元空间信息,再决定是否需要更重的转储或对象级分析。
前置条件
jcmd 必须能够附加到目标 JVM。通常应在目标 JVM 所在主机执行,并使用与目标进程匹配的有效用户权限;容器场景还要确保看到的是同一进程命名空间中的 PID。
该诊断命令的影响级别为中等,不适合当作高频监控接口持续轮询。它提供的是当前概要快照,不等同于 GC 后存活对象大小,也不能替代对象直方图或 Heap Dump。
基本语法
jcmd <pid> GC.heap_info<pid> 是目标 Java 进程 ID。GC.heap_info 本身没有需要填写的业务参数,输出内容由目标 JVM 使用的 GC 实现决定,因此不同收集器之间的字段和布局可能不同。
常用示例
jcmd 12345 GC.heap_info预期结果:命令成功时先打印目标 PID,随后给出当前收集器对应的堆概要。若目标 JVM 使用 G1,常见输出形态如下;容量、计数和地址都是动态值。
12345:
garbage-first heap total <SIZE>K, used <SIZE>K [<ADDRESS>, <ADDRESS>)
region size <SIZE>K, <COUNT> young (<SIZE>K), <COUNT> survivors (<SIZE>K)
Metaspace used <SIZE>K, committed <SIZE>K, reserved <SIZE>K
class space used <SIZE>K, committed <SIZE>K, reserved <SIZE>K如果使用其他收集器,堆部分不会保证出现 garbage-first heap 或 region 字段。解读时应关注该收集器实际输出的总容量、已使用量、代或 region 布局,以及 Metaspace 的 used、committed、reserved 关系。
风险与边界
不要把 used 直接解释为“无法回收的内存”:它只是执行命令时的堆使用快照,其中可能包含下一次 GC 可回收的对象。若目标是判断哪些类占用最多,应改用对象直方图;若需要离线分析对象引用关系,再考虑 Heap Dump。
执行失败时常见原因是 PID 不在当前命名空间、权限不匹配或目标 JVM 不支持该诊断命令。生产排障中应先用这类概要信息缩小范围,避免一开始就使用体积和停顿风险更高的转储操作。
jcmd <pid> GC.class_histogram [-all] [-parallel=<n>]按类统计堆中的实例数量和占用空间,可用于发现异常增长的大对象类型;堆较大时扫描成本明显,应避免高峰期频繁执行。
统计对象实例
当怀疑某类对象数量或占用空间持续异常增长时,可用 GC.class_histogram 对目标 JVM 的堆做一次按类汇总。它适合快速缩小排查范围,但属于高开销诊断操作,不应作为高频监控命令使用。
基本语法
jcmd <pid> GC.class_histogram [-all] [-parallel=<n>]<pid>:目标 JVM 的进程 ID,通常需要在目标 JVM 所在主机上以具备 Attach 权限的账号执行。-all:把不可达对象也纳入统计;只有确实需要观察这部分对象时再启用。-parallel=<n>:控制堆检查使用的并行线程数;0由 VM 决定,1使用单线程,更大的值表示尝试使用对应数量的线程。
常用示例
jcmd 12345 GC.class_histogram预期输出类似:
12345:
num #instances #bytes class name (module)
-------------------------------------------------------
1: <COUNT> <BYTES> <CLASS>
2: <COUNT> <BYTES> <CLASS>
...具体实例数、字节数和类名取决于当时的堆内容。通常先关注占用字节数靠前的业务类,再结合不同时间点的结果判断其数量或容量是否持续增长,而不是仅凭一次排名认定内存泄漏。
风险与边界
该命令需要扫描堆,成本随堆大小和对象数量增加,可能明显消耗 CPU 并影响应用停顿时间。生产环境应避开流量高峰,并避免短时间连续执行;如果已发现可疑类型,再结合 Heap Dump、对象引用链或其他诊断证据定位其为何无法释放。
jcmd <pid> GC.heap_dump [options] <filename>将目标 JVM 的 Java 堆导出为 HPROF 文件供 MAT 等工具离线分析,可能产生停顿和大量磁盘写入,生产环境需谨慎执行。
导出 Heap Dump
当类直方图只能确认“什么对象占得多”,却还需要分析对象引用链、支配关系和泄漏路径时,可用 GC.heap_dump 把目标 JVM 的堆保存为 HPROF 文件,再交给 MAT 等工具离线分析。
基本语法
jcmd <pid> GC.heap_dump [options] <filename><pid>:目标 JVM 的进程 ID。<filename>:Dump 文件路径。生产环境优先使用容量充足的独立磁盘,并建议填写绝对路径,避免无法确认文件实际落点。-all:需要时可将不可达对象也写入 Dump;这通常会生成更多数据,应根据诊断目标决定是否使用。
Heap Dump 可能接近实际堆数据规模,执行前必须确认目标文件系统有足够剩余空间。已有同名文件时不要依赖隐式覆盖行为,优先换用新的文件名。
导出并验证
下面先执行 Dump,再检查生成文件是否非空。jcmd 自身的版本相关提示被写入日志,便于失败时回查。
jcmd 12345 GC.heap_dump /tmp/heap.hprof >/tmp/jcmd-heap-dump.log && test -s /tmp/heap.hprof && echo "heap dump exists"预期输出:
heap dump exists出现该结果表示 /tmp/heap.hprof 已创建且文件非空;它不能替代后续 HPROF 解析校验。如果没有输出,应先检查 /tmp/jcmd-heap-dump.log、目标 JVM 状态、执行权限和磁盘剩余空间,再决定是否重试。
风险与恢复
导出过程可能造成明显停顿和大量磁盘写入,堆越大影响通常越明显,因此应尽量在低峰期操作。磁盘空间不足或导出中断时,应先确认 JVM 已停止写入,再清理不完整文件或改到容量充足的文件系统重新执行。
Heap Dump 可能包含业务对象、令牌、用户数据等敏感内容,应限制文件访问权限,只传输给必要的分析环境,并在问题处理完成后按数据治理要求清理。
jmap -histo[:live] <pid>使用 jmap 输出 Java 堆对象直方图,用于查看各类实例数量和空间占用;现代 JDK 中通常优先考虑对应的 jcmd 命令。
用 jmap 统计对象
当 JVM 堆占用异常、怀疑某类对象数量持续增长时,可用 jmap -histo 获取一次对象直方图。它按类汇总实例数量和占用字节数,适合快速寻找“数量多”或“总体积大”的对象类型,但不能直接证明某个类发生了内存泄漏。
基本语法
jmap -histo[:live] <pid>-histo:扫描当前堆并按类统计实例数量与浅表占用空间;结果可能包含已经不可达、但尚未被 GC 回收的对象。:live:可选,只统计 GC 判定仍存活的对象,开销通常更高。<pid>:目标 Java 进程号,执行时替换为实际数字。
直方图通常按总字节数从高到低排列。#instances 表示该类的实例数量,#bytes 表示这些对象自身占用空间的合计,并不包含它们引用的其他对象,因此不能把该值当作 retained size。
高频示例
以下只查看输出前几行,避免终端被大量类型信息淹没。<PID> 需要替换为目标 JVM 的实际进程号。
jmap -histo <PID> | head -n 15预期输出:具体数量、字节数和类型排序取决于目标 JVM,当次结果可能类似:
num #instances #bytes class name (module)
-------------------------------------------------------
1: <COUNT> <BYTES> [B (java.base@<VERSION>)
2: <COUNT> <BYTES> java.lang.String (java.base@<VERSION>)
3: <COUNT> <BYTES> java.lang.Class (java.base@<VERSION>)
...重点先看排名靠前且业务上不应大量存在的类型,再结合不同时间点的趋势、堆转储或其他诊断证据判断问题。单次排名高并不等于泄漏,例如缓存、字节数组和字符串在正常应用中也可能长期位于前列。
风险与边界
jmap 需要附加到目标 JVM,并遍历堆对象;大堆或高负载进程可能出现明显停顿和额外 CPU 开销,因此不应在线上高频执行。附加失败时,应先确认目标 PID、执行用户、容器或 PID 命名空间以及操作系统的进程附加权限。
jmap -histo:live <pid>仅统计当前仍存活的 Java 对象,可降低不可达对象对判断的干扰;该操作对线上 JVM 影响更明显,不适合频繁采样。
只统计存活对象
当普通对象直方图被大量“等待 GC 回收”的对象干扰,希望更接近 GC 后实际存活集合时,可使用 jmap -histo:live。它比普通 -histo 更适合排查长期存活对象,但代价也更高,线上使用前必须考虑停顿风险。
基本语法
jmap -histo:live <pid>-histo:live:只统计垃圾收集器判定仍然存活的对象。<pid>:目标 Java 进程号,执行时替换为实际数字。
在 HotSpot JVM 上,为得到 live 对象集合,该操作通常会伴随一次 Full GC,再生成堆对象直方图。因此它不仅是在“读取”当前状态,还可能改变执行后的堆占用和对象分布,这一点在故障现场尤其重要。
高频示例
以下命令获取存活对象直方图,并只显示前几行。<PID> 需要替换为实际进程号。
jmap -histo:live <PID> | head -n 15预期输出:结果格式与普通直方图相似,但实例数量和字节数基于 GC 后仍存活的对象,实际数值因进程而异。
num #instances #bytes class name (module)
-------------------------------------------------------
1: <COUNT> <BYTES> [B (java.base@<VERSION>)
2: <COUNT> <BYTES> java.lang.String (java.base@<VERSION>)
3: <COUNT> <BYTES> java.lang.Class (java.base@<VERSION>)
...如果某类对象在多次、间隔合理的 live 直方图中持续增长,且业务负载已经回落,它才更值得继续调查。仍需结合对象引用链或堆转储确认谁在持有这些对象,不能只凭直方图确定泄漏根因。
风险与恢复
-histo:live 可能触发 Full GC 和较长的 Stop-The-World 停顿,大堆、老年代占用高或延迟敏感服务尤其需要谨慎。不要把它配置成分钟级甚至更高频率的采样任务,也不要为了“多取几份证据”连续执行。
jmap -dump:<dump_options> <pid>通过 jmap 生成 HPROF 堆转储文件,用于离线分析内存泄漏和对象引用关系;文件可能很大,执行前应确认磁盘空间。
用 jmap 导出堆
当需要离线分析内存泄漏、对象占用或引用链时,可用 jmap 把目标 JVM 的 Java 堆写成 HPROF 文件。堆转储可能造成明显暂停和大量磁盘 I/O,因此生产环境应先确认目标进程、磁盘余量和可接受的影响窗口。
基本语法
jmap -dump:<dump_options> <pid><pid> 必须是可附加的 Java 进程。执行工具的用户通常需要具备访问目标 JVM 的权限,并建议使用与目标 JVM 相匹配的 JDK 工具。
关键选项
format=b:以二进制 HPROF 格式写出堆转储,供 Eclipse MAT、VisualVM 等工具离线分析。file=<PATH>:指定输出文件;目标目录必须可写,并应预留足够空间。live:只转储仍存活的对象。它可能带来额外的 GC 和暂停压力,不应仅为了缩小文件而在繁忙生产实例上随意启用。
不指定 live 时会包含堆中的全部对象,更适合保留故障现场;具体文件大小与当时堆占用有关。
导出并验证文件
下面先检查 /tmp 所在文件系统的空间,再导出堆并确认文件已经生成:
df -h /tmp
jmap -dump:format=b,file=/tmp/heap.hprof 12345
ls -lh /tmp/heap.hprof预期输出:jmap 成功时会报告正在写入以及堆转储文件已创建,随后 ls 能看到非空的 HPROF 文件。文件大小和耗时取决于实际堆状态。
Dumping heap to /tmp/heap.hprof ...
Heap dump file created [<ID> bytes in <TIME> secs]
-rw------- ... <ID> ... /tmp/heap.hprof<ID> 和 <TIME> 为动态值,不同 JDK、操作系统及堆大小下输出格式也可能略有差异。
风险与恢复
堆转储不是低成本采样操作。大堆实例可能出现较长暂停,并瞬间写入数 GB 甚至更大的文件;磁盘空间不足还可能使同一文件系统上的其他服务受到影响。执行前应确认 PID,优先写入容量充足且不会挤占应用关键目录的文件系统。
如果命令失败或被中断,应检查目标路径是否留下不完整文件;确认该文件不再需要后再删除并释放空间。若只需先判断哪些类占用内存较多,可先使用对象直方图等开销更低的诊断手段,再决定是否采集完整堆。
线程与锁
jstack [-l] <pid>打印目标 Java 进程中各线程的 Java 调用栈,适合定位 CPU 飙高、线程卡住、锁等待和疑似死锁等运行时问题。
查看线程栈
当 Java 进程出现 CPU 飙高、请求卡住、线程池不推进或疑似死锁时,可用 jstack 获取某一时刻的线程快照。重点不是只看调用栈长度,而是结合线程状态、重复出现的栈帧以及锁等待关系判断线程正在做什么。
基本语法
jstack [-l] <pid><pid> 是目标 Java 进程 ID。默认输出各线程的 Java 调用栈;加入 -l 后还会打印额外的锁相关信息,排查竞争和死锁时更有价值。
导出线程栈
生产排查通常把完整输出保存到文件,避免终端滚屏丢失信息。下面同时验证文件中确实包含线程状态:
jstack -l 12345 > /tmp/jstack-12345.txt
grep -m 2 'java.lang.Thread.State:' /tmp/jstack-12345.txt预期输出:文件中会记录多个线程的名称、状态和调用栈;grep 打印其中前两条线程状态。实际状态取决于采样时刻。
java.lang.Thread.State: <STATE>
java.lang.Thread.State: <STATE><STATE> 常见值包括 RUNNABLE、BLOCKED、WAITING 和 TIMED_WAITING。单个状态本身不能直接证明故障,例如 RUNNABLE 既可能表示线程正在消耗 CPU,也可能表示它正在执行本地或 I/O 相关工作,需要结合栈帧和多次采样判断。
排查重点
CPU 飙高时,先从操作系统侧找出高 CPU 线程,再把线程 ID 与线程转储中的线程对应起来,观察多次采样时是否持续停留在相同热点栈。线程卡住时则重点关注大量线程是否集中在同一业务调用、同一锁或同一外部资源等待点。
看到大量 BLOCKED 时,应继续检查它们等待的监视器及持有锁的线程;大量 WAITING 或 TIMED_WAITING 可能只是线程池、队列或定时任务的正常等待。若 JVM 检测到 Java 层死锁,线程转储通常会在后部给出相关锁和线程关系。
风险与使用边界
一次线程转储通常比完整堆转储轻量,但在超大线程数进程上仍可能产生较大的输出并带来短暂诊断开销。不要只凭单次快照断言 CPU 热点或永久卡死;更可靠的方法是在问题持续期间间隔采集多份线程栈,比较同一线程的状态和调用路径是否持续不变。
如果 jstack 无法附加目标进程,应先检查 PID、执行用户权限、容器 PID 命名空间以及 JDK 工具与目标 JVM 的兼容性,而不是反复高频执行。
jcmd <pid> Thread.print [-e] [-l]通过 jcmd 打印目标 JVM 的线程和调用栈,可附带扩展线程或并发锁信息;现代 JDK 线上诊断通常可优先使用该入口。
用 jcmd 查看线程
当 JVM 出现请求卡顿、CPU 异常、线程阻塞或疑似死锁时,可用 Thread.print 获取目标进程当前线程栈。它不会修改应用状态,适合作为线上线程问题的第一现场快照。
基本语法
jcmd <PID> Thread.print [-e] [-l]<PID>:目标 JVM 的进程 ID,可先用jcmd -l或操作系统进程工具确认。-l:额外打印java.util.concurrent锁相关信息,排查竞争、等待和死锁时通常值得开启。-e:打印扩展线程信息;输出会更详细,诊断线程资源问题时再使用。
常用示例
jcmd <PID> Thread.print -l预期输出:实际线程名、线程编号、对象地址和调用栈会随现场变化,输出主体包含各线程状态、Java 调用栈以及启用 -l 后的并发锁信息。
<PID>:
Full thread dump <JVM-DESCRIPTION>:
...
"<THREAD-NAME>" #<ID> ...
java.lang.Thread.State: <STATE>
at <STACK-FRAME>
...重点先看 BLOCKED、长期 WAITING 或 TIMED_WAITING 的线程,再结合多个线程是否竞争同一把锁判断瓶颈。单次快照只能说明一个时刻的状态;分析持续卡顿时,应间隔数秒采集多次并比较相同线程的调用栈是否变化。
风险与边界
Thread.print 的开销通常可控,但线程数很多时会产生大量输出并带来短时诊断开销,不宜高频循环执行。目标 JVM 还必须允许当前用户附加;容器、不同用户或受限 Attach 环境中可能出现无法连接目标进程的情况。
JFR 性能分析
jcmd <pid> JFR.start [options]对正在运行的 JVM 启动 Flight Recorder 性能记录,可设置名称、持续时间、配置模板和输出文件,适合采集真实线上性能现场。
启动 JFR 记录
需要分析 CPU、分配、GC、线程、锁竞争等一段时间内的性能行为时,可通过 JFR.start 为正在运行的 JVM 启动 Java Flight Recorder。与单次线程或堆快照相比,JFR 更适合保留连续的性能现场。
基本语法
jcmd <PID> JFR.start [options]常用选项以 key=value 形式传入:
name=<NAME>:为本次记录指定名称,便于后续用JFR.check、JFR.dump或JFR.stop定位记录。settings=profile:使用更偏向性能分析的事件配置;采集信息更丰富,开销通常也高于较轻量的默认配置。duration=<TIME>:设置自动停止时间,例如60s、5m。filename=<PATH>:指定记录文件。目录必须对目标 JVM 进程可写,而不只是对执行jcmd的终端用户可写。
常用示例
下面启动一段 60 秒的性能记录,并立即检查记录是否已经处于运行状态:
jcmd <PID> JFR.start name=profile settings=profile duration=60s filename=/tmp/profile.jfr
jcmd <PID> JFR.check name=profile预期结果:第一条命令返回记录已启动的信息,第二条命令能找到名为 profile 的记录。记录编号、时间和详细统计由实际 JVM 决定;到达 60s 后,记录自动结束并写入指定文件。
<PID>:
Started recording <ID>.
...
<PID>:
Recording <ID>: name=profile ...完成后确认 /tmp/profile.jfr 已生成,再使用 JDK Mission Control 等支持 JFR 的工具打开分析。若实际输出中的记录编号、开始时间或事件统计与示例不同,属于正常现象。
风险与边界
JFR 面向生产诊断设计,但并非零开销。settings=profile 会启用更多适合性能分析的事件,长时间持续记录前应先评估业务负载和磁盘空间;只为捕获短暂异常时,优先设置明确的 duration。