def __init__(self, argv=(), env={}):
"""Populate Munin Plugin with MuninGraph instances.
@param argv: List of command line arguments.
@param env: Dictionary of environment variables.
"""
MuninPlugin.__init__(self, argv, env)
self.envRegisterFilter("ifaces", "^[\w\d]+$")
self._wanpipeInfo = WanpipeInfo()
self._ifaceStats = self._wanpipeInfo.getIfaceStats()
self._ifaceList = []
for iface in list(self._ifaceStats):
if self.ifaceIncluded(iface):
self._ifaceList.append(iface)
self._ifaceList.sort()
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
if self.graphEnabled("wanpipe_traffic"):
graph = MuninGraph(
"Wanpipe - Traffic - %s" % iface,
"Asterisk",
info="Traffic Stats for Wanpipe Interface %s " "in packets/sec." % iface,
args="--base 1000 --lower-limit 0",
vlabel="packets in (-) / out (+) per second",
)
graph.addField("rxpackets", "packets", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField("txpackets", "packets", draw="LINE2", type="DERIVE", min=0, negative="rxpackets")
self.appendGraph("wanpipe_traffic_%s" % iface, graph)
if self.graphEnabled("wanpipe_errors"):
graph = MuninGraph(
"Wanpipe - Errors - %s" % iface,
"Asterisk",
info="Error Stats for Wanpipe Interface %s" " in errors/sec." % iface,
args="--base 1000 --lower-limit 0",
vlabel="errors in (-) / out (+) per second",
)
graph.addField("rxerrs", "errors", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField(
"txerrs",
"errors",
draw="LINE2",
type="DERIVE",
min=0,
negative="txerrs",
info="Rx(-)/Tx(+) Errors per second.",
)
graph.addField("rxframe", "frm/crr", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField(
"txcarrier",
"frm/crr",
draw="LINE2",
type="DERIVE",
min=0,
negative="rxframe",
info="Frame(-)/Carrier(+) Errors per second.",
)
graph.addField("rxdrop", "drop", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField(
"txdrop",
"drop",
draw="LINE2",
type="DERIVE",
min=0,
negative="rxdrop",
info="Rx(-)/Tx(+) Dropped Packets per second.",
)
graph.addField("rxfifo", "fifo", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField(
"txfifo",
"fifo",
draw="LINE2",
type="DERIVE",
min=0,
negative="rxfifo",
info="Rx(-)/Tx(+) FIFO Errors per second.",
)
self.appendGraph("wanpipe_errors_%s" % iface, graph)
if self.graphEnabled("wanpipe_pri_errors"):
graph = MuninGraph(
"Wanpipe - ISDN PRI Stats - %s" % iface,
"Asterisk",
info="ISDN PRI Error Stats for Wanpipe Interface %s" " in errors/sec." % iface,
args="--base 1000 --lower-limit 0",
vlabel="errors in (-) / out (+) per second",
)
graph.addField(
"linecodeviolation",
"Line Code Violation",
draw="LINE2",
type="DERIVE",
min=0,
info="Line Code Violation errors per second.",
)
graph.addField(
"farendblockerrors",
"Far End Block Errors",
draw="LINE2",
type="DERIVE",
min=0,
info="Far End Block errors per second.",
)
graph.addField(
"crc4errors", "CRC4 Errors", draw="LINE2", type="DERIVE", min=0, info="CRC4 errors per second."
)
graph.addField(
"faserrors", "FAS Errors", draw="LINE2", type="DERIVE", min=0, info="FAS errors per second."
)
self.appendGraph("wanpipe_pri_errors_%s" % iface, graph)
if self.graphEnabled("wanpipe_pri_rxlevel"):
graph = MuninGraph(
"Wanpipe - ISDN PRI Signal Level",
"Asterisk",
info="ISDN PRI received signal level in DB.",
args="--base 1000 --lower-limit 0",
vlabel="db",
)
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
graph.addField(iface, iface, draw="LINE2")
self.appendGraph("wanpipe_pri_rxlevel", graph)
class MuninWanpipePlugin(MuninPlugin):
"""Multigraph Munin Plugin for monitoring Wanpipe Interfaces.
"""
plugin_name = "wanpipestats"
isMultigraph = True
def __init__(self, argv=(), env={}):
"""Populate Munin Plugin with MuninGraph instances.
@param argv: List of command line arguments.
@param env: Dictionary of environment variables.
"""
MuninPlugin.__init__(self, argv, env)
self.envRegisterFilter("ifaces", "^[\w\d]+$")
self._wanpipeInfo = WanpipeInfo()
self._ifaceStats = self._wanpipeInfo.getIfaceStats()
self._ifaceList = []
for iface in list(self._ifaceStats):
if self.ifaceIncluded(iface):
self._ifaceList.append(iface)
self._ifaceList.sort()
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
if self.graphEnabled("wanpipe_traffic"):
graph = MuninGraph(
"Wanpipe - Traffic - %s" % iface,
"Asterisk",
info="Traffic Stats for Wanpipe Interface %s " "in packets/sec." % iface,
args="--base 1000 --lower-limit 0",
vlabel="packets in (-) / out (+) per second",
)
graph.addField("rxpackets", "packets", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField("txpackets", "packets", draw="LINE2", type="DERIVE", min=0, negative="rxpackets")
self.appendGraph("wanpipe_traffic_%s" % iface, graph)
if self.graphEnabled("wanpipe_errors"):
graph = MuninGraph(
"Wanpipe - Errors - %s" % iface,
"Asterisk",
info="Error Stats for Wanpipe Interface %s" " in errors/sec." % iface,
args="--base 1000 --lower-limit 0",
vlabel="errors in (-) / out (+) per second",
)
graph.addField("rxerrs", "errors", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField(
"txerrs",
"errors",
draw="LINE2",
type="DERIVE",
min=0,
negative="txerrs",
info="Rx(-)/Tx(+) Errors per second.",
)
graph.addField("rxframe", "frm/crr", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField(
"txcarrier",
"frm/crr",
draw="LINE2",
type="DERIVE",
min=0,
negative="rxframe",
info="Frame(-)/Carrier(+) Errors per second.",
)
graph.addField("rxdrop", "drop", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField(
"txdrop",
"drop",
draw="LINE2",
type="DERIVE",
min=0,
negative="rxdrop",
info="Rx(-)/Tx(+) Dropped Packets per second.",
)
graph.addField("rxfifo", "fifo", draw="LINE2", type="DERIVE", min=0, graph=False)
graph.addField(
"txfifo",
"fifo",
draw="LINE2",
type="DERIVE",
min=0,
negative="rxfifo",
info="Rx(-)/Tx(+) FIFO Errors per second.",
)
self.appendGraph("wanpipe_errors_%s" % iface, graph)
if self.graphEnabled("wanpipe_pri_errors"):
graph = MuninGraph(
"Wanpipe - ISDN PRI Stats - %s" % iface,
"Asterisk",
info="ISDN PRI Error Stats for Wanpipe Interface %s" " in errors/sec." % iface,
args="--base 1000 --lower-limit 0",
vlabel="errors in (-) / out (+) per second",
)
graph.addField(
"linecodeviolation",
"Line Code Violation",
draw="LINE2",
type="DERIVE",
min=0,
info="Line Code Violation errors per second.",
)
graph.addField(
"farendblockerrors",
"Far End Block Errors",
draw="LINE2",
type="DERIVE",
min=0,
info="Far End Block errors per second.",
)
graph.addField(
"crc4errors", "CRC4 Errors", draw="LINE2", type="DERIVE", min=0, info="CRC4 errors per second."
)
graph.addField(
"faserrors", "FAS Errors", draw="LINE2", type="DERIVE", min=0, info="FAS errors per second."
)
self.appendGraph("wanpipe_pri_errors_%s" % iface, graph)
if self.graphEnabled("wanpipe_pri_rxlevel"):
graph = MuninGraph(
"Wanpipe - ISDN PRI Signal Level",
"Asterisk",
info="ISDN PRI received signal level in DB.",
args="--base 1000 --lower-limit 0",
vlabel="db",
)
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
graph.addField(iface, iface, draw="LINE2")
self.appendGraph("wanpipe_pri_rxlevel", graph)
def retrieveVals(self):
"""Retrive values for graphs."""
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
if self.graphEnabled("wanpipe_traffic") or self.graphEnabled("wanpipe_errors"):
stats = self._ifaceStats.get(iface)
if stats:
graph_name = "wanpipe_traffic_%s" % iface
if self.hasGraph(graph_name):
for field in ("rxpackets", "txpackets"):
self.setGraphVal(graph_name, field, stats.get(field))
graph_name = "wanpipe_errors_%s" % iface
if self.hasGraph(graph_name):
for field in (
"rxerrs",
"txerrs",
"rxframe",
"txcarrier",
"rxdrop",
"txdrop",
"rxfifo",
"txfifo",
):
self.setGraphVal(graph_name, field, stats.get(field))
if self.graphEnabled("wanpipe_pri_errors") or self.graphEnabled("wanpipe_rxlevel"):
try:
stats = self._wanpipeInfo.getPRIstats(iface)
except:
stats = None
if stats:
graph_name = "wanpipe_pri_errors_%s" % iface
if self.hasGraph(graph_name):
for field in ("linecodeviolation", "farendblockerrors", "crc4errors", "faserrors"):
self.setGraphVal(graph_name, field, stats.get(field))
if self.hasGraph("wanpipe_rxlevel"):
self.setGraphVal("wanpipe_pri_rxlevel", iface, stats.get("rxlevel"))
def ifaceIncluded(self, iface):
"""Utility method to check if interface is included in monitoring.
@param iface: Interface name.
@return: Returns True if included in graphs, False otherwise.
"""
return self.envCheckFilter("ifaces", iface)
def __init__(self, argv=(), env={}, debug=False):
"""Populate Munin Plugin with MuninGraph instances.
@param argv: List of command line arguments.
@param env: Dictionary of environment variables.
@param debug: Print debugging messages if True. (Default: False)
"""
MuninPlugin.__init__(self, argv, env, debug)
self.envRegisterFilter('ifaces', '^[\w\d]+$')
self._wanpipeInfo = WanpipeInfo()
self._ifaceStats = self._wanpipeInfo.getIfaceStats()
self._ifaceList = []
for iface in list(self._ifaceStats):
if self.ifaceIncluded(iface):
self._ifaceList.append(iface)
self._ifaceList.sort()
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
if self.graphEnabled('wanpipe_traffic'):
graph = MuninGraph('Wanpipe - Traffic - %s' % iface,
'Asterisk',
info='Traffic Stats for Wanpipe Interface %s '
'in packets/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='packets in (-) / out (+) per second')
graph.addField('rxpackets', 'packets', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txpackets', 'packets', draw='LINE2',
type='DERIVE', min=0,
negative='rxpackets')
self.appendGraph('wanpipe_traffic_%s' % iface, graph)
if self.graphEnabled('wanpipe_errors'):
graph = MuninGraph('Wanpipe - Errors - %s' % iface, 'Asterisk',
info='Error Stats for Wanpipe Interface %s'
' in errors/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='errors in (-) / out (+) per second')
graph.addField('rxerrs', 'errors', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txerrs', 'errors', draw='LINE2',
type='DERIVE', min=0, negative='txerrs',
info='Rx(-)/Tx(+) Errors per second.')
graph.addField('rxframe', 'frm/crr', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txcarrier', 'frm/crr', draw='LINE2',
type='DERIVE', min=0, negative='rxframe',
info='Frame(-)/Carrier(+) Errors per second.')
graph.addField('rxdrop', 'drop', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txdrop', 'drop', draw='LINE2',
type='DERIVE', min=0, negative='rxdrop',
info='Rx(-)/Tx(+) Dropped Packets per second.')
graph.addField('rxfifo', 'fifo', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txfifo', 'fifo', draw='LINE2',
type='DERIVE', min=0, negative='rxfifo',
info='Rx(-)/Tx(+) FIFO Errors per second.')
self.appendGraph('wanpipe_errors_%s' % iface, graph)
if self.graphEnabled('wanpipe_pri_errors'):
graph = MuninGraph('Wanpipe - ISDN PRI Stats - %s' % iface,
'Asterisk',
info='ISDN PRI Error Stats for Wanpipe Interface %s'
' in errors/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='errors in (-) / out (+) per second')
graph.addField('linecodeviolation', 'Line Code Violation',
draw='LINE2', type='DERIVE', min=0,
info='Line Code Violation errors per second.')
graph.addField('farendblockerrors', 'Far End Block Errors',
draw='LINE2', type='DERIVE', min=0,
info='Far End Block errors per second.')
graph.addField('crc4errors', 'CRC4 Errors', draw='LINE2',
type='DERIVE', min=0, info='CRC4 errors per second.')
graph.addField('faserrors', 'FAS Errors', draw='LINE2',
type='DERIVE', min=0, info='FAS errors per second.')
self.appendGraph('wanpipe_pri_errors_%s' % iface, graph)
if self.graphEnabled('wanpipe_pri_rxlevel'):
graph = MuninGraph('Wanpipe - ISDN PRI Signal Level', 'Asterisk',
info='ISDN PRI received signal level in DB.',
args='--base 1000 --lower-limit 0',
vlabel='db')
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
graph.addField(iface, iface, draw='LINE2')
self.appendGraph('wanpipe_pri_rxlevel', graph)
class MuninWanpipePlugin(MuninPlugin):
"""Multigraph Munin Plugin for monitoring Wanpipe Interfaces.
"""
plugin_name = 'wanpipestats'
isMultigraph = True
def __init__(self, argv=(), env={}, debug=False):
"""Populate Munin Plugin with MuninGraph instances.
@param argv: List of command line arguments.
@param env: Dictionary of environment variables.
@param debug: Print debugging messages if True. (Default: False)
"""
MuninPlugin.__init__(self, argv, env, debug)
self.envRegisterFilter('ifaces', '^[\w\d]+$')
self._wanpipeInfo = WanpipeInfo()
self._ifaceStats = self._wanpipeInfo.getIfaceStats()
self._ifaceList = []
for iface in list(self._ifaceStats):
if self.ifaceIncluded(iface):
self._ifaceList.append(iface)
self._ifaceList.sort()
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
if self.graphEnabled('wanpipe_traffic'):
graph = MuninGraph('Wanpipe - Traffic - %s' % iface,
'Asterisk',
info='Traffic Stats for Wanpipe Interface %s '
'in packets/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='packets in (-) / out (+) per second')
graph.addField('rxpackets', 'packets', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txpackets', 'packets', draw='LINE2',
type='DERIVE', min=0,
negative='rxpackets')
self.appendGraph('wanpipe_traffic_%s' % iface, graph)
if self.graphEnabled('wanpipe_errors'):
graph = MuninGraph('Wanpipe - Errors - %s' % iface, 'Asterisk',
info='Error Stats for Wanpipe Interface %s'
' in errors/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='errors in (-) / out (+) per second')
graph.addField('rxerrs', 'errors', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txerrs', 'errors', draw='LINE2',
type='DERIVE', min=0, negative='txerrs',
info='Rx(-)/Tx(+) Errors per second.')
graph.addField('rxframe', 'frm/crr', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txcarrier', 'frm/crr', draw='LINE2',
type='DERIVE', min=0, negative='rxframe',
info='Frame(-)/Carrier(+) Errors per second.')
graph.addField('rxdrop', 'drop', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txdrop', 'drop', draw='LINE2',
type='DERIVE', min=0, negative='rxdrop',
info='Rx(-)/Tx(+) Dropped Packets per second.')
graph.addField('rxfifo', 'fifo', draw='LINE2',
type='DERIVE', min=0, graph=False)
graph.addField('txfifo', 'fifo', draw='LINE2',
type='DERIVE', min=0, negative='rxfifo',
info='Rx(-)/Tx(+) FIFO Errors per second.')
self.appendGraph('wanpipe_errors_%s' % iface, graph)
if self.graphEnabled('wanpipe_pri_errors'):
graph = MuninGraph('Wanpipe - ISDN PRI Stats - %s' % iface,
'Asterisk',
info='ISDN PRI Error Stats for Wanpipe Interface %s'
' in errors/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='errors in (-) / out (+) per second')
graph.addField('linecodeviolation', 'Line Code Violation',
draw='LINE2', type='DERIVE', min=0,
info='Line Code Violation errors per second.')
graph.addField('farendblockerrors', 'Far End Block Errors',
draw='LINE2', type='DERIVE', min=0,
info='Far End Block errors per second.')
graph.addField('crc4errors', 'CRC4 Errors', draw='LINE2',
type='DERIVE', min=0, info='CRC4 errors per second.')
graph.addField('faserrors', 'FAS Errors', draw='LINE2',
type='DERIVE', min=0, info='FAS errors per second.')
self.appendGraph('wanpipe_pri_errors_%s' % iface, graph)
if self.graphEnabled('wanpipe_pri_rxlevel'):
graph = MuninGraph('Wanpipe - ISDN PRI Signal Level', 'Asterisk',
info='ISDN PRI received signal level in DB.',
args='--base 1000 --lower-limit 0',
vlabel='db')
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
graph.addField(iface, iface, draw='LINE2')
self.appendGraph('wanpipe_pri_rxlevel', graph)
def retrieveVals(self):
"""Retrieve values for graphs."""
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
if (self.graphEnabled('wanpipe_traffic')
or self.graphEnabled('wanpipe_errors')):
stats = self._ifaceStats.get(iface)
if stats:
graph_name = 'wanpipe_traffic_%s' % iface
if self.hasGraph(graph_name):
for field in ('rxpackets', 'txpackets'):
self.setGraphVal(graph_name, field,
stats.get(field))
graph_name = 'wanpipe_errors_%s' % iface
if self.hasGraph(graph_name):
for field in ('rxerrs', 'txerrs', 'rxframe', 'txcarrier',
'rxdrop', 'txdrop', 'rxfifo', 'txfifo'):
self.setGraphVal(graph_name, field,
stats.get(field))
if (self.graphEnabled('wanpipe_pri_errors')
or self.graphEnabled('wanpipe_rxlevel')):
try:
stats = self._wanpipeInfo.getPRIstats(iface)
except:
stats = None
if stats:
graph_name = 'wanpipe_pri_errors_%s' % iface
if self.hasGraph(graph_name):
for field in ('linecodeviolation',
'farendblockerrors',
'crc4errors', 'faserrors'):
self.setGraphVal(graph_name, field,
stats.get(field))
if self.hasGraph('wanpipe_rxlevel'):
self.setGraphVal('wanpipe_pri_rxlevel',
iface, stats.get('rxlevel'))
def ifaceIncluded(self, iface):
"""Utility method to check if interface is included in monitoring.
@param iface: Interface name.
@return: Returns True if included in graphs, False otherwise.
"""
return self.envCheckFilter('ifaces', iface)
def autoconf(self):
"""Implements Munin Plugin Auto-Configuration Option.
@return: True if plugin can be auto-configured, False otherwise.
"""
return len(self._ifaceList) > 0
def __init__(self, argv=(), env={}, debug=False):
"""Populate Munin Plugin with MuninGraph instances.
@param argv: List of command line arguments.
@param env: Dictionary of environment variables.
@param debug: Print debugging messages if True. (Default: False)
"""
MuninPlugin.__init__(self, argv, env, debug)
self.envRegisterFilter('ifaces', '^[\w\d]+$')
self._wanpipeInfo = WanpipeInfo()
self._ifaceStats = self._wanpipeInfo.getIfaceStats()
self._ifaceList = []
for iface in list(self._ifaceStats):
if self.ifaceIncluded(iface):
self._ifaceList.append(iface)
self._ifaceList.sort()
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
if self.graphEnabled('wanpipe_traffic'):
graph = MuninGraph(
'Wanpipe - Traffic - %s' % iface,
'Asterisk',
info='Traffic Stats for Wanpipe Interface %s '
'in packets/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='packets in (-) / out (+) per second')
graph.addField('rxpackets',
'packets',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField('txpackets',
'packets',
draw='LINE2',
type='DERIVE',
min=0,
negative='rxpackets')
self.appendGraph('wanpipe_traffic_%s' % iface, graph)
if self.graphEnabled('wanpipe_errors'):
graph = MuninGraph(
'Wanpipe - Errors - %s' % iface,
'Asterisk',
info='Error Stats for Wanpipe Interface %s'
' in errors/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='errors in (-) / out (+) per second')
graph.addField('rxerrs',
'errors',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField('txerrs',
'errors',
draw='LINE2',
type='DERIVE',
min=0,
negative='txerrs',
info='Rx(-)/Tx(+) Errors per second.')
graph.addField('rxframe',
'frm/crr',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField(
'txcarrier',
'frm/crr',
draw='LINE2',
type='DERIVE',
min=0,
negative='rxframe',
info='Frame(-)/Carrier(+) Errors per second.')
graph.addField('rxdrop',
'drop',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField(
'txdrop',
'drop',
draw='LINE2',
type='DERIVE',
min=0,
negative='rxdrop',
info='Rx(-)/Tx(+) Dropped Packets per second.')
graph.addField('rxfifo',
'fifo',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField('txfifo',
'fifo',
draw='LINE2',
type='DERIVE',
min=0,
negative='rxfifo',
info='Rx(-)/Tx(+) FIFO Errors per second.')
self.appendGraph('wanpipe_errors_%s' % iface, graph)
if self.graphEnabled('wanpipe_pri_errors'):
graph = MuninGraph(
'Wanpipe - ISDN PRI Stats - %s' % iface,
'Asterisk',
info='ISDN PRI Error Stats for Wanpipe Interface %s'
' in errors/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='errors in (-) / out (+) per second')
graph.addField(
'linecodeviolation',
'Line Code Violation',
draw='LINE2',
type='DERIVE',
min=0,
info='Line Code Violation errors per second.')
graph.addField('farendblockerrors',
'Far End Block Errors',
draw='LINE2',
type='DERIVE',
min=0,
info='Far End Block errors per second.')
graph.addField('crc4errors',
'CRC4 Errors',
draw='LINE2',
type='DERIVE',
min=0,
info='CRC4 errors per second.')
graph.addField('faserrors',
'FAS Errors',
draw='LINE2',
type='DERIVE',
min=0,
info='FAS errors per second.')
self.appendGraph('wanpipe_pri_errors_%s' % iface, graph)
if self.graphEnabled('wanpipe_pri_rxlevel'):
graph = MuninGraph('Wanpipe - ISDN PRI Signal Level',
'Asterisk',
info='ISDN PRI received signal level in DB.',
args='--base 1000 --lower-limit 0',
vlabel='db')
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
graph.addField(iface, iface, draw='LINE2')
self.appendGraph('wanpipe_pri_rxlevel', graph)
class MuninWanpipePlugin(MuninPlugin):
"""Multigraph Munin Plugin for monitoring Wanpipe Interfaces.
"""
plugin_name = 'wanpipestats'
isMultigraph = True
def __init__(self, argv=(), env={}, debug=False):
"""Populate Munin Plugin with MuninGraph instances.
@param argv: List of command line arguments.
@param env: Dictionary of environment variables.
@param debug: Print debugging messages if True. (Default: False)
"""
MuninPlugin.__init__(self, argv, env, debug)
self.envRegisterFilter('ifaces', '^[\w\d]+$')
self._wanpipeInfo = WanpipeInfo()
self._ifaceStats = self._wanpipeInfo.getIfaceStats()
self._ifaceList = []
for iface in list(self._ifaceStats):
if self.ifaceIncluded(iface):
self._ifaceList.append(iface)
self._ifaceList.sort()
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
if self.graphEnabled('wanpipe_traffic'):
graph = MuninGraph(
'Wanpipe - Traffic - %s' % iface,
'Asterisk',
info='Traffic Stats for Wanpipe Interface %s '
'in packets/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='packets in (-) / out (+) per second')
graph.addField('rxpackets',
'packets',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField('txpackets',
'packets',
draw='LINE2',
type='DERIVE',
min=0,
negative='rxpackets')
self.appendGraph('wanpipe_traffic_%s' % iface, graph)
if self.graphEnabled('wanpipe_errors'):
graph = MuninGraph(
'Wanpipe - Errors - %s' % iface,
'Asterisk',
info='Error Stats for Wanpipe Interface %s'
' in errors/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='errors in (-) / out (+) per second')
graph.addField('rxerrs',
'errors',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField('txerrs',
'errors',
draw='LINE2',
type='DERIVE',
min=0,
negative='txerrs',
info='Rx(-)/Tx(+) Errors per second.')
graph.addField('rxframe',
'frm/crr',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField(
'txcarrier',
'frm/crr',
draw='LINE2',
type='DERIVE',
min=0,
negative='rxframe',
info='Frame(-)/Carrier(+) Errors per second.')
graph.addField('rxdrop',
'drop',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField(
'txdrop',
'drop',
draw='LINE2',
type='DERIVE',
min=0,
negative='rxdrop',
info='Rx(-)/Tx(+) Dropped Packets per second.')
graph.addField('rxfifo',
'fifo',
draw='LINE2',
type='DERIVE',
min=0,
graph=False)
graph.addField('txfifo',
'fifo',
draw='LINE2',
type='DERIVE',
min=0,
negative='rxfifo',
info='Rx(-)/Tx(+) FIFO Errors per second.')
self.appendGraph('wanpipe_errors_%s' % iface, graph)
if self.graphEnabled('wanpipe_pri_errors'):
graph = MuninGraph(
'Wanpipe - ISDN PRI Stats - %s' % iface,
'Asterisk',
info='ISDN PRI Error Stats for Wanpipe Interface %s'
' in errors/sec.' % iface,
args='--base 1000 --lower-limit 0',
vlabel='errors in (-) / out (+) per second')
graph.addField(
'linecodeviolation',
'Line Code Violation',
draw='LINE2',
type='DERIVE',
min=0,
info='Line Code Violation errors per second.')
graph.addField('farendblockerrors',
'Far End Block Errors',
draw='LINE2',
type='DERIVE',
min=0,
info='Far End Block errors per second.')
graph.addField('crc4errors',
'CRC4 Errors',
draw='LINE2',
type='DERIVE',
min=0,
info='CRC4 errors per second.')
graph.addField('faserrors',
'FAS Errors',
draw='LINE2',
type='DERIVE',
min=0,
info='FAS errors per second.')
self.appendGraph('wanpipe_pri_errors_%s' % iface, graph)
if self.graphEnabled('wanpipe_pri_rxlevel'):
graph = MuninGraph('Wanpipe - ISDN PRI Signal Level',
'Asterisk',
info='ISDN PRI received signal level in DB.',
args='--base 1000 --lower-limit 0',
vlabel='db')
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
graph.addField(iface, iface, draw='LINE2')
self.appendGraph('wanpipe_pri_rxlevel', graph)
def retrieveVals(self):
"""Retrieve values for graphs."""
for iface in self._ifaceList:
if self._reqIfaceList is None or iface in self._reqIfaceList:
if (self.graphEnabled('wanpipe_traffic')
or self.graphEnabled('wanpipe_errors')):
stats = self._ifaceStats.get(iface)
if stats:
graph_name = 'wanpipe_traffic_%s' % iface
if self.hasGraph(graph_name):
for field in ('rxpackets', 'txpackets'):
self.setGraphVal(graph_name, field,
stats.get(field))
graph_name = 'wanpipe_errors_%s' % iface
if self.hasGraph(graph_name):
for field in ('rxerrs', 'txerrs', 'rxframe',
'txcarrier', 'rxdrop', 'txdrop',
'rxfifo', 'txfifo'):
self.setGraphVal(graph_name, field,
stats.get(field))
if (self.graphEnabled('wanpipe_pri_errors')
or self.graphEnabled('wanpipe_rxlevel')):
try:
stats = self._wanpipeInfo.getPRIstats(iface)
except:
stats = None
if stats:
graph_name = 'wanpipe_pri_errors_%s' % iface
if self.hasGraph(graph_name):
for field in ('linecodeviolation',
'farendblockerrors', 'crc4errors',
'faserrors'):
self.setGraphVal(graph_name, field,
stats.get(field))
if self.hasGraph('wanpipe_rxlevel'):
self.setGraphVal('wanpipe_pri_rxlevel', iface,
stats.get('rxlevel'))
def ifaceIncluded(self, iface):
"""Utility method to check if interface is included in monitoring.
@param iface: Interface name.
@return: Returns True if included in graphs, False otherwise.
"""
return self.envCheckFilter('ifaces', iface)
