PCP-MPSTAT(1) | General Commands Manual | PCP-MPSTAT(1) |
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 continuous.
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
intr/s
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
%usr
%nice
%sys
%iowait
%irq
%soft
%steal
%guest
%gnice
%idle
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 continuous.
- -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
pcp mpstat -P ALL -t 2 -s 5
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).
SEE ALSO
PCPIntro(1), pcp(1), mpstat(1), pmParseInterval(3), pmTraversePMNS(3) and environ(7).
PCP | Performance Co-Pilot |