quagga-snmp-bgpd

quagga-snmp-bgpd − Net-SNMP extension for monitoring Quagga bgpd

quagga-snmp-bgpd is an extension for the Net-SNMP agent. It probes a running Quagga bgpd instance and makes show ip bgp summary statistics available through SNMP. Unlike the standard RFC 1657 BGP4 MIB, this includes the number of prefixes received from every peer. This makes it possible to see disappearing peers using a tool such as MRTG.

In order to use this extension, you need of course Quagga installed and vtysh properly configured using the nopassword directive. All statistics are fetched through the vtysh program. In order to test if it is properly configured, the following command should give you a summary of all BGP sessions:

$ vtysh -e "show ip bgp summary"

You also need a working Net-SNMP installation.

After installing quagga-snmp-bgpd in /usr/local/share on your machine, you need to adapt Net-SNMP’s snmpd.conf as follows:

pass_persist .1.3.6.1.4.1.99999.1 /usr/local/sbin/quagga-snmp-bgpd

Choose an OID that does not interfere with existing OIDs in your SNMP management system. Note that if you change the OID, you will also need to change the base OID in the script itself.

After restarting the Net-SNMP daemon, you should now be able to get information from Quagga using SNMP:

$ snmpwalk <machine> <community> .1.3.6.4.1.99999.1

This returns some general information:

enterprises.99999.1.1 = <number of peers>
enterprises.99999.1.2 = <number of active peers>
enterprises.99999.1.3 = <number of as path entries>
enterprises.99999.1.4 = <number of bgp community entries>
enterprises.99999.1.5 = <total number of prefixes>

For every configured peer a.b.c.d , the following information is returned:

enterprises.99999.1.9.a.b.c.d.1 = <ip address: same as a.b.c.d>
enterprises.99999.1.9.a.b.c.d.2 = <state: 0=down, 1=up>
enterprises.99999.1.9.a.b.c.d.3 = <asn>
enterprises.99999.1.9.a.b.c.d.4 = <prefixes>
enterprises.99999.1.9.a.b.c.d.5 = <up/down time>

snmpd.conf(5snmp)

At the moment, only information relating to IPv4 sessions is returned.

Copyright (C) 2004-2006 Oliver Hitz <oliver@net-track.ch>, distributed under the GNU General Public License.