Troubleshooting Tip: Advanced usage of 'diagnose sys top-summary'

[fquerzo_FTNT]

Description

This article describes advanced options on how to work with the troubleshooting tool 'diagnose sys top-summary' and all of its capabilities.

The top-summary command was deprecated on FOS 6.4x and onwards. 

Scope

FortiGate.

Solution

diagnose sys top-summary ‘<options>’

OPTIONS:

-n LINES OR --num=LINES            | Number of top processes to show (20 by default)
-i INTERVAL OR --interval=INTERVAL | Update interval, in seconds (1 by default)
-s SORT OR --sort=SORT             | Sort mode: [cpu_percent (default)|mem|fds|pid]
-h OR --help                       | show this help message and exit

After the 'diagnose sys top-summary' command is running, here are the options:

h OR ?             - print the list of all available commands
q OR Ctrl C        – quit
m                  - sort by the memory consumption
c                  - sort by the CPU percentage
f                  - sort by the number of open file descriptors
p                  - sort by PID
k OR <Up>          - go up in the list of the processes
j OR <Down>        - go down in the list of the processes
<Enter> or <Space> - toggle the process tree

LEGEND:

* - indicator of the line currently active.
^ - indicator of what parameter the output is sorted in descending order.

EXAMPLE:

diagnose sys top-summary ‘-n 5 --sort=mem’
   CPU [|                                       ]   4.8%
   Mem [|||||||||||||||||||||                   ]  54.0%  1100M/2012M
   Processes: 5 (running=1 sleeping=106)
   PID      RSS   CPU% ^MEM%   FDS     TIME+  NAME
 * 150      67M    0.0  3.4    22  01:11.84  httpsd [x4]
   171      57M    0.0  2.8   100  00:21.99  wad [x6]
   8050     46M    0.0  2.3    12  00:00.38  pyfcgid [x4]
   168      45M    0.0  2.3    16  00:05.57  reportd
   159      41M    0.0  2.1    26  00:48.88  forticron

The output shows 5 lines of output which is sorted in descending order by memory utilization.
Now, press ‘c’ to sort processes by CPU utilization, press <down> 4 times to select the miglogd parent instance and press <enter> to see details of the child instance

   CPU [|                                       ]   4.8%
   Mem [|||||||||||||||||||||                   ]  54.0%  1099M/2012M
   Processes: 5 (running=1 sleeping=106)
   PID      RSS  ^CPU% MEM%   FDS     TIME+  NAME
   180      35M    4.8  1.8    12  00:01.51  sshd [x4]
   134       9M    0.0  0.5    88  00:09.99  zebos_launcher [x12]
   135       6M    0.0  0.3    12  00:01.45  bfdd
   147       6M    0.0  0.3    12  00:00.70  uploadd
 * 148      22M    0.0  1.1   103  01:29.71  miglogd [x2]
    203      22M    0.0  1.1    42  00:44.53  miglogd                    <----- Child instance of the parent process shown.