1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
|
#!/bin/sh
#
: <<=cut
=head1 NAME
cpu - Plugin to monitor CPU usage.
=head1 APPLICABLE SYSTEMS
All Linux systems
=head1 CONFIGURATION
The following is default configuration
[cpu]
env.HZ 100
See "BUGS" for a explanation of this setting.
=head2 EXAMPLE WARNING AND CRITICAL SETTINGS
You can also set warning and critical levels for each of the data
series the plugin reports. The following environment variables are
used as default for all fields:
env.warning
env.critical
But each field can be controlled separately:
env.system_warning
env.system_critical
env.user_warning
env.user_critical
env.nice_warning
env.nice_critical
env.idle_warning
env.idle_critical
For some kernels there is also the following settings:
env.iowait_warning
env.iowait_critical
env.irq_warning
env.irq_critical
env.softirq_warning
env.softirq_critical
env.steal_warning
env.steal_critical
env.guest_warning
env.guest_critical
=head1 INTERPRETATION
The plugin shows cpu usage in percent. In case of more than one core
it displays 100% for each core.
If a core is 100% busy there will be no "iowait" showing, that only
shows if the CPU has nothing else to do while it waits on IO.
Therefore a 100% busy core can hide a lot of iowait. Please refer to
the IO latency and other disk related graphs for further information
about IO performance.
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf
=head1 VERSION
$Id$
=head1 BUGS
Some combinations of hardware and Linux (probably only 2.4 kernels)
use 1000 units/second in /proc/stat corresponding to the systems
HZ. (see /usr/src/linux/include/asm/param.h). But Almost all systems
use 100 units/second and this is our default. Even if
Documentation/proc.txt in the kernel source says otherwise. - Finding
and fix by dz@426.ch
Otherwise none known
=head1 AUTHOR
Unknown
=head1 LICENSE
GPLv2
=cut
. $MUNIN_LIBDIR/plugins/plugin.sh
if [ "$1" = "autoconf" ]; then
if [ -r /proc/stat ]; then
echo yes
exit 0
else
echo no
exit 0
fi
fi
HZ=${HZ:-100}
extinfo=""
if egrep -q '^cpu +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+' /proc/stat; then
extinfo="iowait irq softirq"
if egrep -q '^cpu +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+' /proc/stat; then
extextinfo="steal"
fi
if egrep -q '^cpu +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+ +[0-9]+' /proc/stat; then
extextextinfo="guest"
fi
fi
if [ "$1" = "config" ]; then
NCPU=$(egrep '^cpu[0-9]+ ' /proc/stat | wc -l)
if [ "$scaleto100" = "yes" ]; then
graphlimit=100
else
graphlimit=$(($NCPU * 100))
fi
echo 'graph_title CPU usage'
echo "graph_order system user nice idle" $extinfo
echo "graph_args --base 1000 -r --lower-limit 0 --upper-limit $graphlimit"
echo 'graph_vlabel %'
echo 'graph_scale no'
echo 'graph_info This graph shows how CPU time is spent.'
echo 'graph_category system'
echo 'graph_period second'
echo 'system.label system'
echo 'system.draw AREA'
echo 'system.min 0'
echo 'system.type DERIVE'
echo "system.info CPU time spent by the kernel in system activities"
echo 'user.label user'
echo 'user.draw STACK'
echo 'user.min 0'
echo 'user.type DERIVE'
echo 'user.info CPU time spent by normal programs and daemons'
echo 'nice.label nice'
echo 'nice.draw STACK'
echo 'nice.min 0'
echo 'nice.type DERIVE'
echo 'nice.info CPU time spent by nice(1)d programs'
echo 'idle.label idle'
echo 'idle.draw STACK'
echo 'idle.min 0'
echo 'idle.type DERIVE'
echo 'idle.info Idle CPU time'
for field in system user nice idle; do
print_adjusted_thresholds "$field" "$graphlimit"
done
if [ "$scaleto100" = "yes" ]; then
echo "system.cdef system,$NCPU,/"
echo "user.cdef user,$NCPU,/"
echo "nice.cdef nice,$NCPU,/"
echo "idle.cdef idle,$NCPU,/"
fi
if [ ! -z "$extinfo" ]
then
echo 'iowait.label iowait'
echo 'iowait.draw STACK'
echo 'iowait.min 0'
echo 'iowait.type DERIVE'
echo 'iowait.info CPU time spent waiting for I/O operations to finish when there is nothing else to do.'
echo 'irq.label irq'
echo 'irq.draw STACK'
echo 'irq.min 0'
echo 'irq.type DERIVE'
echo 'irq.info CPU time spent handling interrupts'
echo 'softirq.label softirq'
echo 'softirq.draw STACK'
echo 'softirq.min 0'
echo 'softirq.type DERIVE'
echo 'softirq.info CPU time spent handling "batched" interrupts'
if [ "$scaleto100" = "yes" ]; then
echo "iowait.cdef iowait,$NCPU,/"
echo "irq.cdef irq,$NCPU,/"
echo "softirq.cdef softirq,$NCPU,/"
fi
for field in iowait irq softirq; do
print_adjusted_thresholds "$field" "$graphlimit"
done
fi
if [ ! -z "$extextinfo" ]
then
echo 'steal.label steal'
echo 'steal.draw STACK'
echo 'steal.min 0'
echo 'steal.type DERIVE'
echo 'steal.info The time that a virtual CPU had runnable tasks, but the virtual CPU itself was not running'
if [ "$scaleto100" = "yes" ]; then
echo "steal.cdef steal,$NCPU,/"
fi
for field in steal; do
print_adjusted_thresholds "$field" "$graphlimit"
done
fi
if [ ! -z "$extextextinfo" ]
then
echo 'guest.label guest'
echo 'guest.draw STACK'
echo 'guest.min 0'
echo 'guest.type DERIVE'
echo 'guest.info The time spent running a virtual CPU for guest operating systems under the control of the Linux kernel.'
if [ "$scaleto100" = "yes" ]; then
echo "guest.cdef guest,$NCPU,/"
fi
for field in guest; do
print_adjusted_thresholds "$field" "$graphlimit"
done
fi
exit 0
fi
# Note: Counters/derive need to report integer values. Also we need
# to avoid 10e+09 and the like %.0f should do this.
if [ ! -z "$extextextinfo" ]; then
awk -v hz=$HZ '/^cpu / { epoch = systime(); printf "user.value %d:%.0f\nnice.value %d:%.0f\nsystem.value %d:%.0f\nidle.value %d:%.0f\niowait.value %d:%.0f\nirq.value %d:%.0f\nsoftirq.value %d:%.0f\nsteal.value %d:%.0f\nguest.value %d:%.0f\n", epoch, $2*100/hz, epoch, $3*100/hz, epoch, $4*100/hz, epoch, $5*100/hz, epoch, $6*100/hz, epoch, $7*100/hz, epoch, $8*100/hz, epoch, $9*100/hz, epoch, $10*100/hz }' < /proc/stat
elif [ ! -z "$extextinfo" ]; then
awk -v hz=$HZ '/^cpu / { epoch = systime(); printf "user.value %d:%.0f\nnice.value %d:%.0f\nsystem.value %d:%.0f\nidle.value %d:%.0f\niowait.value %d:%.0f\nirq.value %d:%.0f\nsoftirq.value %d:%.0f\nsteal.value %d:%.0f\n", epoch, $2*100/hz, epoch, $3*100/hz, epoch, $4*100/hz, epoch, $5*100/hz, epoch, $6*100/hz, epoch, $7*100/hz, epoch, $8*100/hz, epoch, $9*100/hz }' < /proc/stat
elif [ ! -z "$extinfo" ]; then
awk -v hz=$HZ '/^cpu / { epoch = systime(); printf "user.value %d:%.0f\nnice.value %d:%.0f\nsystem.value %d:%.0f\nidle.value %d:%.0f\niowait.value %d:%.0f\nirq.value %d:%.0f\nsoftirq.value %d:%.0f\n", epoch, $2*100/hz, epoch, $3*100/hz, epoch, $4*100/hz, epoch, $5*100/hz, epoch, $6*100/hz, epoch, $7*100/hz, epoch, $8*100/hz }' < /proc/stat
else
awk -v hz=$HZ '/^cpu / { epoch = systime(); printf "user.value %d:%.0f\nnice.value %d:%.0f\nsystem.value %d:%.0f\nidle.value %d:%.0f\niowait.value %d:%.0f\nirq.value %d:%.0f\n", epoch, $2*100/hz, epoch, $3*100/hz, epoch, $4*100/hz, epoch, $5*100/hz, epoch, $6*100/hz, epoch, $7*100/hz }' < /proc/stat
fi
|