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

NAME

       pcp-mpstat - Report CPU and interrupt related statistics.

SYNOPSIS

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

DESCRIPTION

       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.  The default is one
       second.  The value of count parameter determines the number of samples to be displayed.  The  default  is
       continous.

OPTIONS

When invoked via the pcp(1) command, the -h/--host, -a/--archive, -O/--origin, -s/--samples,
-t/--interval, -Z/--timezone and several other pcp options become indirectly available; refer to
PCPIntro(1) for a complete description of these options.

The additional command line options available for pcp-mpstat are:

-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.

-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. The default is one second.

-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.

-V , --version
Print version number then exit.

-? , --help
Print usage message 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.

PCP ENVIRONMENT

       Environment variables with the prefix PCP_ are used to parameterize the file and directory names used  by
       PCP.   On  each  installation, the file /etc/pcp.conf contains the local values for these variables.  The
       $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5).

       For environment variables affecting PCP tools, see pmGetOptions(3).