Table of Content: - About - Setup - Keywords - Type-keywords - Info-keywords - Examples - Sourcecode

About:

Librenms can interpret, display and group certain additional information on ports. For this a small bash script is supplied in scripts/ called ifAlias.

Setup:

This requires a little bit of setup on the monitored Server (Not the server running librenms!):

  • Add ifAlias from /opt/librenms/scripts/ or download it from here to the Server and make it executable chmod +x /path/to/ifAlias
  • Add to snmpd.conf something like: pass .1.3.6.1.2.1.31.1.1.1.18 /path/to/ifAlias
  • Restart your net-snmpd

There are no changes to be made or additions to install for the polling librenms.

Now you can set up your keywords in your /etc/network/interfaces //Add more distributions than just Debian based

Keywords:

See examples for formats.

  • Type-keywords:
  • Cust - Customer
  • Transit - Transit link
  • Peering - Peering link
  • Core - Infrastructure link (non-customer)
  • Server - Server link (non-customer)
  • Info-keywords:
  • () contains a note
  • {} contains your circuit id
  • [] contains the service type or speed

Examples:

# eth3: Cust: Example Customer [10Mbit] (T1 Telco Y CCID129031) {EXAMP0001}`
# eth0: Transit: Example Provider (AS65000)`
# eth1: Core: core.router01 FastEthernet0/0 (Telco X CCID023141)`
# eth2: Peering: Peering Exchange

Source code:

  • https://github.com/librenms/librenms/blob/master/scripts/ifAlias