DIRECTORY-MONITOR-MIB

All MIBs › DIRECTORY-MONITOR-MIB

Organization: www.net-snmp.org

Last Updated: 2004-06-15

Category: Domain: System Management

Description: Directory monitoring MIB providing objects for monitoring filesystem directory contents, sizes, and change events.

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 DIRECTORY-MONITOR-MIB?

DIRECTORY-MONITOR-MIB is a Net-SNMP example/extension MIB (under the netSnmp enterprise tree) that exposes basic filesystem directory monitoring objects for a Net-SNMP agent. It defines scalars directory (the currently monitored path), numFiles and numDirectories (counts of files/subdirectories within it), and directoryContentTable (directoryEntryIndex, directoryEntryPath, directoryEntryMask) listing the directory's contents, along with a directoryState object and a directoryStateNotification trap fired on state changes. It exposes simple filesystem-state visibility — file/directory counts and content listings — rather than any network protocol data, useful for basic host-level monitoring such as detecting unexpected growth or unauthorized changes in a watched directory. It depends on SNMP-FRAMEWORK-MIB, INET-ADDRESS-MIB, and NET-SNMP-MIB conventions for its base types and OID placement. It is deployed on hosts running the Net-SNMP agent with this module loaded as a demonstration/utility MIB, and engineers use the DIRECTORY-MONITOR-MIB monitor objects to poll and track a specific directory's state.

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

vendor-neutral, standards-based MIB (Net-SNMP extension), not tied to a specific manufacturer — applies to any host running the Net-SNMP agent

Monitoring Examples

An operator polls numFiles and directoryContentTable for a configured directory to confirm no unexpected files have appeared; a directoryStateNotification trap combined with a jump in numFiles would indicate a monitored directory changed unexpectedly, which might warrant investigation.

What Can Be Monitored

monitored directory path
file and subdirectory counts
directory content listing table
directory state change notifications
per-entry path and mask attributes

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

How to Use in IPNetwork Monitor

Example using numFiles OID:

Select a Host running Net-SNMP agent (directory monitoring extension) 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 numFiles into the Find box to locate it in the OID tree, then select it and click OK. It reports the number of files in monitored directory. 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 an Integer32-type OID, Value bounds is the most useful condition here — trigger an alert if the count changes from its expected baseline, since that would indicate the underlying set of items changed unexpectedly. Click Finish to create the monitor; you can adjust any parameter later.

OIDs

OID symbolic	OID numeric	Type	Access	Description
monitor	1.3.6.1.4.1.8072.7777			monitor MIB
data	1.3.6.1.4.1.8072.7777.1
OCT directory	1.3.6.1.4.1.8072.7777.1.1	OCTET STRING	read-write	Current directory.
I32 numFilesEx	1.3.6.1.4.1.8072.7777.1.2	Integer32	read-only	Number of files in monitored directory.
I32 numDirectories	1.3.6.1.4.1.8072.7777.1.3	Integer32	read-only	Number of directories in monitored directory.
directoryContentTable	1.3.6.1.4.1.8072.7777.1.4		read-only	A table.
directoryContentEntry	1.3.6.1.4.1.8072.7777.1.4.1		read-only	A entry.
I32 directoryEntryIndex	1.3.6.1.4.1.8072.7777.1.4.1.1	Integer32	read-only	Directory entry index.
OCT directoryEntryPath	1.3.6.1.4.1.8072.7777.1.4.1.2	OCTET STRING	read-only	Directory entry path.
I32 directoryEntryMask	1.3.6.1.4.1.8072.7777.1.4.1.3	Integer32	read-only	Directory entry mask.
notifications	1.3.6.1.4.1.8072.7777.2
notificationsPrefix	1.3.6.1.4.1.8072.7777.2.0
NTF directoryStateNotification	1.3.6.1.4.1.8072.7777.2.0.1			Directory state change notification.
notificationsObjects	1.3.6.1.4.1.8072.7777.2.2
OCT directoryState	1.3.6.1.4.1.8072.7777.2.2.1	OCTET STRING	accessible-for-notify	Directory state.

RFC description

Net-SNMP directory monitoring MIB for file system surveillance and notifications.

Start monitoring Host running Net-SNMP agent (directory monitoring extension) 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 DIRECTORY-MONITOR-MIB