Skip to main content

SNMP Overview

SNMP monitoring integration for AthenaBNG.

Overview​

AthenaBNG exposes 28 metrics via a custom ATHENA-BNG-MIB under IANA enterprise OID 1.3.6.1.4.1.65245. The SNMP agent runs as an AgentX subagent under net-snmp.

MIB Groups​

BranchGroupMetrics
.1SystemVersion, uptime, hostname, config commits
.2SubscribersSession counts, traffic counters, provisioned bandwidth
.3QoSCAKE sessions, IFB devices, pending QoS
.4CGNATCGNAT vs public session split
.5DemuxDynamic VLANs, unique access interfaces
.6ServicesDaemon health checks (abngd, demux, accel-ppp, qos, dhcpd, API)

Configuration​

snmp:
  enabled: true
  community: "my-community"
  location: "Brisbane, Australia"
  contact: "noc@example.com"

MIB Installation​

sudo cp /opt/athena-bng/snmp/ATHENA-BNG-MIB.txt /usr/share/snmp/mibs/

Quick Start​

Get Active Session Count​

snmpget -v2c -c my-community localhost 1.3.6.1.4.1.65245.2.1.0

Walk All Metrics​

snmpwalk -v2c -c my-community localhost 1.3.6.1.4.1.65245

Check Service Health​

# Is abngd up? (1 = true, 2 = false)
snmpget -v2c -c my-community localhost 1.3.6.1.4.1.65245.6.1.0

Integration​

Nagios/Icinga​

# Alert when active sessions exceed thresholds
check_snmp -H localhost -C my-community -o 1.3.6.1.4.1.65245.2.1.0 -w 4000 -c 5000

# Alert when abngd is down (value != 1)
check_snmp -H localhost -C my-community -o 1.3.6.1.4.1.65245.6.1.0 -c 1:1

Zabbix​

Create SNMP items:

Name: AthenaBNG Active Sessions
OID: 1.3.6.1.4.1.65245.2.1.0

Name: AthenaBNG Total Bytes In
OID: 1.3.6.1.4.1.65245.2.6.0

Name: AthenaBNG Service Health - abngd
OID: 1.3.6.1.4.1.65245.6.1.0

Next Steps​