mirror/librenms-librenms
1
0
Fork 0
mirror of https://github.com/librenms/librenms.git synced 2024-10-07 16:52:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
librenms-librenms/doc/Interface-Description-Parsing.md
f0o d1c7f00bed Added wiki page. 
as discussed in #70
2014-01-19 13:52:34 +01:00

1.8 KiB
Raw Blame History

Table of Content:

About:

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

Setup:

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

  • Add ifAlias from /path/to/librenms/scripts/ or download it from here to the Server and make it executeable 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 insteall 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

Sourcecode: