对应于观看“OS指标及繁忙进程”的top，vjtop就是观察“JVM进程指标及其繁忙线程”的首选工具。
JVM进程信息：收集了进程在OS层面和JVM层面的所有重要指标。大家为什么喜欢用dstat看OS状态，因为它将你想看的数据全都收集呈现眼前了，vjtop也是这样的风格。
繁忙线程信息： 对比于“先top -H 列出线程，再执行jstack拿到全部线程，再手工换算十与十六进制的线程号”的繁琐过程，vjtop既方便，又可以连续跟踪，更不会因为jstack造成JVM停顿。
对于超出正常范围的值，vjtop还很贴心的进行了变色显示。
运行时不造成应用停顿，可在线上安全使用。
常用场景：
-
性能问题快速定位，用vjtop显示出CPU繁忙或内存消耗大的线程，再实时交互翻查该线程的statk trace。
-
压测场景，用vjtop实时反馈JVM进程状态，类似于用dstast对操作系统指标的监控。
-
生产环境，当应用出现问题时，用vjtop快速了解进程的状态。还可与监控系统结合，发现指标(如CPU、超时请求数)超出阈值时，用钩子脚本调用vjtop来纪录事发地的状况。
在jvmtop 的基础上二次开发，结合 SJK的优点，从/proc ， PerfData，JMX等处，以更高的性能，获取更多的信息。
Download 1.0.6.zip (from Maven Central)
vjtop运行所需权限与jstak相同，必须与目标JVM使用相同的JDK版本运行，必须与目标JVM使用相同用户运行。如果仍有问题，请看后面的执行问题排查章节。
// 占用CPU最多的线程
./vjtop.sh <PID>
- 从/proc/PID/* 文件中获取进程数据, 详见proc filesystem
- 从JDK的PerfData文件中获取JVM数据(JDK每秒写入/tmp/hsperfdata_$userid/$pid文件的统计数据)
- 使用目标JVM的JMX中获取JVM数据（如果目标JVM还没启动JMX，通过attach方式动态加载）
如果数据同时在PerfData和JMX存在，优先使用PerfData。 网络流量数据在/proc/PID/*中未能按进程区分，因此不再监控。
使用ThreadMxBean操作：
- getAllThreadIds()获得所有Thread Id
- getThreadCpuTime(tids)获得所有线程的CPU时间 (以及SYS CPU，内存分配)
- 排序后，用getThreadInfo(tids)获得前10名线程的信息，因为不取线程的StackTrace，不会堵塞应用。
// 按时间区间内，线程占用的CPU排序，默认显示前10的线程，默认每10秒打印一次
./vjtop.sh <PID>
// 按线程从启动以来的总占用CPU来排序
./vjtop.sh --totalcpu <PID>
// 按时间区间内，线程占用的SYS CPU排序
./vjtop.sh --syscpu <PID>
// 按线程从启动以来的总SYS CPU排序
./vjtop.sh --totalsyscpu <PID>
PID: 191082 - 17:43:12 JVM: 1.7.0_79 USER: calvin UPTIME: 2d02h
PROCESS: 685.00% cpu(28.54% of 24 core), 787 thread
MEMORY: 6626m rss, 6711m peak, 0m swap | DISK: 0B read, 13mB write
THREAD: 756 live, 749 daemon, 1212 peak, 0 new | CLASS: 15176 loaded, 161 unloaded, 0 new
HEAP: 630m/1638m eden, 5m/204m sur, 339m/2048m old
NON-HEAP: 80m/256m/512m perm, 13m/13m/240m codeCache
OFF-HEAP: 0m/0m direct(max=2048m), 0m/0m map(count=0), 756m threadStack
GC: 6/66ms/11ms ygc, 0/0ms fgc | SAFE-POINT: 6 count, 66ms time, 5ms syncTime
TID NAME STATE CPU SYSCPU TOTAL TOLSYS
23 AsyncAppender-Worker-ACCESSFILE-ASYNC WAITING 23.56% 6.68% 2.73% 0.72%
560 OSP-Server-Worker-4-5 RUNNABLE 22.58% 10.67% 1.08% 0.48%
9218 OSP-Server-Worker-4-14 RUNNABLE 22.37% 11.45% 0.84% 0.40%
8290 OSP-Server-Worker-4-10 RUNNABLE 22.36% 11.24% 0.88% 0.41%
8425 OSP-Server-Worker-4-12 RUNNABLE 22.24% 10.72% 0.98% 0.47%
8132 OSP-Server-Worker-4-9 RUNNABLE 22.00% 10.68% 0.90% 0.42%
8291 OSP-Server-Worker-4-11 RUNNABLE 21.80% 10.09% 0.89% 0.41%
8131 OSP-Server-Worker-4-8 RUNNABLE 21.68% 9.77% 0.93% 0.44%
9219 OSP-Server-Worker-4-15 RUNNABLE 21.56% 10.43% 0.90% 0.41%
8426 OSP-Server-Worker-4-13 RUNNABLE 21.35% 10.42% 0.66% 0.31%
Total : 668.56% cpu(user=473.25%, sys=195.31%) by 526 atcive threads(which cpu>0.05%)
Setting: top 10 threads order by CPU, flush every 10s
Input command (h for help):
进程区数据解释:
PROCESS:thread: 进程的操作系统线程数,cxtsw为主动与被动的线程上下文切换数MEMORY:rss为 Resident Set Size, 进程实际占用的物理内存;peak为最峰值的rss;swap为进程被交换到磁盘的虚拟内存。DISK: 真正达到物理存储层的读/写的速度。THREAD: Java线程数,active为当前线程数,daemon为active线程中的daemon线程数,new为刷新周期内新创建的线程数。CLASS:loaded为当前加载的类数量，unloaded为总卸载掉的类数量，new为刷新周期内新加载的类数量。HEAP: 1.0.3版开始每一项有三个数字, 分别为1.当前使用内存, 2.当前已申请内存, 3.最大内存; 如果后两个数字相同时则合并。sur: 当前存活区的大小，注意实际有from, to 两个存活区。NON-HEAP: 数字含义同HEAPcodeCache: JIT编译的二进制代码的存放区，满后将不能编译新的代码。direct: 堆外内存，三个数字含义同HEAP, 未显式设置最大内存时，约等于堆内存大小。注意新版Netty不经过JDK API所分配的堆外内存未在此统计。map: 映射文件内存，三个数字分别为1. map数量，2.当前使用内存，3.当前已申请内存，没有最大值数据。threadStack: Java线程所占的栈内存总和，但不包含VM线程。(since 1.0.3)ygc: YoungGC, 三个数字分别为次数／总停顿时间／平均停顿时间fgc: OldGC ＋ FullGC， 两个数字分别为次数／总执行时间，注意此时间仅为执行时间，非JVM停顿时间。SAFE-POINT: PerfData开启时可用，JVM真正的停顿次数及停顿时间，以及等待所有线程进入安全点所消耗的时间。
线程区数据解释:
CPU: 线程在打印间隔内使用的CPU百分比(按单个核计算)SYSCPU: 线程在打印间隔内使用的SYS CPU百分比(按单个核计算)TOTAL: 从进程启动到现在，线程的总CPU时间/进程的总CPU时间的百分比TOLSYS: 从进程启动到现在，线程的总SYS CPU时间/进程的总CPU时间的百分比
底部数据解释:
- 如果该线程的平均使用CPU少于单核的0.1%，这条线程将不参与排序显示，减少消耗。
// 线程分配内存的速度排序，默认显示前10的线程，默认每10秒打印一次
./vjtop.sh --memory <PID>
// 按线程的总内存分配而不是打印间隔内的内存分配来排序
./vjtop.sh --totalmemory <PID>
(忽略头信息)
THREADS-MEMORY: 30k/s allocation rate
TID NAME STATE MEMORY TOTAL-ALLOCATED
47636 RMI TCP Connection(583)-127.0.0.1 RUNNABLE 27k/s(88.76%) 17m( 0.00%)
1 main RUNNABLE 2k/s( 8.44%) 370g(83.16%)
47845 JMX server connection timeout 47845 TIMED_WAIT 251/s( 0.80%) 21k( 0.00%)
46607 Worker-501 TIMED_WAIT 60/s( 0.19%) 934m( 0.20%)
46609 Worker-502 TIMED_WAIT 60/s( 0.19%) 822m( 0.18%)
46610 Worker-503 TIMED_WAIT 60/s( 0.19%) 737m( 0.16%)
46763 Worker-504 TIMED_WAIT 60/s( 0.19%) 696m( 0.15%)
46764 Worker-505 TIMED_WAIT 60/s( 0.19%) 743m( 0.16%)
47149 Worker-506 TIMED_WAIT 60/s( 0.19%) 288m( 0.06%)
46551 Worker-500 TIMED_WAIT 60/s( 0.19%) 757m( 0.17%)
进程区数据解释:
allocation rate: 所有线程在打印间隔内每秒分配的内存
线程区数据解释:
STATE: 该线程当前的状态MEMORY: 该线程分配内存的瞬时值，即该线程在打印间隔内每秒分配的内存空间(该线程每秒分配的内存占所有线程在该秒分配的总内存的百分比)TOTAL-ALLOCATED: 该线程分配内存的历史累计值，即从进程启动到现在，该线程分配的总内存大小，该总内存大小包括已回收的对象的内存(该线程分配的总内存大小占所有线程分配的总内存大小的百分比)。
如果该线程的平均内存分配速度少于1K/s，这条线程将不参与排序显示，减少消耗。
1.在页面中输入t，再输入线程号，可打印线程的Stack Trace，看繁忙的线程在忙什么。
会引入暂停，但只取一条线程信息时停顿非常短
Input command (h for help):s
Input TID for stack:4161
at java.lang.Object.wait(Native Method)
at org.eclipse.core.internal.jobs.WorkerPool.sleep(WorkerPool.java:188)
at org.eclipse.core.internal.jobs.WorkerPool.startJob(WorkerPool.java:220)
at org.eclipse.core.internal.jobs.Worker.run(Worker.java:52)
上例子也可以直接输入 "s 4161"
- 打印Top繁忙线程的stack trace
会引入暂停，但只取若干条线程信息时停顿非常短
Input command (h for help):t
Stack trace of top 10 threads:
15: "RMI TCP Connection(15)-10.100.150.221"
java.lang.Thread.State: RUNNABLE
at sun.management.ThreadImpl.getThreadInfo1(Native Method)
at sun.management.ThreadImpl.getThreadInfo(ThreadImpl.java:178)
...
- 打印所有状态为BLOCKED的线程的stack trace
会引入暂停，取所有线程信息，时间比前面两个命令略长。但因为不获取锁信息，也不拿JNI global references等数据，所以仍比jstack快。
Input command (h for help):b
Stack trace of blocked threads:
...
- 打印所有线程的TID和线程名
Thread Id and name of all live threads:
16 : "JMX server connection timeout 16" (TIMED_WAITING)
15 : "RMI TCP Connection(15)-10.100.150.221" (RUNNABLE)
13 : "RMI Scheduler(0)" (TIMED_WAITING)
11 : "RMI TCP Accept-0" (RUNNABLE)
9 : "Attach Listener" (RUNNABLE)
4 : "Signal Dispatcher" (RUNNABLE)
1.改变显示和排序模式，在页面中输入m
Input command (h for help):m
Input number of Display Mode(1.cpu, 2.syscpu 3.total cpu 4.total syscpu 5.memory 6.total memory, current cpu): 5
2.改变显示间隔
Input command (h for help):i
Input flush interval seconds(current 10):20
Flush interval change to 20 seconds
也可以直接输入"i 20" 切换
- 设定显示的线程数
Input command (h for help):l
Input number of threads to display :20
Number of threads to display changed to 20 for next flush
也可以直接输入"l 20" 切换
4.设定按线程名过滤线程，在打印繁忙线程和全部线程时，线程名都必须包含filter字符串，大小写不敏感，不支持正则匹配和匹配符匹配。
Input command (h for help):f
Input filter of thread name (current null):Worker
thread name filter change to "Worker" for next flush (3s later)
// 打印其他选项
./vjtop.sh -h
// 结果输出到文件
./vjtop.sh <PID> > /tmp/vjtop.log
// 每5秒打印一次（默认10秒）
./vjtop.sh -i 5 <PID>
// 打印20次后退出
./vjtop.sh -n 20 <PID>
// 不带变色与换页控制码的console模式，适合不支持控制码的终端。在Windows及输出到文件时将默认使用次此模式(1.0.6)
./vjtop.sh -o clean <PID>
// key:value式的文本模式，适用于第三方工具采集vjtop的输出结果 (1.0.6)
./vjtop.sh -o text <PID>
// 只采集JVM信息，不采集繁忙线程信息 (1.0.6)
./vjtop.sh -c jvm <PID>
// 只采集繁忙线程信息，不采集JVM信息 (1.0.6)
./vjtop.sh -c thread <PID>
// 只显示线程名包含worker字样的线程，在热点线程与实时交互打印线程时都会过滤（1.0.6版开始忽略大小写）
./vjtop.sh -f worker <PID>
// 显示前20的线程（默认10）
./vjtop.sh -l 20 <PID>
// 更宽的120字节的屏幕 （默认100）
./vjtop.sh -w 120 <PID> > /tmp/vjtop.log
JVM信息告警规则
- 进程CPU：服务器总CPU50%黄， 70%红
- 进程线程：如果服务器少于8核，线程数为核数＊150 黄，核数＊225 红。 如果大于8核，核数＊100 黄, 核数＊150红。
- 进程内存： swap一旦使用即为红
- 进程磁盘IO: 读写磁盘30MB/s 黄，100MB/s 红
- CLASS: 新加载类时为黄色, 当前加载类8万为黄，15万为红
- JVM内存: 老生代，永久代，CodeCache，如果设置了Max，则Max的85%黄，95%红
- JVM线程: active规则同进程线程，new规则：新建1条线程为黄，每秒创建2条为红。
- YGC: YGC次数每秒1次以上黄，2次以上红，平均耗时100ms黄，200ms红, 总耗时达到了应用运行时间的5%黄，10%红
- FGC: 周期内的次数：1次黄，2次红
- SAFEPOINT: 安全点次数每秒2次黄，4次红，总耗时达到了应用运行时间的5%黄，10%红
线程告警规则
- 线程CPU: CPU大于50%黄，70%红，SYS大于30%黄，50%红
- JDK版本错误或tools.jar不存在
vjtop使用的java为JAVA_HOME/bin/java, 需要JDK7及以上，但"不要求"与目标应用的JVM使用相同的JDK版本。
vjtop需要依赖JAVA_HOME/lib/tools.jar
JAVA_HOME的定位，通过读取环境变量JAVA_HOME，如果没有定义，则尝试通过"which java"定位java从而获得相对路径。
- 不能连入目标jvm
再次，vjtop 使用JVM attach机制 连入PID 并获得JMX的本地连接地址，所需权限与jstack相同， attach失败时出现如下报错
ERROR: Could not attach to process.
可以先执行jstack PID对比一下效果。
可能的原因有：
-
PID写错，进程不存在
-
VM Attach时，会强制检查执行vjtop的用户，与目标JMV的用户一致，否则会抛出"well-known file is not secure"之类的异常。
如果用户有sudo权限，可以尝试切换到目标用户，并把JAVA_HOME等环境变量带到新用户。
sudo -E su - <targetUser>
-
/tmp/.java_pid$PID 文件在首次连接时会生成，但如果生成之后被大家的文件清理脚本错误删除，JVM将不再能连入，只能重启应用。
-
目标JVM使用启动参数-Djava.io.tmpdir，重定向了tmp目录路径，导致读不到/tmp/.java_pid$PID 文件。
-
目标JVM使用启动参数-XX:+DisableAttachMechanism禁止了attach。
如果实在没有办法attach，可以考虑在原目标进程中配置JMX启动参数，设定JMX的地址与端口，然后在vjtop中指定该地址
目标进程的JVM参数：
-Djava.rmi.server.hostname=127.0.0.1 -Dcom.sun.management.jmxremote.port=7001 -Dcom.sun.management.jmxremote
-Dcom.sun.management.jmxremote.X=false -Dcom.sun.management.jmxremote.ssl=false
vjtop的命令(since 1.0.3):
./vjtop.sh -j 127.0.0.1:7001 <PID>
- 新功能：进程的物理内存，SWAP，IO，物理线程信息。
- 新功能：将内存信息与GC信息拆开不同分代独立显示
- 新功能：CodeCache与堆外内存，Thread Stack内存信息，SafePoint等信息
- 新功能：对偏离正常范围的值，进行变色提示
- 新功能：线程内存分配速度的展示与排序 (from SJK)
- 新功能：线程SYS CPU的展示与排序，应用启动以来线程的总CPU间的排序 (from SJK)
- 新配置项：打印间隔，展示线程数
- 新功能： 选择打印某条线程的线程栈，所有TopN繁忙线程的栈，所有Blocked状态线程的栈
- 新功能： 打印全部的线程名
- 新功能： 实时切换显示模式和排序，刷新频率和显示线程数
- 删除jvmtop会造成应用停顿的Profile页面
- 删除jvmtop获取所有Java进程信息，有着不确定性的Overview页面
- 默认打印间隔调整到10s
- 进程信息尝试从PerfData而不是JMX读取数据，减少消耗
- 线程信息减少了几倍的耗时，通过批量获取线程CPU时间(from SJK)等方法
- 支持输出文本格式给第三方监控工具使用
- 支持只输出JVM信息或繁忙线程信息
- 支持vm attach总是失败时，直接配置JMX的方式连入