Java 性能监控工具：jcmd 命令详解

示例：查看 PID=1234 支持的命令

jcmd 1234 help

输出核心分类（关键命令）：

• JVM 信息查询：VM.version（JVM 版本）、VM.flags（JVM 参数）、VM.system_properties（系统属性）；
• 性能监控：GC.class_histogram（类实例统计）、GC.heap_info（堆内存信息）、Thread.print（线程 Dump）；
• 数据采集：GC.heap_dump（堆 Dump）、VM.capture_output（捕获应用输出）；
• 动态调整：VM.set_flag（修改 JVM 标志）、VM.print_flags_final（查看最终生效的参数）。

3. JVM 基础信息查询（替代 jinfo）

（1）查看 JVM 版本和启动时间

命令：

jcmd <PID> VM.version

输出示例：

Java HotSpot(TM) 64-Bit Server VM version 25.341-b10
JDK version: 1.8.0_341-b10
JVM 启动时间：2025-12-01T10:00:00+0800（已运行 2h 30m）

（2）查看 JVM 启动参数（含默认值 + 自定义）

命令：

jcmd <PID> VM.flags # 显示所有参数（默认 + 自定义）
jcmd <PID> VM.flags -all # 显示所有参数（含隐含参数，详细版）
jcmd <PID> VM.flags -long # 仅显示长格式参数（不含缩写）

输出示例（自定义参数高亮）：

-XX:InitialHeapSize=2147483648（初始堆 2G）
-XX:MaxHeapSize=4294967296（最大堆 4G）
-XX:+UseG1GC（使用 G1 垃圾收集器）
-XX:MetaspaceSize=134217728（元空间初始 128M）

（3）查看系统属性（替代 System.getProperties()）

命令：

jcmd <PID> VM.system_properties

输出示例：

java.version=1.8.0_341
user.home=/root
spring.profiles.active=prod（Spring Boot 环境）
file.encoding=UTF-8

4. 内存监控与分析（替代 jmap）

（1）查看堆内存整体信息

命令：

jcmd <PID> GC.heap_info

输出示例（关键信息解读）：

Heap Usage:
G1 Heap: regions = 2048（G1 Region 数量）
capacity = 4294967296 bytes (4.0GB)（堆总容量）
used = 1572864000 bytes (1.5GB)（已使用）
free = 2722103296 bytes (2.5GB)（空闲）
used 率 = 36.62%
Metaspace: capacity = 1610612736 bytes (1.5GB)（元空间容量）
used = 858993456 bytes (819.2MB)（已使用）
free = 751619280 bytes (704.8MB)（空闲）

用途：快速判断堆/元空间是否溢出、使用率是否异常。

（2）生成堆 Dump（内存快照，用于分析内存泄漏）

命令：

jcmd <PID> GC.heap_dump <输出路径> # 生成 hprof 格式快照
jcmd <PID> GC.heap_dump <输出路径> -all # 包含所有线程的栈信息（更全面）

示例：生成 PID=1234 的堆 Dump 到 /tmp 目录

jcmd 1234 GC.heap_dump /tmp/app_heap_dump.hprof

注意：

• 生成过程中 JVM 会短暂停顿（STW），建议在低峰期执行；
• 快照文件较大（接近堆使用量），确保磁盘有足够空间；
• 后续可通过 MAT（Memory Analyzer Tool）或 JProfiler 分析快照。

（3）查看类实例统计（按内存占用排序）

命令：

jcmd <PID> GC.class_histogram # 实时输出类统计
jcmd <PID> GC.class_histogram > /tmp/class_histogram.txt # 输出到文件

输出示例（关键列解读）：

 num #instances #bytes class name
----------------------------------------------
1: 85623 123456784 java.lang.String（字符串实例最多）
2: 32456 98765432 java.util.HashMap$Node（HashMap 节点）
3: 15678 76543210 com.alibaba.fastjson.JSONObject（业务类）

用途：快速定位内存占用 Top 的类（如大量重复字符串、未释放的集合）。

5. 线程监控与分析（替代 jstack）

（1）生成线程 Dump（查看线程状态、死锁等）

命令：

jcmd <PID> Thread.print # 实时输出线程信息
jcmd <PID> Thread.print -l # 包含锁信息（更详细）
jcmd <PID> Thread.print > /tmp/thread_dump.txt # 输出到文件

输出示例（关键线程状态解读）：

2025-12-02 14:30:00 Full thread dump Java HotSpot(TM) 64-Bit Server VM (25.341-b10 mixed mode):
"http-nio-8080-exec-1" #23 daemon prio=5 os_prio=0 tid=0x00007f1234567890 nid=0x1234 runnable [0x00007f1234560000]
java.lang.Thread.State: RUNNABLE（运行中）
at sun.nio.ch.EPollArrayWrapper.epollWait(Native Method)
at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1742)
"DubboServerHandler-192.168.1.1:20880-thread-5" #30 prio=5 os_prio=0 tid=0x00007f123456abcd nid=0x5678 waiting for monitor entry [0x00007f1234670000]
java.lang.Thread.State: BLOCKED (on object monitor)（阻塞，等待锁）
at com.example.service.UserService.queryUser(UserService.java:45)
- waiting to lock <0x0000000765432100> (a com.example.service.UserService)
"GC Thread#0" #3 daemon prio=9 os_prio=0 tid=0x00007f1234561234 nid=0x9abc runnable [0x0000000000000000]

核心用途：

• 排查死锁（输出中会明确标记 Found one Java-level deadlock）；
• 定位线程阻塞（BLOCKED 状态）、等待（WAITING/TIMED_WAITING）的原因；
• 分析线程池是否耗尽（如 Tomcat 线程池所有线程处于 RUNNABLE 且长时间不释放）。

6. GC 相关操作与监控（替代 jstat）

（1）触发一次 Full GC（测试/应急场景）

命令：

jcmd <PID> GC.run # 触发 Full GC（等同于 System.gc()，但 JVM 可能忽略）
jcmd <PID> GC.run_finalization # 触发对象 finalize() 方法执行

注意：

• 不建议生产环境频繁执行（Full GC 会导致 STW，影响性能）；
• 仅用于应急（如内存占用过高需快速释放）或测试场景。

（2）查看 GC 详细统计信息

命令：

jcmd <PID> GC.statistics # 输出 GC 统计（次数、耗时、内存变化）
jcmd <PID> GC.statistics -all # 详细版（含各代垃圾回收信息）

输出示例：

GC Statistics:
G1 Young Generation:
Collections: 123（Young GC 次数）
Total Time: 456ms（总耗时）
Avg Time: 3.7ms（平均耗时）
G1 Old Generation:
Collections: 5（Full GC 次数）
Total Time: 789ms（总耗时）
Avg Time: 157.8ms（平均耗时）
Heap After Last GC: 1.2GB（最后一次 GC 后堆使用量）

用途：分析 GC 频率、耗时是否正常（如 Full GC 频繁可能是内存泄漏或参数不合理）。

7. 动态调整 JVM 参数（无需重启应用）

jcmd 支持修改 JVM 中标记为可动态调整的参数（通过 VM.flags -all 可查看参数是否支持 dynamic）。

命令格式：

jcmd <PID> VM.set_flag <参数名> <值>

常用场景示例：

1. 调整 G1 GC 的最大停顿时间目标（默认 200ms）：

jcmd 1234 VM.set_flag MaxGCPauseMillis 100 # 改为 100ms

2. 启用/禁用 GC 日志（动态开启 GC 监控）：

# 启用 GC 日志（输出到文件，按大小轮转）
jcmd 1234 VM.set_flag PrintGCDetails true
jcmd 1234 VM.set_flag PrintGCTimeStamps true
jcmd 1234 VM.set_flag GCLogFileSize 100m # 单个日志文件大小
jcmd 1234 VM.set_flag NumberOfGCLogFiles 10 # 日志文件轮转数
jcmd 1234 VM.set_flag LogFile /tmp/gc.log # 日志输出路径

3. 调整元空间最大容量（避免元空间溢出）：

jcmd 1234 VM.set_flag MaxMetaspaceSize 2g # 元空间最大 2G

注意：

• 不可动态调整的参数（如 -Xms、-Xmx 初始/最大堆）修改会报错；
• 修改前建议先通过 VM.flags 查看当前值，避免参数冲突。

五、常见问题与注意事项

1. 权限不足：执行 jcmd 时提示 Permission denied，需切换到目标进程的用户（如 sudo -u appuser jcmd）；
2. 进程未找到：提示 No such process，可能是 PID 错误（用 jcmd -l 重新确认）或进程已退出；
3. 命令不支持：部分命令（如 GC.heap_dump）在低版本 JDK（<7u40）可能不支持，建议升级 JDK；
4. 性能影响：生成堆 Dump、线程 Dump 时会触发 STW（停顿时间与堆大小/线程数正相关），生产环境需避开高峰；
5. 日志过大：动态开启 GC 日志后，需定期清理日志文件，避免磁盘占满。

六、jcmd 与传统工具对比

总结

jcmd 是 Java 性能监控与诊断的'瑞士军刀'，整合了传统工具的核心能力，且支持动态调整参数，是生产环境排查问题（内存泄漏、线程阻塞、GC 异常）的首选工具。掌握其常用命令（进程查询、内存 Dump、线程分析、参数调整），可大幅提升问题排查效率，无需依赖第三方工具即可完成大部分 JVM 监控需求。