|
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | NOTES | ENVIRONMENT | SEE ALSO | COLOPHON |
PCP-MPSTAT(1) General Commands Manual PCP-MPSTAT(1)
pcp-mpstat - Report CPU and Interrupt related statistics.
pcp mpstat [ -A ] [ -u ] [ -V ] [ -I { SUM | CPU | SCPU | ALL } ] [
-P { cpu1,cpu2 [,...] | ON | ALL } ] [ -t interval ] [ -s count ] [
-a pcp-archive ]
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.
-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.
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.
pcp-mpstat is inspired by the mpstat(1) command and aims to be
command line and output compatible with it.
TZ and LC_TIME environment variables can be used to override the
default date display format for pcp-mpstat.
pcp(1), mpstat(1), PCPIntro(1), pmParseInterval(3) pmTraversePMNS(3)
and environ(7).
This page is part of the PCP (Performance Co-Pilot) project.
Information about the project can be found at ⟨http://www.pcp.io/⟩.
If you have a bug report for this manual page, send it to
pcp@oss.sgi.com. This page was obtained from the project's upstream
Git repository ⟨git://git.pcp.io/pcp⟩ on 2017-07-05. If you discover
any rendering problems in this HTML version of the page, or you
believe there is a better or more up-to-date source for the page, or
you have corrections or improvements to the information in this
COLOPHON (which is not part of the original manual page), send a mail
to man-pages@man7.org
Performance Co-Pilot PCP PCP-MPSTAT(1)