https://github.com/subuk/bird2snmp

SNMP AgentX client to expose bird metrics
https://github.com/subuk/bird2snmp

agentx bgp bird snmp

Last synced: 5 months ago
JSON representation

SNMP AgentX client to expose bird metrics

• Host: GitHub
• URL: https://github.com/subuk/bird2snmp
• Owner: subuk
• Created: 2024-10-13T15:57:32.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2025-04-13T21:51:37.000Z (about 1 year ago)
• Last Synced: 2025-04-13T22:36:24.256Z (about 1 year ago)
• Topics: agentx, bgp, bird, snmp
• Language: Go
• Homepage:
• Size: 322 KB
• Stars: 7
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🦅 Bird2 SNMP Agent

[![Go Report Card](https://goreportcard.com/badge/github.com/subuk/bird2snmp)](https://goreportcard.com/report/github.com/subuk/bird2snmp)

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

[![Go Version](https://img.shields.io/badge/go-1.21+-00ADD8.svg)](https://golang.org/dl/)

A lightweight SNMP AgentX implementation for monitoring BIRD routing daemon through SNMP. This agent provides real-time monitoring of BGP peers and their states using the standard BGP4-MIB.

## ✨ Features

- 🚀 Real-time BGP peer monitoring

- 📊 SNMP AgentX protocol support

- 🔄 Automatic data refresh

- 🛠️ IPv4 BGP peer support

- 📈 Standard BGP4-MIB compliance

### Supported OIDs

| OID | Description |

|-----|-------------|

| bgpLocalAs | Local Autonomous System number |

| bgpPeerState | Current state of BGP peer |

| bgpPeerRemoteAddr | Remote peer IP address |

| bgpPeerFsmEstablishedTime | Time since BGP session establishment |

| bgpIdentifier | BGP router identifier |

## 🚀 Installation

### Prerequisites

- BIRD2 configured with BGP peers

- net-snmpd installed and configured

### Quick Start

1. Install net-snmpd:

```bash

opkg install snmpd snmp-mibs

```

2. Configure net-snmpd:

```bash

cat > /opt/etc/snmp/snmpd.conf < /opt/etc/init.d/S81bird2snmp <