checkman/if_lancom

   1 title: LANCOM devices: Network interfaces via standard MIB using 64 Bit counters
   2 agents: snmp
   3 catalog: hw/network/lancom
   4 license: GPL
   5 distribution: check_mk
   6 description:
   7  This check does exactly the same as {if64} but retrieves {ifName} instead
   8  of {ifDescr}, because {ifDescr} is not useful in LANCOM devices.
   9
  10  It uses 64 bit counters from the {IF-MIB} below {.1.3.6.1.2.1.31.1.1.1}. This allows to correctly
  11  monitor switch ports with a traffic of more then 2GB per check interval.
  12
  13  Also this check can use {ifAlias} instead if {ifDescr} for retrieving
  14  the admin-configured interface description. This is e.g. useful for HP ProCurve
  15  switches which do not show that aliasses in {ifDescr}.
  16
  17  {Note}: This check needs SNMP v2c and thus only works, if you hosts are
  18  added to {bulkwalk_hosts}.
  19
  20  Depending on the check paramters this check can go WARN or CRIT when the
  21  port status changes (i.e. is down), when the link speed changes (e.g. a
  22  port expected to be set to 1GBit/s operates only at 100MBit/s), when the
  23  absolute or procentual traffic of a port exceeds certain levels or if the
  24  rate of errors or discards exceeds configurable limits.
  25
  26  As of Check_MK version 1.1.9i1 this check supports averaging the in- and
  27  outgoing traffic over a configurable range of time by using an exponentially
  28  weighted moving average - just as Linux does for the CPU load averages.
  29  The averaging can be configured on a per host and per port base. This is
  30  done by adding a key {"average"} to the parameter dictionary with the number
  31  of minutes that the average should cover as its key. Port with averaging
  32  turned on output two additional performance values: the averaged traffic
  33  in bytes. If you have configured traffic levels, then those levels are
  34  applied to the averaged values.
  35
  36 item:
  37  There are three allowed ways to specify a port: {1}: the last component of
  38  the SNMP OID number (as string), the {ifDescr} of the port or the {ifAlias} of
  39  the port. If you are using the alias, you have to make sure that it is unique
  40  by configuring useful aliases in the switch. Check_MK does not check for uniqueness.
  41
  42 inventory:
  43  The inventory creates one service for each port that fulfills configurable conditions.
  44  Per default these are ports which are currently found {up} and are of types {6} (ethernetCsmacd),
  45  {32} (frameRelay) or {117} (gigabitEthernet).
  46
  47  {Grouping:} In some situations you do not want to monitor a single
  48  interface but a group of interfaces that together form a pool.
  49  The {if} check supports such pools by defining groups.
  50  You can specifiy the members of a group by their port type and the item name(s) of
  51  the single interfaces. The data of all members is accumulated and put together
  52  in a single grouped interface service.
  53
  54  You can specify the groups with the ruleset {if_groups}.
  55  Groups are defined as list of dictionaries.
  56
  57  The keys are:
  58
  59   {"name"}:   String. Name of the group within the service description
  60
  61   {"iftype"}: Integer. Interface port type as integer
  62
  63   {"include_items"}: List of Strings. Interface item name. This name depends
  64   on further settings like if_inventory_uses_alias or if_inventory_uses_description
  65
  66   {"single"}(optional): Bool. Interfaces in this group do not show up
  67   as single service if "single" is set to True (Default: False)
  68
  69   For example: if_groups = ([{"name" : "Group WLAN", "iftype" : 6, "single" : True}], ["lan"], ALL_HOSTS )
  70