1PCP-MPSTAT(1)               General Commands Manual              PCP-MPSTAT(1)
2
3
4

NAME

6       pcp-mpstat - Report CPU and Interrupt related statistics.
7

SYNOPSIS

9       pcp  mpstat [ -A ] [ -u ] [ -V ] [ -I { SUM | CPU | SCPU | ALL } ] [ -P
10       { cpu1,cpu2 [,...] | ON | ALL } ] [ -t interval ] [ -s count ] [ -a ar‐
11       chive ]
12

DESCRIPTION

14       The  pcp  mpstat  command writes to standard output activities for each
15       available processor, processor 0 being the  first  one.  If  no  activ‐
16       ity/option  has  been selected, then the default report is the CPU uti‐
17       lization [ -u ] report.
18
19       The interval parameter specifies the amount of time in seconds  between
20       each  report.  Default  is  one  second.   The value of count parameter
21       determines the number of samples to be displayed.   Default  is  conti‐
22       nous.
23

OPTIONS

25       -A     This option is equivalent to specifying -u -I ALL -P ALL
26
27       -I { SUM | CPU | SCPU | ALL }
28              Report interrupts statistics.
29              With  the  SUM keyword, the pcp mpstat command reports the total
30              number of interrupts per processor.  The  following  values  are
31              displayed:
32
33       CPU
34                     Processor  number. The keyword all indicates that statis‐
35                     tics are calculated as averages among all processors.
36
37              intr/s
38                     Show the total number of interrupts received  per  second
39                     by the CPU or CPUs.
40
41              With  the  CPU  keyword, the number of each individual interrupt
42              received per second by the CPU or CPUs is displayed.  Interrupts
43              are those under the kernel.percpu.interrupts metric tree.
44
45              With  the  SCPU  keyword, the number of each individual software
46              interrupt received per second by the CPU or CPUs  is  displayed.
47              Software interrupts are those under
48                the kernel.percpu.softirqs tree
49
50              The  ALL  keyword  is  equivalent to specifying all the keywords
51              above and therefore all the interrupts statistics are displayed.
52
53       -P { cpu1,cpu2[,...] | ON | ALL }
54              Indicate the processor number for which  statistics  are  to  be
55              reported.   cpu1  and  cpu2 are the processor numbers. A list of
56              required processor numbers can be provided. Note that  processor
57              0 is the first processor.
58
59              The  ON keyword indicates that statistics are to be reported for
60              every online processor, whereas the ALL keyword  indicates  that
61              statistics are to be reported for all processors.
62
63       -u     Report CPU utilization. The following values are displayed:
64
65              CPU
66                     Processor  number. The keyword ALL indicates that statis‐
67                     tics are calculated as averages among all processors.
68
69              %usr
70                     Show the percentage  of  CPU  utilization  that  occurred
71                     while executing at the user level (application).
72
73              %nice
74                     Show  the  percentage  of  CPU  utilization that occurred
75                     while executing at the user level with nice priority.
76
77              %sys
78                     Show the percentage  of  CPU  utilization  that  occurred
79                     while  executing  at the system level (kernel). Note that
80                     this does not include time spent servicing  hardware  and
81                     software interrupts.
82
83              %iowait
84                     Show  the  percentage  of  time that the CPU or CPUs were
85                     idle during which the system had an outstanding disk  I/O
86                     request.
87
88              %irq
89                     Show  the  percentage of time spent by the CPU or CPUs to
90                     service hardware interrupts.
91
92              %soft
93                     Show the percentage of time spent by the CPU or  CPUs  to
94                     service software interrupts.
95
96              %steal
97                     Show  the percentage of time spent in involuntary wait by
98                     the virtual CPU or CPUs while the hypervisor was  servic‐
99                     ing another virtual processor.
100
101              %guest
102                     Show  the  percentage of time spent by the CPU or CPUs to
103                     run a virtual processor.
104
105              %gnice
106                     Show the percentage of time spent by the CPU or  CPUs  to
107                     run a niced guest.
108
109              %idle
110                     Show  the  percentage  of  time that the CPU or CPUs were
111                     idle and the system did not have an outstanding disk  I/O
112                     request.
113
114              Note:  On SMP machines a processor that does not have any activ‐
115              ity at all is a disabled (offline) processor.
116
117
118       -a  FILE , --archive = FILE
119              Causes pcp-mpstat to use the specified archive  than  connecting
120              to  PMCD. The argument to -a is a comma-separated list of names,
121              each of which may be the base name of an archive or the name  of
122              a  directory  containing  one  or more archives. Archives can be
123              created using pmlogger(1).
124
125
126       -s  N , --samples = N
127              Set the number of samples to be displayed. Since the first  sam‐
128              ple  is used for the rate conversion of some of the metrics, the
129              total number of samples reported are one less that N. Default is
130              continous.
131
132
133       -t DELTA , --interval = DELTA
134              Set the interval between two samples. Default is one second.
135
136
137       -V     Print version number then exit.
138
139

EXAMPLES

141       pcp mpstat -t 2 -s 5
142              Display  four  reports of global statistics among all processors
143              at two second intervals.
144
145       pcp mpstat -P ALL -t 2 -s 5
146              Display four reports of statistics for  all  processors  at  two
147              second intervals.
148

NOTES

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

ENVIRONMENT

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

SEE ALSO

158       pcp(1),  mpstat(1),  PCPIntro(1),  pmParseInterval(3) pmTraversePMNS(3)
159       and environ(7).
160
161
162
163Performance Co-Pilot                  PCP                        PCP-MPSTAT(1)
Impressum