add -d|--top-delay option

Author: oldratlee

docs/java.md

@@ -94,26 +94,29 @@ Example:
   show-busy-java-threads 3 10  # update every 3 seconds, update 10 times
 
 Options:
-  -p, --pid <java pid>      find out the highest cpu consumed threads from the specifed java process,
+  -p, --pid <java pid>      find out the highest cpu consumed threads from the specified java process,
                             default from all java process.
-  -c, --count <num>         set the thread count to show, default is 5
-  -a, --append-file <file>  specify the file to append output as log
+  -c, --count <num>         set the thread count to show, default is 5.
+  -a, --append-file <file>  specifies the file to append output as log.
   -P, --use-ps              use ps command to find busy thread(cpu usage) instead of top command,
                             default use top command, because cpu usage of ps command is expressed as
                             the percentage of time spent running during the entire lifetime of a process,
                             this is not ideal.
-  -s, --jstack-path <path>  specify the path of jstack command
-  -S, --jstack-file-dir <path>  specify the dir for storing jstack output files, and keep files.
+  -d, --top-delay           specifies the delay between top samples, default is 0.5 (second).
+                            get thread cpu percentage during this delay interval.
+                            more info see top -d option. eg: -d 1 (1 second).
+  -s, --jstack-path <path>  specifies the path of jstack command.
+  -S, --jstack-file-dir <path>  specifies the dir for storing jstack output files, and keep files.
                             default store jstack output files at tmp dir, and auto remove after run.
                             use this option to keep files so as to review jstack later.
-  -F, --force               set jstack to force a thread dump
-                            use when jstack <pid> does not respond (process is hung)
-  -m, --mix-native-frames   set jstack to print both java and native frames (mixed mode)
-  -l, --lock-info           set jstack with long listing. Prints additional information about locks
-  -h, --help                display this help and exit
-  delay                     the delay between updates in seconds
-  count                     the number of updates
-                            delay/count arguments imitates the style of vmstat command
+  -F, --force               set jstack to force a thread dump.
+                            use when jstack <pid> does not respond (process is hung).
+  -m, --mix-native-frames   set jstack to print both java and native frames (mixed mode).
+  -l, --lock-info           set jstack with long listing. Prints additional information about locks.
+  -h, --help                display this help and exit.
+  delay                     the delay between updates in seconds.
+  count                     the number of updates.
+                            delay/count arguments imitates the style of vmstat command.
 ```
 
 ### 示例

show-busy-java-threads

@@ -83,26 +83,29 @@ Example:
   ${PROG} 3 10  # update every 3 seconds, update 10 times
 
 Options:
-  -p, --pid <java pid>      find out the highest cpu consumed threads from the specifed java process,
+  -p, --pid <java pid>      find out the highest cpu consumed threads from the specified java process,
                             default from all java process.
-  -c, --count <num>         set the thread count to show, default is 5
-  -a, --append-file <file>  specify the file to append output as log
+  -c, --count <num>         set the thread count to show, default is 5.
+  -a, --append-file <file>  specifies the file to append output as log.
   -P, --use-ps              use ps command to find busy thread(cpu usage) instead of top command,
                             default use top command, because cpu usage of ps command is expressed as
                             the percentage of time spent running during the entire lifetime of a process,
                             this is not ideal.
-  -s, --jstack-path <path>  specify the path of jstack command
-  -S, --jstack-file-dir <path>  specify the dir for storing jstack output files, and keep files.
+  -d, --top-delay           specifies the delay between top samples, default is 0.5 (second).
+                            get thread cpu percentage during this delay interval.
+                            more info see top -d option. eg: -d 1 (1 second).
+  -s, --jstack-path <path>  specifies the path of jstack command.
+  -S, --jstack-file-dir <path>  specifies the dir for storing jstack output files, and keep files.
                             default store jstack output files at tmp dir, and auto remove after run.
                             use this option to keep files so as to review jstack later.
-  -F, --force               set jstack to force a thread dump
-                            use when jstack <pid> does not respond (process is hung)
-  -m, --mix-native-frames   set jstack to print both java and native frames (mixed mode)
-  -l, --lock-info           set jstack with long listing. Prints additional information about locks
-  -h, --help                display this help and exit
-  delay                     the delay between updates in seconds
-  count                     the number of updates
-                            delay/count arguments imitates the style of vmstat command
+  -F, --force               set jstack to force a thread dump.
+                            use when jstack <pid> does not respond (process is hung).
+  -m, --mix-native-frames   set jstack to print both java and native frames (mixed mode).
+  -l, --lock-info           set jstack with long listing. Prints additional information about locks.
+  -h, --help                display this help and exit.
+  delay                     the delay between updates in seconds.
+  count                     the number of updates.
+                            delay/count arguments imitates the style of vmstat command.
 EOF
 
     exit $exit_code
@@ -118,7 +121,7 @@ uname | grep '^Linux' -q || fatal "Error: $PROG only support Linux, not support
 # parse options
 ################################################################################
 
-readonly ARGS=`getopt -n "$PROG" -a -o p:c:a:s:S:PFmlh -l count:,pid:,append-file:,jstack-path:,jstack-file-dir:,use-ps,force,mix-native-frames,lock-info,help -- "$@"`
+readonly ARGS=`getopt -n "$PROG" -a -o p:c:a:s:S:Pd:Fmlh -l count:,pid:,append-file:,jstack-path:,jstack-file-dir:,use-ps,top-delay:,force,mix-native-frames,lock-info,help -- "$@"`
 [ $? -ne 0 ] && usage 1
 eval set -- "${ARGS}"
 
@@ -148,6 +151,10 @@ while true; do
         use_ps=true
         shift
         ;;
+    -d|--top-delay)
+        top_delay="$2"
+        shift 2
+        ;;
     -F|--force)
         force=-F
         shift
@@ -171,6 +178,7 @@ while true; do
 done
 count=${count:-5}
 use_ps=${use_ps:-false}
+top_delay=${top_delay:-0.5}
 
 if [ -n "$jstack_file_dir" -a -e "$jstack_file_dir" ]; then
     if [ ! -d "$jstack_file_dir" ]; then
@@ -310,7 +318,7 @@ __top_threadId_cpu() {
     #    so as to prevent top command output format being change by .toprc user config file unexpectedly
     # 3. use option `-d 0.1`(interval 0.1 second) and `-n 2`(show 2 times), and use second time update data
     #    to get cpu percentage of thread in 0.1 second interval
-    HOME="$tmp_store_dir" top -H -b -d 0.1 -n 2 |
+    HOME="$tmp_store_dir" top -H -b -d $top_delay -n 2 |
         awk '{
                 if (idx == 3 && $0 != "")
                     # only print 4th text block