BEGEMOT-NETGRAPH-MIB

All MIBs › BEGEMOT-NETGRAPH-MIB

Organization: Fraunhofer FOKUS, CATS

Last Updated: 2003-11-14

Category: Net-SNMP and Linux

Description: Manages FreeBSD Netgraph kernel networking framework nodes, hooks, and message statistics via bsnmpd.

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 BEGEMOT-NETGRAPH-MIB?

BEGEMOT-NETGRAPH-MIB is part of the "Begemot" family of FreeBSD-specific MIB modules exposed by the bsnmpd SNMP agent, providing management access to FreeBSD's Netgraph kernel networking framework used to build modular packet-processing graphs of nodes and hooks. It exposes configuration objects (control-socket node name, timeout, debug level, message buffer size) alongside runtime statistics such as out-of-memory events, message/data read errors, and oversized message/data counts, plus a table enumerating loaded Netgraph node types. Its monitoring focus is software/kernel-subsystem health on the host running Netgraph -- surfacing resource exhaustion (begemotNgNoMems) and protocol/message errors that indicate the Netgraph subsystem is misbehaving or under memory pressure, rather than physical hardware sensors. It is a FreeBSD/bsnmpd-specific private MIB with no dependency on standard networking MIBs beyond the base bsnmpd Begemot framework. It is deployed on FreeBSD-based routers, firewalls, or appliances that use Netgraph for PPP, VLAN, bridging, or tunneling and are monitored via bsnmpd, typically after a BEGEMOT-NETGRAPH-MIB download is loaded into the local MIB directory.

IPNetwork Monitor allows you to monitor SNMP objects defined in BEGEMOT-NETGRAPH-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

FreeBSD-based router, firewall, or network appliance

Monitoring Examples

Polling begemotNgNoMems, begemotNgMsgReadErrs, and begemotNgDataReadErrs over time reveals whether the Netgraph subsystem is experiencing memory pressure or message-passing errors, which would correlate with dropped PPPoE sessions or bridging failures on a FreeBSD appliance. begemotNgTypeTable/begemotNgTypeEntry (via begemotNgTypeName) lets an operator confirm which Netgraph node types are currently loaded in the kernel. begemotNgTooLargeMsgs and begemotNgTooLargeDatas climbing would suggest a misbehaving client sending oversized control messages to the Netgraph socket.

What Can Be Monitored

Netgraph out-of-memory events
message/data read errors
oversized message/data counts
loaded Netgraph node types
control socket timeout/debug configuration

Imported Objects

From BEGEMOT-MIB

begemot

MODULE-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

Counter32
MODULE-IDENTITY
OBJECT-TYPE
Unsigned32

From SNMPv2-TC

TEXTUAL-CONVENTION
TruthValue

How to Use in IPNetwork Monitor

Example using begemotNgNoMems OID:

Select a FreeBSD hosts/appliances running the Begemot bsnmpd SNMP agent 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 begemotNgNoMems into the Find box to locate it in the OID tree, then select it and click OK. It reports the number of times a memory allocation has failed for buffers or the message queue. 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 between polls, since a rising count of errors, failures, or discards often points to a real underlying problem. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
begemotNg	1.3.6.1.4.1.12325.1.2			The MIB for the NetGraph access module for SNMP.
begemotNgObjects	1.3.6.1.4.1.12325.1.2.1
begemotNgConfig	1.3.6.1.4.1.12325.1.2.1.1
NGN begemotNgControlNodeName	1.3.6.1.4.1.12325.1.2.1.1.1	NgNodeName	read-only	The name of the netgraph node of this daemon. The name is writeable during initialisation. If the name is set from the empty string to the non-empty string, the netgraph socket is created. Once set it cannot be changed.
INT begemotNgResBufSiz	1.3.6.1.4.1.12325.1.2.1.1.2	INTEGER	read-write	The size of the receive buffers for netgraph messages.
INT begemotNgTimeout	1.3.6.1.4.1.12325.1.2.1.1.3	INTEGER	read-write	The maximum time to wait for a response to a netgraph message.
U32 begemotNgDebugLevel	1.3.6.1.4.1.12325.1.2.1.1.4	Unsigned32	read-write	The netgraph library debug level. This should be set only if the daemon is run with a terminal attached.
begemotNgStats	1.3.6.1.4.1.12325.1.2.1.2
C32 begemotNgNoMemsEx	1.3.6.1.4.1.12325.1.2.1.2.1	Counter32	read-only	Number of times a memory allocation has failed for buffers or the message queue.
C32 begemotNgMsgReadErrs	1.3.6.1.4.1.12325.1.2.1.2.2	Counter32	read-only	Number of times reading a netgraph message has failed.
C32 begemotNgTooLargeMsgs	1.3.6.1.4.1.12325.1.2.1.2.3	Counter32	read-only	Number of times a netgraph message was too large for the buffer. Try increasing begemotNgResBufSiz if this happens.
C32 begemotNgDataReadErrs	1.3.6.1.4.1.12325.1.2.1.2.4	Counter32	read-only	Number of times reading a netgraph data message has failed.
C32 begemotNgTooLargeDatas	1.3.6.1.4.1.12325.1.2.1.2.5	Counter32	read-only	Number of times a netgraph data message was too large. You need to increase begemotNgResBufSiz.
begemotNgTypeTable	1.3.6.1.4.1.12325.1.2.1.3		not-accessible	A table containing information about all netgraph node types.
begemotNgTypeEntry	1.3.6.1.4.1.12325.1.2.1.3.1		not-accessible	Table entry that describes one netgraph node.
NGT begemotNgTypeName	1.3.6.1.4.1.12325.1.2.1.3.1.1	NgTypeName	not-accessible	The name of the type. Used as index.
INT begemotNgTypeStatus	1.3.6.1.4.1.12325.1.2.1.3.1.2	INTEGER	read-create	If loaded then the node type is available. A type can be load by setting this field to loaded. It is unload if the field is set to unloaded. Note, that a type cannot be unloaded if it is compiled into the kernel or has nodes of this type. The name of the file containing the type implementation is constructed by prepending ng_ to the type name.
begemotNgNodeTable	1.3.6.1.4.1.12325.1.2.1.4		not-accessible	A table containing information about all netgraph nodes.
begemotNgNodeEntry	1.3.6.1.4.1.12325.1.2.1.4.1		not-accessible	Table entry that describes one netgraph node.
NGN begemotNgNodeId	1.3.6.1.4.1.12325.1.2.1.4.1.1	NgNodeId	not-accessible	The 32bit node id of this node. 0 is an illegal value.
INT begemotNgNodeStatus	1.3.6.1.4.1.12325.1.2.1.4.1.2	INTEGER	read-only	Indicates whether the node exists or not.
NGN begemotNgNodeName	1.3.6.1.4.1.12325.1.2.1.4.1.3	NgNodeNameOrEmpty	read-only	Name of the node (if any).
NGT begemotNgNodeType	1.3.6.1.4.1.12325.1.2.1.4.1.4	NgTypeName	read-only	Type name of the node.
U32 begemotNgNodeHooks	1.3.6.1.4.1.12325.1.2.1.4.1.5	Unsigned32	read-only	Number of hooks on this node.
begemotNgHookTable	1.3.6.1.4.1.12325.1.2.1.5		not-accessible	A table containing information about all netgraph hooks.
begemotNgHookEntry	1.3.6.1.4.1.12325.1.2.1.5.1		not-accessible	Table entry that describes one netgraph node.
NGN begemotNgHookNodeId	1.3.6.1.4.1.12325.1.2.1.5.1.1	NgNodeId	not-accessible	The 32bit node id of this node.
NGH begemotNgHookHook	1.3.6.1.4.1.12325.1.2.1.5.1.2	NgHookName	read-only	Name of the hook.
INT begemotNgHookStatus	1.3.6.1.4.1.12325.1.2.1.5.1.3	INTEGER	read-only	Indicates whether the hook exists or not.
NGN begemotNgHookPeerNodeId	1.3.6.1.4.1.12325.1.2.1.5.1.4	NgNodeId	read-only	The 32bit node id of the peer node of this hook.
NGH begemotNgHookPeerHook	1.3.6.1.4.1.12325.1.2.1.5.1.5	NgHookName	read-only	Name of the peer hook.
NGT begemotNgHookPeerType	1.3.6.1.4.1.12325.1.2.1.5.1.6	NgTypeName	read-only	Name of the peer type.

RFC description

Begemot (FreeBSD) vendor-private MIB; provides monitoring and management objects for FreeBSD netgraph kernel networking subsystem.

Start monitoring FreeBSD hosts/appliances running the Begemot bsnmpd SNMP agent 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 BEGEMOT-NETGRAPH-MIB