Ubuntu Manpage: pcp-mpstat - Report CPU and Interrupt related statistics.

NAME

       pcp-mpstat - Report CPU and Interrupt related statistics.

SYNOPSIS

       pcp  mpstat [ -A ] [ -u ] [ -V ] [ -I { SUM | CPU | SCPU | ALL } ] [ -P { cpu1,cpu2 [,...]
       | ON | ALL } ] [ -t interval ] [ -s count ] [ -a archive ]

DESCRIPTION

       The pcp mpstat command writes to standard output activities for each available  processor,
       processor 0 being the first one. If no activity/option has been selected, then the default
       report is the CPU utilization [ -u ] report.

       The interval parameter specifies the amount  of  time  in  seconds  between  each  report.
       Default  is  one second.  The value of count parameter determines the number of samples to
       be displayed.  Default is continous.

OPTIONS

-A This option is equivalent to specifying -u -I ALL -P ALL

-I { SUM | CPU | SCPU | ALL }
Report interrupts statistics.
With the SUM keyword, the pcp mpstat command reports the total number of interrupts
per processor. The following values are displayed:

CPU
Processor number. The keyword all indicates that statistics are calculated
as averages among all processors.

intr/s
Show the total number of interrupts received per second by the CPU or CPUs.

With the CPU keyword, the number of each individual interrupt received per second
by the CPU or CPUs is displayed. Interrupts are those under the
kernel.percpu.interrupts metric tree.

With the SCPU keyword, the number of each individual software interrupt received
per second by the CPU or CPUs is displayed. Software interrupts are those under
the kernel.percpu.softirqs tree

The ALL keyword is equivalent to specifying all the keywords above and therefore
all the interrupts statistics are displayed.

-P { cpu1,cpu2[,...] | ON | ALL }
Indicate the processor number for which statistics are to be reported. cpu1 and
cpu2 are the processor numbers. A list of required processor numbers can be
provided. Note that processor 0 is the first processor.

The ON keyword indicates that statistics are to be reported for every online
processor, whereas the ALL keyword indicates that statistics are to be reported for
all processors.

-u Report CPU utilization. The following values are displayed:

CPU
Processor number. The keyword ALL indicates that statistics are calculated
as averages among all processors.

%usr
Show the percentage of CPU utilization that occurred while executing at the
user level (application).

%nice
Show the percentage of CPU utilization that occurred while executing at the
user level with nice priority.

%sys
Show the percentage of CPU utilization that occurred while executing at the
system level (kernel). Note that this does not include time spent servicing
hardware and software interrupts.

%iowait
Show the percentage of time that the CPU or CPUs were idle during which the
system had an outstanding disk I/O request.

%irq
Show the percentage of time spent by the CPU or CPUs to service hardware
interrupts.

%soft
Show the percentage of time spent by the CPU or CPUs to service software
interrupts.

%steal
Show the percentage of time spent in involuntary wait by the virtual CPU or
CPUs while the hypervisor was servicing another virtual processor.

%guest
Show the percentage of time spent by the CPU or CPUs to run a virtual
processor.

%gnice
Show the percentage of time spent by the CPU or CPUs to run a niced guest.

%idle
Show the percentage of time that the CPU or CPUs were idle and the system
did not have an outstanding disk I/O request.

Note: On SMP machines a processor that does not have any activity at all is a
disabled (offline) processor.

-a FILE , --archive = FILE
Causes pcp-mpstat to use the specified archive than connecting to PMCD. The
argument to -a is a comma-separated list of names, each of which may be the base
name of an archive or the name of a directory containing one or more archives.
Archives can be created using pmlogger(1).

-s N , --samples = N
Set the number of samples to be displayed. Since the first sample is used for the
rate conversion of some of the metrics, the total number of samples reported are
one less that N. Default is continous.

-t DELTA , --interval = DELTA
Set the interval between two samples. Default is one second.

-V Print version number then exit.

EXAMPLES

       pcp mpstat -t 2 -s 5
              Display  four  reports  of  global  statistics  among  all processors at two second
              intervals.

       pcp mpstat -P ALL -t 2 -s 5
              Display four reports of statistics for all processors at two second intervals.

NOTES

       pcp-mpstat is inspired by the mpstat(1) command and aims to be  command  line  and  output
       compatible with it.

ENVIRONMENT

       TZ  and  LC_TIME  environment  variables  can be used to override the default date display
       format for pcp-mpstat.