PPPOE-MIB

All MIBs › PPPOE-MIB

Organization: IETF Network Working Group

Last Updated: 2000-10-01

Description: IETF draft MIB for PPP over Ethernet session and interface management on broadband access concentrators and DSL aggregation equipment

Start monitoring vendor-neutral, standards-based MIB, any SNMPv3-capable network device (SNMP engine identity/boot/clock status) with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

What Is PPPOE-MIB?

PPPOE-MIB is an IETF draft-era, vendor-neutral MIB module for managing PPP over Ethernet (PPPoE), commonly used on DSL and broadband access concentrators that terminate subscriber PPPoE sessions. It exposes configuration objects for session limits and PADI discovery timing, per-service-name configuration entries, and a bindings table tracking active PPPoE sessions bound to underlying interfaces. Operators use it to monitor how many active PPPoE sessions or bindings exist relative to configured maximums, watch for PADI retry storms indicating discovery problems, and confirm that configured service names are enabled and reachable — key software/service-availability indicators on access aggregation gear. Because PPPoE sessions typically ride over PPP itself, this MIB is often deployed alongside PPP-MIB and the IF-MIB. It is typically deployed on broadband remote access servers (BRAS), DSL aggregation switches, and edge routers offering PPPoE termination to residential or business subscribers. Engineers searching for pppoe cisco or cisco pppoe monitoring should note this particular module is the vendor-neutral IETF PPPoE MIB rather than a Cisco-specific one, though it applies equally to PPPoE sessions terminated on Cisco access equipment.

IPNetwork Monitor allows you to monitor SNMP objects defined in PPPOE-MIB. Use the built-in SNMP Monitoring Browser to explore available variables, view their current values and descriptions, and select the objects you want to monitor. You can then create SNMP monitors, configure thresholds, and receive alerts when monitored values change.

Supported Devices

Broadband remote access servers (BRAS)
DSL aggregation switches
vendor-neutral, standards-based MIB

Monitoring Examples

An operator can check pPPoEConfigMaxTotalSessions against the current count of active entries in pPPoEBindingsTable to see how close the concentrator is to its session ceiling. Polling pPPoEBindingsEnabled per pPPoEBindingsIndex confirms whether a specific subscriber binding is active, while a rising pPPoEConfigPADIMaxNumberOfRetries counter alongside pPPoEConfigPADITxInterval can reveal discovery-phase failures affecting new session setup. The pPPoEConfigServiceNameTable, keyed by pPPoEConfigServiceName with a pPPoEConfigServiceRowStatus column, lets an admin verify a particular offered service is provisioned and active.

What Can Be Monitored

active PPPoE session bindings
maximum total sessions configured
max sessions per host
PADI discovery retry counts
PADI transmit interval
configured service names and their status

Imported Objects

From IF-MIB

InterfaceIndex

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
Gauge32
Integer32
MODULE-IDENTITY
OBJECT-TYPE
experimental

From SNMPv2-TC

DisplayString
RowStatus
TruthValue

How to Use in IPNetwork Monitor

Example using pPPoEBindingsTotalNumberSessions OID:

Select a Broadband remote access servers (BRAS)/DSL aggregation switches, vendor-neutral IETF PPPoE MIB as the target host to create a monitor — the SNMP service should be up and running on it. Click New Monitor, then check SNMP Custom on the Favorites tab, click Next, and confirm the host. On the next page, click Select... to open the built-in SNMP MIB Browser and type pPPoEBindingsTotalNumberSessions into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. The total number of PPPoE Sessions since last counter reset. On the monitor's Main parameters page you can set the target's SNMP port (default 161), credentials, polling interval, and other settings — see the SNMP Monitor help for details. On the State conditions and Alerting tabs, configure when the monitor should change state and trigger an alert; since this is a Counter32-type OID, Value bounds is the most useful condition here — trigger an alert if the counter increases sharply between polls relative to its normal baseline, since an unexpected spike often reflects a real change in traffic or activity. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
pPPoE	1.3.6.1.3.9999.1			The MIB module that describes managed objects of general use by the PPP over Ethernet Protocol.
pPPoEObjects	1.3.6.1.3.9999.1.1
pPPoEConfig	1.3.6.1.3.9999.1.1.1
I32 pPPoEConfigMaxTotalSessions	1.3.6.1.3.9999.1.1.1.1	Integer32	read-write	The number of maximum allowed PPPoE sessions
I32 pPPoEConfigMaxSessionsPerHost	1.3.6.1.3.9999.1.1.1.2	Integer32	read-write	The number of maximum allowed PPPoE sessions from a peer
I32 pPPoEConfigPADITxInterval	1.3.6.1.3.9999.1.1.1.3	Integer32	read-write	The time n seconds between PADI retries from the Host
I32 pPPoEConfigPADIMaxNumberOfRetries	1.3.6.1.3.9999.1.1.1.4	Integer32	read-write	The number of times the Host sends a PADI
pPPoEConfigServiceNameTable	1.3.6.1.3.9999.1.1.1.5		not-accessible	The table listing the service names configured for PPPoE.
pPPoEConfigServiceNameEntry	1.3.6.1.3.9999.1.1.1.5.1		not-accessible	An entry representing service name enabled for PPPoE
STR pPPoEConfigServiceName	1.3.6.1.3.9999.1.1.1.5.1.1	DisplayString	read-create	The service name enabled for PPPoE.
ROW pPPoEConfigServiceRowStatus	1.3.6.1.3.9999.1.1.1.5.1.2	RowStatus	read-create	This object is used to create and delete rows from the pPPoEServiceTable. It can be set only to the value of createAndGo and destroy. It returns only the value of active.
pPPoEBindings	1.3.6.1.3.9999.1.1.2
pPPoEBindingsTable	1.3.6.1.3.9999.1.1.2.1		not-accessible	The table listing the Ethernet interfaces on which PPPoE is bound.
pPPoEBindingsEntry	1.3.6.1.3.9999.1.1.2.1.1		not-accessible	An entry representing an interface on which PPPoE is bound.
NUM pPPoEBindingsIndex	1.3.6.1.3.9999.1.1.2.1.1.1	InterfaceIndex	read-only	This value for this object is equal to the value of ifIndex of the Interfaces MIB for the Ethernet interfaces.
T/F pPPoEBindingsEnabled	1.3.6.1.3.9999.1.1.2.1.1.2	TruthValue	read-write	Whether pppoe is enabled or not.
G32 pPPoEBindingsNumberActiveSessions	1.3.6.1.3.9999.1.1.2.1.1.3	Gauge32	read-only	The number of Active PPPoE Sessions
C32 pPPoEBindingsTotalNumberSessionsEx	1.3.6.1.3.9999.1.1.2.1.1.4	Counter32	read-only	The total number of PPPoE Sessions since last counter reset
C32 pPPoEBindingsNumberPADIRejected	1.3.6.1.3.9999.1.1.2.1.1.5	Counter32	read-only	The number of PADI discarded
C32 pPPoEBindingsNumberPADIReceived	1.3.6.1.3.9999.1.1.2.1.1.6	Counter32	read-only	The number of PPPoE PADI received
C32 pPPoEBindingsNumberPADRRejected	1.3.6.1.3.9999.1.1.2.1.1.7	Counter32	read-only	The number of PPPoE PADR discarded
C32 pPPoEBindingsNumberPADRReceived	1.3.6.1.3.9999.1.1.2.1.1.8	Counter32	read-only	The number of PPPoE PADR received
C32 pPPoEBindingsNumberPADOTransmitted	1.3.6.1.3.9999.1.1.2.1.1.9	Counter32	read-only	The number of PPPoE PADO transmitted
C32 pPPoEBindingsNumberPADSTransmitted	1.3.6.1.3.9999.1.1.2.1.1.10	Counter32	read-only	The number of PPPoE PADS transmitted
C32 pPPoEBindingsNumberPADTReceived	1.3.6.1.3.9999.1.1.2.1.1.11	Counter32	read-only	The number of PPPoE PADT received
C32 pPPoEBindingsNumberPADTTransmitted	1.3.6.1.3.9999.1.1.2.1.1.12	Counter32	read-only	The number of PPPoE PADT transmitted
C32 pPPoEBindingsNumberServiceNameErrors	1.3.6.1.3.9999.1.1.2.1.1.13	Counter32	read-only	The number of PPPoE Service-Name-Error tags received/transmitted
C32 pPPoEBindingsNumberACSystemErrors	1.3.6.1.3.9999.1.1.2.1.1.14	Counter32	read-only	The number of PPPoE AC-System-Error tags received/transmitted
C32 pPPoEBindingsNumberGenericErrorsReceived	1.3.6.1.3.9999.1.1.2.1.1.15	Counter32	read-only	The number of PPPoE Generic-Error tags received
C32 pPPoEBindingsNumberGenericErrorsTransmitted	1.3.6.1.3.9999.1.1.2.1.1.16	Counter32	read-only	The number of PPPoE Generic-Error tags transmitted
C32 pPPoEBindingsNumberMalformedPackets	1.3.6.1.3.9999.1.1.2.1.1.17	Counter32	read-only	The number of malformed PPPoE packets received
C32 pPPoEBindingsNumberPADITimeouts	1.3.6.1.3.9999.1.1.2.1.1.18	Counter32	read-only	The number of PPPoE timeouts waiting for a response to a PADI
C32 pPPoEBindingsNumberMultiplePADOReceived	1.3.6.1.3.9999.1.1.2.1.1.19	Counter32	read-only	The number of PPPoE multiple PADO's received after a PADI request
pPPoESession	1.3.6.1.3.9999.1.1.3
pPPoESessionTable	1.3.6.1.3.9999.1.1.3.1		not-accessible	This table lists the PPPoE sessions established in the device
pPPoESessionEntry	1.3.6.1.3.9999.1.1.3.1.1		not-accessible	Table of PPPoE sessions in the device
NUM pPPoESessionIfIndex	1.3.6.1.3.9999.1.1.3.1.1.1	InterfaceIndex	read-only	The value for this object is equal to the value of ifIndex of the Interfaces MIB for the PPPoE interface instantiated for this session.
I32 pPPoESessionID	1.3.6.1.3.9999.1.1.3.1.1.2	Integer32	read-only	This object contains the session identifier for this session as assigned by the AC in the PADS message.
STR pPPoESessionPeerAddress	1.3.6.1.3.9999.1.1.3.1.1.3	DisplayString	read-only	This object contains the MAC address for the session peer.
INT pPPoESessionState	1.3.6.1.3.9999.1.1.3.1.1.4	INTEGER	read-only	This object contains the session state for this session
pPPoEConformance	1.3.6.1.3.9999.1.2
pPPoEConformanceGroups	1.3.6.1.3.9999.1.2.1
pPPoEGeneralConformanceGroup	1.3.6.1.3.9999.1.2.1.1			This group is mandatory for all PPPoE entities.
pPPoEHostConformanceGroup	1.3.6.1.3.9999.1.2.1.2			This group is mandatory for all Host entities.
pPPoEACConformanceGroup	1.3.6.1.3.9999.1.2.1.3			This group is mandatory for all AC entities.
pPPoECompliances	1.3.6.1.3.9999.1.2.2
pPPoECompliance	1.3.6.1.3.9999.1.2.2.1			The compliance statement for agents that support the PPPOE-MIB.

RFC description

MIB module for managing Point-to-Point Protocol over Ethernet (PPPoE) sessions, configuration, and bindings.

Start monitoring Broadband remote access servers (BRAS)/DSL aggregation switches, vendor-neutral IETF PPPoE MIB with a free 30-day trial of IPNetwork Monitor. Import MIBs, browse SNMP OIDs, create custom SNMP monitors, configure alerts, and monitor any SNMP-enabled network device from a single console.

Download PPPOE-MIB