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.

Per-session traffic counters

The subscriber group's aggregate byte totals (e.g. total_bytes_in / total_bytes_out) are now populated from real per-session usage. show subscribers reports per-session bytes and packets (in and out), which the SNMP agent aggregates into the subscriber group totals.

MIB Groups​

BranchGroupMetrics
.1SystemVersion, uptime, hostname, config commits
.2SubscribersSession counts, traffic counters (real per-session bytes/packets), 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​