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
|
#!@@BASH@@
# -*- sh -*-
: << =cut
=head1 NAME
if_ - Wildcard-plugin to monitor traffic and errors on network
interfaces.
=head1 CONFIGURATION
This plugin does not normally require configuration.
The plugin may need to run as root to determine the maximum speed of
the network interface. This is configured like this:
[if_*]
user root
If the interface speed cannot be determined automatically by this
plugin, you may manually configure the speed using the "speed"
environment variable, in megabits per second, like this:
[if_*]
env.speed 1000
To set warning and critical levels do like this:
[if_*]
env.warning 10000000
or
[if_*]
env.if_0_warning 10000000
This is a wildcard plugin. To monitor an interface, link
if_<interface> to this file. For example,
ln -s /usr/share/munin/plugins/if_ \
/etc/munin/plugins/if_eth0
will monitor eth0.
Most devices found in /proc/net/dev can be monitored. Examples include
ipsec*, eth*, irda*, and lo. Please note that aliases cannot be
monitored with this plugin.
=head1 AUTHOR
Original author unknown
Copyright (C) 2011 Diego Elio Pettenò <flameeyes@flameeyes.eu>
=head1 LICENSE
GPLv2
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf suggest
=cut
. $MUNIN_LIBDIR/plugins/plugin.sh
INTERFACE=${0##*if_}
# Who whould have thought it's so much work to determine the
# maximum speed of a network interface. Buckle up!
findspeed_mbps() {
# Do not use interface name to guess technology. Many many
# wifi drivers use "eth*" names.
IWLIST=$(type -p iwlist)
if [[ -x "$IWLIST" ]]; then
SPEED=$($IWLIST $INTERFACE rate 2>&1 |
awk 'BEGIN { RATE="U" }
{ if ($2 == "Mb/s") RATE=$1; }
END { print RATE; }')
if [[ "$SPEED" != "U" ]]; then
echo $SPEED
return
fi
fi
# sysfs can report the speed if the driver supports it (but it
# doesn't work as well for wireless cards, thus why we check for
# iwlist first)
if [[ -r /sys/class/net/$INTERFACE/speed ]]; then
SPEED=$(cat /sys/class/net/$INTERFACE/speed 2>/dev/null)
if [[ -n "$SPEED" ]]; then
echo $SPEED
return
fi
fi
ETHTOOL=$(type -p ethtool)
if [[ -x "$ETHTOOL" ]]; then
SPEED=$($ETHTOOL $INTERFACE 2>&1 |
awk '/Speed:/ { gsub(/[^0-9]*/,"",$2); print $2; }')
if [[ $SPEED == [0-9]* ]]; then
echo $SPEED
return
fi
fi
MIITOOL=$(type -p mii-tool)
if [[ -x $MIITOOL ]]; then
case $($MIITOOL $INTERFACE 2>&1) in
*1000base*) echo 1000; return ;;
*100base*) echo 100; return ;;
*10base*) echo 10; return ;;
esac
fi
echo U
}
findspeed() {
if [[ "$speed" ]]; then
SPEED=$speed
else
SPEED=$(findspeed_mbps)
fi
if [[ -z "$SPEED" ]] || [[ "$SPEED" == "U" ]]; then
printf "up.info Traffic of the %s interface. Unable to determine interface speed." $INTERFACE
if [[ $EUID -ne 0 ]]; then
echo " Please run the plugin as root."
else
echo " Please install ethtool, wireless-tools, mii-tool or whatever is appropriate for the interface."
fi
return
fi
BPS=$(( $SPEED * 1000 * 1000 ))
cat <<EOF
up.max $BPS
up.info Traffic of the $INTERFACE interface. Maximum speed is $SPEED Mb/s.
down.max $BPS
EOF
return
}
case $1 in
autoconf)
if [[ -r /proc/net/dev ]]; then
echo yes
exit 0
else
echo "no (/proc/net/dev not found)"
exit 0
fi
;;
suggest)
if [[ -r /proc/net/dev ]]; then
sed -rne '/^[[:space:]]*(lo|sit[[:digit:]]+):/d;s,^[[:space:]]*([^:]+):.*,\1,p' /proc/net/dev
fi
exit 0
;;
config)
echo "graph_order down up"
echo "graph_title $INTERFACE traffic"
echo 'graph_args --base 1000'
echo 'graph_vlabel bits in (-) / out (+) per ${graph_period}'
echo 'graph_category network'
echo "graph_info This graph shows the traffic of the $INTERFACE network interface. Please note that the traffic is shown in bits per second, not bytes. IMPORTANT: On 32-bit systems the data source for this plugin uses 32-bit counters, which makes the plugin unreliable and unsuitable for most 100-Mb/s (or faster) interfaces, where traffic is expected to exceed 50 Mb/s over a 5 minute period. This means that this plugin is unsuitable for most 32-bit production environments. To avoid this problem, use the ip_ plugin instead. There should be no problems on 64-bit systems running 64-bit kernels."
echo 'down.label received'
echo 'down.type DERIVE'
echo 'down.graph no'
echo 'down.cdef down,8,*'
echo 'down.min 0'
echo 'up.label bps'
echo 'up.type DERIVE'
echo 'up.negative down'
echo 'up.cdef up,8,*'
echo 'up.min 0'
print_warning down
print_warning up
print_critical down
print_critical up
findspeed
exit 0
;;
esac
# Escape dots in the interface name (eg. vlans) before using it as a regex
if [[ -r /sys/class/net/$INTERFACE/statistics/rx_bytes ]]; then
echo "down.value $(cat /sys/class/net/$INTERFACE/statistics/rx_bytes)"
echo "up.value $(cat /sys/class/net/$INTERFACE/statistics/tx_bytes)"
else
awk -v interface="$INTERFACE" \
'BEGIN { gsub(/\./, "\\.", interface) } \
$1 ~ "^" interface ":" {
split($0, a, /: */); $0 = a[2]; \
print "down.value " $1 "\nup.value " $9 \
}' \
/proc/net/dev
fi
|
