NET-SNMP-EXAMPLES-MIB

All MIBs › NET-SNMP-EXAMPLES-MIB

Organization: www.net-snmp.org

Last Updated: 2004-06-15

Category: Net-SNMP and Linux

Description: Defines example objects under the Net-SNMP enterprise tree used for demonstration and testing of Net-SNMP agent extensibility features.

IPNetwork Monitor uses several OIDs from this MIB in network discovery and polling the applicable devices. Start monitoring NET-SNMP-EXAMPLES-MIB with a free 30-day trial of IPNetwork Monitor.

What Is NET-SNMP-EXAMPLES-MIB?

NET-SNMP-EXAMPLES-MIB is a demonstration and testing module bundled with the open-source Net-SNMP agent, illustrating how custom objects and agent extension modules can be implemented rather than representing any commercial hardware vendor's product. It exposes example scalar objects (integers, strings, and a deliberately slow-responding "sleeper" object), a sample IETF working group table, and a sample hosts table, none of which reflect real production data. Rather than monitoring genuine hardware or software health, this MIB is used to validate SNMP agent extensibility, notification handling, and poller behavior against known values -- for instance, using the sleeper object to test how a management station handles delayed responses. It depends on the core Net-SNMP agent framework (and optionally AgentX) rather than on any standard IETF or vendor MIB hierarchy. It is found only on systems running the Net-SNMP daemon (snmpd) with example modules enabled, typically for developer training or SNMP tool testing. Engineers can download the NET-SNMP-EXAMPLES-MIB file directly to load it into their MIB browser.

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

Linux/Unix hosts running the Net-SNMP agent (snmpd)
vendor-neutral demonstration module, not tied to specific hardware

Monitoring Examples

An engineer testing a new polling tool could walk netSnmpExampleScalars to read netSnmpExampleInteger and netSnmpExampleString as known baseline values, then poll netSnmpExampleSleeper to confirm the tool correctly handles a deliberately delayed SNMP response instead of timing out prematurely. The netSnmpIETFWGTable (nsIETFWGName, nsIETFWGChair1, nsIETFWGChair2) and netSnmpHostsTable (netSnmpHostName, netSnmpHostAddressType) provide sample tabular data for practicing table-walk logic, though none of it reflects real device state.

What Can Be Monitored

example integer/string scalar values
sleeper object for delayed-response/timeout testing
example IETF working group table entries
example hosts table entries

Imported Objects

From INET-ADDRESS-MIB

InetAddress
InetAddressType

From NET-SNMP-MIB

netSnmp

MODULE-IDENTITY

From SNMP-FRAMEWORK-MIB

SnmpAdminString

From SNMPv2-SMI

Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE

From SNMPv2-TC

RowStatus
StorageType

OIDs

OID symbolic	OID numeric	Type	Access	Description
netSnmpExamples	1.3.6.1.4.1.8072.2			Example MIB objects for agent module example implementations
netSnmpExampleScalars	1.3.6.1.4.1.8072.2.1
I32 netSnmpExampleInteger	1.3.6.1.4.1.8072.2.1.1	Integer32	read-write	This is a simple object which merely houses a writable integer. It's only purposes is to hold the value of a single integer. Writing to it will simply change the value for subsequent GET/GETNEXT/GETBULK retrievals. This example object is implemented in the agent/mibgroup/examples/scalar_int.c file.
I32 netSnmpExampleSleeper	1.3.6.1.4.1.8072.2.1.2	Integer32	read-write	This is a simple object which is a basic integer. It's value indicates the number of seconds that the agent will take in responding to requests of this object. This is implemented in a way which will allow the agent to keep responding to other requests while access to this object is blocked. It is writable, and changing it's value will change the amount of time the agent will effectively wait for before returning a response when this object is manipulated. Note that SET requests through this object will take longer, since the delay is applied to each internal transaction phase, which could result in delays of up to 4 times the value of this object. This example object is implemented in the agent/mibgroup/examples/delayed_instance.c file.
I32 netSnmpExampleString	1.3.6.1.4.1.8072.2.1.3	Integer32	read-write	This is a simple object which merely houses a writable string. It's only purposes is to hold the value of a single string. Writing to it will simply change the value for subsequent GET/GETNEXT/GETBULK retrievals. This example object is implemented in the agent/mibgroup/examples/watched.c file.
netSnmpExampleTables	1.3.6.1.4.1.8072.2.2
netSnmpIETFWGTable	1.3.6.1.4.1.8072.2.2.1		not-accessible	This table merely contains a set of data which is otherwise useless for true network management. It is a table which describes properies about a IETF Working Group, such as the names of the two working group chairs. This example table is implemented in the agent/mibgroup/examples/data_set.c file.
netSnmpIETFWGEntry	1.3.6.1.4.1.8072.2.2.1.1		not-accessible	A row describing a given working group
OCT nsIETFWGName	1.3.6.1.4.1.8072.2.2.1.1.1	OCTET STRING	not-accessible	The name of the IETF Working Group this table describes.
OCT nsIETFWGChair1	1.3.6.1.4.1.8072.2.2.1.1.2	OCTET STRING	read-create	One of the names of the chairs for the IETF working group.
OCT nsIETFWGChair2	1.3.6.1.4.1.8072.2.2.1.1.3	OCTET STRING	read-create	The other name, if one exists, of the chairs for the IETF working group.
netSnmpHostsTable	1.3.6.1.4.1.8072.2.2.2		not-accessible	An example table that implements a wrapper around the /etc/hosts file on a machine using the iterator helper API.
netSnmpHostsEntry	1.3.6.1.4.1.8072.2.2.2.1		not-accessible	A host name mapped to an ip address
OCT netSnmpHostName	1.3.6.1.4.1.8072.2.2.2.1.1	OCTET STRING	not-accessible	A host name that exists in the /etc/hosts (unix) file.
IPt netSnmpHostAddressType	1.3.6.1.4.1.8072.2.2.2.1.2	InetAddressType	read-create	The address type of then given host.
IP netSnmpHostAddress	1.3.6.1.4.1.8072.2.2.2.1.3	InetAddress	read-create	The address of then given host.
STO netSnmpHostStorage	1.3.6.1.4.1.8072.2.2.2.1.4	StorageType	read-create	The storage type for this conceptual row.
ROW netSnmpHostRowStatus	1.3.6.1.4.1.8072.2.2.2.1.5	RowStatus	read-create	The status of this conceptual row.
netSnmpExampleNotifications	1.3.6.1.4.1.8072.2.3
netSnmpExampleNotificationPrefix	1.3.6.1.4.1.8072.2.3.0
NTF netSnmpExampleHeartbeatNotification	1.3.6.1.4.1.8072.2.3.0.1			An example notification, used to illustrate the definition and generation of trap and inform PDUs (including the use of both standard and additional varbinds in the notification payload). This notification will typically be sent every 30 seconds, using the code found in the example module agent/mibgroup/examples/notification.c
STR netSnmpExampleNotification	1.3.6.1.4.1.8072.2.3.1	SnmpAdminString	accessible-for-notify	This object was improperly defined for its original purpose, and should no longer be used.
netSnmpExampleNotificationObjects	1.3.6.1.4.1.8072.2.3.2
I32 netSnmpExampleHeartbeatRate	1.3.6.1.4.1.8072.2.3.2.1	Integer32	accessible-for-notify	A simple integer object, to act as a payload for the netSnmpExampleHeartbeatNotification. The value has no real meaning, but is nominally the interval (in seconds) between successive heartbeat notifications.
STR netSnmpExampleHeartbeatName	1.3.6.1.4.1.8072.2.3.2.2	SnmpAdminString	accessible-for-notify	A simple string object, to act as an optional payload for the netSnmpExampleHeartbeatNotification. This varbind is not part of the notification definition, so is optional and need not be included in the notification payload. The value has no real meaning, but the romantically inclined may take it to be the object of the sender's affection, and hence the cause of the heart beating faster.

RFC description

NET-SNMP example MIB objects for agent module reference implementations.

Start monitoring Linux/Unix host running Net-SNMP agent (demonstration module, not real hardware) 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 NET-SNMP-EXAMPLES-MIB

What Is NET-SNMP-EXAMPLES-MIB?

Supported Devices

Monitoring Examples

What Can Be Monitored

This MIB depends on

Related MIBs

RFC description