Module: check_mk Branch: master Commit: 3bedb9f0a5f9e883851f8f83706b289884eb8472 URL: http://git.mathias-kettner.de/git/?p=check_mk.git;a=commit;h=3bedb9f0a5f9e8… Author: Simon Betz &lt;si(a)mathias-kettner.de&gt; Date: Mon Mar 6 08:19:59 2017 +0100 4483 cisco_vlans: New inventory plugin which collects vlan information of Cisco devices supporting CISCO-VLAN-MEMBERSHIP mib Change-Id: I39886067f23eca5cfa540ca1ab0604b3adcd4e7e --- .werks/4483 | 10 ++++ inventory/cisco_vlans | 124 +++++++++++++++++++++++++++++++++++++++++ web/plugins/views/inventory.py | 2 + 3 files changed, 136 insertions(+) diff --git a/.werks/4483 b/.werks/4483 new file mode 100644 index 0000000..1bfb91a --- /dev/null +++ b/.werks/4483 @@ -0,0 +1,10 @@ +Title: cisco_vlans: New inventory plugin which collects vlan information of Cisco devices supporting CISCO-VLAN-MEMBERSHIP mib +Level: 1 +Component: inv +Compatible: compat +Edition: cre +Version: 1.5.0i1 +Date: 1488784681 +Class: feature + + diff --git a/inventory/cisco_vlans b/inventory/cisco_vlans new file mode 100644 index 0000000..d3e7641 --- /dev/null +++ b/inventory/cisco_vlans @@ -0,0 +1,124 @@ +#!/usr/bin/python +# -*- encoding: utf-8; py-indent-offset: 4 -*- +# +------------------------------------------------------------------+ +# | ____ _ _ __ __ _ __ | +# | / ___| |__ ___ ___| | __ | \/ | |/ / | +# | | | | '_ \ / _ \/ __| |/ / | |\/| | ' / | +# | | |___| | | | __/ (__| < | | | | . \ | +# | \____|_| |_|\___|\___|_|\_\___|_| |_|_|\_\ | +# | | +# | Copyright Mathias Kettner 2016 mk(a)mathias-kettner.de | +# +------------------------------------------------------------------+ +# +# This file is part of Check_MK. +# The official homepage is at http://mathias-kettner.de/check_mk. +# +# check_mk is free software; you can redistribute it and/or modify it +# under the terms of the GNU General Public License as published by +# the Free Software Foundation in version 2. check_mk is distributed +# in the hope that it will be useful, but WITHOUT ANY WARRANTY; with- +# out even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. See the GNU General Public License for more de- +# tails. You should have received a copy of the GNU General Public +# License along with GNU Make; see the file COPYING. If not, write +# to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, +# Boston, MA 02110-1301 USA. + + +# 1.3.6.1.4.1.9.9.68.1.2.2.1.1 --> vmVlanType: static(1), dynamic(2), multiVlan(3) +# 1.3.6.1.4.1.9.9.68.1.2.2.1.2 --> vmVlan: id of the vlan the port is asssigned to +# if type = 1 or 2. +# it's 0 if the port is not assigned to a vlan +# 1.3.6.1.4.1.9.9.68.1.2.2.1.4 --> vmVlans: the vlans the port is assigned to +# if the type = 3 + +# "The VLAN(s) the port is assigned to when the +# port's vmVlanType is set to multiVlan. +# This object is not instantiated if not applicable. + +# The port is always assigned to one or more VLANs +# and the object may not be set so that there are +# no vlans assigned. + +# Each octet within the value of this object specifies a +# set of eight VLANs, with the first octet specifying +# VLAN id 1 through 8, the second octet specifying VLAN +# ids 9 through 16, etc. Within each octet, the most +# significant bit represents the lowest numbered +# VLAN id, and the least significant bit represents the +# highest numbered VLAN id. Thus, each VLAN of the +# port is represented by a single bit within the +# value of this object. If that bit has a value of +# '1' then that VLAN is included in the set of +# VLANs; the VLAN is not included if its bit has a +# value of '0'." + + +# This function compresses a list of vlans, eg [1,3,4,7,8,9,...,1024], +# into a readable format: "1, 3-4, 7-1024" in case of multi-vlans +def parse_multi_vlan(vlan_multi): + + def concatenate_vlans(vlan, subinfo): + if vlan not in subinfo: + subinfo.append(vlan) + return "-".join(map(str, subinfo)) + + vlans = [] + for k, hex in enumerate(vlan_multi): + for l, bit in enumerate(bin(ord(hex))[2:]): + if bit == '1': + vlans.append(k*8 + l+1) + + infotexts = [] + subinfo = vlans[:1] + last_vlan = vlans[0] + + for vlan in vlans[1:]: + if vlan - last_vlan > 1: + infotexts.append(concatenate_vlans(last_vlan, subinfo)) + subinfo = [vlan] + + if vlan == vlans[-1]: + infotexts.append(concatenate_vlans(vlan, subinfo)) + + last_vlan = vlan + + return ", ".join(infotexts) + + +def inv_cisco_vlans(info, params): + node = inv_tree("networking.interfaces:") + map_vlans = { + '1' : 'static', + '2' : 'dynamic', + '3' : 'multi-VLAN', + } + + for if_id, vlan_type, vlan_single, vlan_multi in info: + vlan_readable = map_vlans.get(vlan_type, "") + vlans = None + if vlan_single != '0' and vlan_type in ['1', '2']: + vlans = vlan_single + elif vlan_type == '3': + vlans = parse_multi_vlan(vlan_multi) + + if vlans: + for if_info in node: + if if_info["index"] == int(if_id): + if_info["vlans"] = vlans + if_info["vlantype"] = vlan_readable + break + + return node + + +inv_info['inv_cisco_vlans'] = { + "inv_function" : inv_cisco_vlans, + 'snmp_info' : (".1.3.6.1.4.1.9.9.68.1.2.2.1", [ + OID_END, + "1", # vmVlanType + "2", # vmVlan + "4", # vmVlans + ]), + 'snmp_scan_function': lambda oid: "cisco" in oid(".1.3.6.1.2.1.1.1.0").lower(), +} diff --git a/web/plugins/views/inventory.py b/web/plugins/views/inventory.py index 850122c..70e5583 100644 --- a/web/plugins/views/inventory.py +++ b/web/plugins/views/inventory.py @@ -846,6 +846,8 @@ inventory_displayhints.update({ ".networking.interfaces:*.speed" : { "title" : _("Speed"), "paint" : "nic_speed", }, ".networking.interfaces:*.port_type" : { "title" : _("Type"), "paint" : "if_port_type", "filter" : visuals.FilterInvtableInterfaceType }, ".networking.interfaces:*.last_change" : { "title" : _("Last Change"), "paint" : "timestamp_as_age_days", "filter" : visuals.FilterInvtableTimestampAsAge }, + ".networking.interfaces:*.vlans" : { "title" : _("VLANs") }, + ".networking.interfaces:*.vlantype" : { "title" : _("VLAN type") }, ".networking.wlan" : { "title" : _("WLAN") }, ".networking.wlan.controller" : { "title" : _("Controller") },