Provided by: pcp_6.0.5-1_amd64 bug

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

SEE ALSO

       PCPIntro(1), pcp(1), mpstat(1), pmParseInterval(3), pmTraversePMNS(3) and environ(7).