SNMP Monitoring via snmpd Service

Description

SNMP is a protocol that allows retrieving information about the SSG server for centralized monitoring of critical parameters. This is implemented using the snmpd service included in the operating system.
Operation principle: An SNMP query is sent to the server, the snmpd service collects the required information and sends it to the monitoring server. The monitoring server receives and processes this information, enabling status monitoring of the server - tracking parameter levels and data.

The bngsnmp package contains scripts required for building the VENDOR OID branch for SNMP polling.
It's based on the snmp_passpersist library. Vendor OID branch: .1.3.6.1.4.1.43823

Vendor branch components:

  • CPU statistics, including core utilization by BNG processes;
  • Number of illegitimate drops;
  • Dispatcher drop statistics;
  • RADIUS server availability list (when using a proxy or load balancer, the proxy will be shown in statistics);
  • DHCP subscriber count - with active functionality;
  • PPPoE, L2TP, PPP subscriber count - with active functionality;
  • VRF list and active subscribers in each - with active functionality;
  • DPDK interface statistics (packet count, errors, signal level etc.);
  • NAT statistics (profile list, pool list, and translation count per public address) - with active functionality;
  • Hardware module list installed on motherboard - if supported by BMC controller;
  • Hardware sensor readings (voltage, power consumption, FAN RPMs) - if supported by BMC controller;
  • DHCP pool utilization (supported only with KEA-DHCP server) - with active functionality.

This script also overrides standard branches by adding DPDK interface statistics:

  • .1.3.6.1.2.1.2.2.1 - 32-bit counters
  • .1.3.6.1.2.1.31.1.1.1 - 64-bit counters

If needed, override can be disabled by commenting or removing these lines from /etc/snmp/snmpd.conf:

pass_persist    .1.3.6.1.2.1.2.2.1      /usr/local/bin/bng_snmp/vaspp
pass_persist    .1.3.6.1.2.1.31.1.1.1   /usr/local/bin/bng_snmp/vaspphc

MIB file location after installation: /usr/share/snmp/mibs/VASEXPERTS-MIB.txt

Installation

  1. Installation (net-snmp, net-snmp-utils will be installed as dependencies):
    yum install bngsnmp
  2. Configuration:
    /bin/cp -f /etc/snmp/snmpd.conf.example /etc/snmp/snmpd.conf
  3. Restart net-snmp service:
    systemctl restart snmpd
  4. Disable selinux (if SNMP fails to start):
    vi /etc/selinux/config
    ...
    SELINUX=disabled
    ...

Verifying snmpd and Vendor Branch Functionality

The snmpwalk utility verifies SNMP data reception

Command to test SNMP operation:

snmpwalk -v 2c -c nokiamon localhost -On .1.3.6.1.4.1.43823

The system polls once per minute, so more frequent polling is unnecessary.

How to Read MIB File

To view the MIB file graphically, open it with MIB Browser. It describes the entire vendor branch and its OIDs.
The example below shows:

  1. Vendor branch file
  2. Its OID

Known Limitations

On-stick device support available since version 13.2-beta4.2