1PCP-MPSTAT(1) General Commands Manual PCP-MPSTAT(1)
2
3
4
6 pcp-mpstat - Report CPU and Interrupt related statistics.
7
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
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
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
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
150 pcp-mpstat is inspired by the mpstat(1) command and aims to be command
151 line and output compatible with it.
152
154 TZ and LC_TIME environment variables can be used to override the
155 default date display format for pcp-mpstat.
156
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)