Torrus plugin for M-net Telekommunikations

Status: Pre-alpha; Last modified: 02-FEB-2010

Introduction

This plugin is aiming the automation requirements at M-net Telekommunikations (www.m-net.de).

The interface descriptions of the form ``key1=val1;key2=val2;...'' are interpreted by the plugin and corresponding actions are performed.

Installation

Follow the Torrus installation guide for the main software installation.

Unpack the plugin distribution package in some directory:

  gzip -dc tp-m-net-1.X.tar.gz | tar xvf -

Then run the Torrus plugin installation utility:

  torrus install_plugin tp-m-net-1.X

No restarting is needed.

Usage

Out of the interface description string of format ``key1=val1;key2=val2;...'' the following key values are interpreted:

bw

Indicates the interface bandwidth in bits/second. Scale suffixes (T, G, M, K) are supported (i.e. 5G is equal to 5.0e9). The limits are used in graph display and also for setting up threshold monitors. The following interface parameters are set to the correspomding numbers: bandwidth-limit-in, bandwidth-limit-out, upper-limit, mnet-bw

Discovery parameters:

M_net::skip-host

If set to yes, the corresponding host is skipped from plugin processing.

M_net::skip-interfaces

Comma-separated list of interface names (their correspomnding subtree names). These interfaces are skipped from plugin processing.

Selectors

The M-net selectors extend the functionality of RFC2863_IF_MIB selectors. The selectors of the type M_net act upon the device interfaces in the same manner as the RFC2863_IF_MIB selectors. The only difference is that the selector attributes are the keys used in interface descriptions.

The following example sets up the monitors on all interfaces which have ct=UPSTREAM and st=act. It also illustrates how 3 levels of threshold monitoring can be set up for input and output bandwidth usage:

  <param name="selectors" value="mymon"/>
  <param name="mymon-selector-type" value="M_net"/>
  <param name="mymon-selector-expr"  value="{ct},{st},AND"/>
  <param name="mymon-ct"  value="^UPSTREAM$"/>
  <param name="mymon-st"  value="^act$"/>
  <param name="mymon-selector-actions">
     InBytesMonitor, OutBytesMonitor, NotifyPolicy
  </param>
  <param name="mymon-InBytesMonitor-arg" 
     value="bwin-warn,bwin-major,bwin-crit"/>
  <param name="mymon-OutBytesMonitor-arg" 
     value="bwout-warn,bwout-major,bwout-crit"/>
  <param name="mymon-NotifyPolicy-arg" 
     value="high-impact"/>

Development of this plugin was sponsored by M-net Telekommunikations GmbH.

Author

Copyright (c) 2010 Stanislav Sinyagin <ssinyagin@yahoo.com>