Configuring the Simple Network Management Protocol (SNMP)

RFC 1514 Host resources MIB

The system group

hrSystemUptime: The amount of time since this host was last initialized. Note that this is different from sysUpTime in MIB-II [3] because sysUpTime is the uptime of the network management portion of the system.
hrSystemDate: The host's notion of the local date and time of day.
hrSystemInitialLoadDevice: The index of the hrDeviceEntry for the device from which this host is configured to load its initial operating system configuration.
hrSystemInitialLoadParameters: This object contains the parameters (for example a pathname and parameter) supplied to the load device when requesting the initial operating system configuration from that device.
hrSystemNumUsers: The number of user sessions for which this host is storing state information. A session is a collection of processes requiring a single act of user authentication and possibly subject to collective job control.
hrSystemProcesses: The number of process contexts currently loaded or running on this system.
hrSystemMaxProcesses: The maximum number of process contexts this system can support. If there is no fixed maximum, the value should be zero. On systems that have a fixed maximum, this object can help diagnose failures that occur when this maximum is reached.

The storage group

hrMemorySize: The amount of physical main memory contained by the host.
hrStorageTable: The (conceptual) table of logical storage areas on the host. An entry shall be placed in the storage table for each logical area of storage that is allocated and has fixed resource limits. The amount of storage represented in an entity is the amount actually usable by the requesting entity, and excludes loss due to formatting or file system reference information. These entries are associated with logical storage areas, as might be seen by an application, rather than physical storage entities which are typically seen by an operating system. Storage such as tapes and floppies without file systems on them are typically not allocated in chunks by the operating system to requesting applications, and therefore should not appear in this table. Examples of valid storage for this table include disk partitions, file systems, ram (for some architectures this is further segmented into regular memory, extended memory, and so on), backing store for virtual memory (`swap space'). This table is intended to be a useful diagnostic for `out of memory' and `out of buffers' types of failures. In addition, it can be a useful performance monitoring tool for tracking memory, disk, or buffer usage.
hrStorageEntry: A (conceptual) entry for one logical storage area on the host. As an example, an instance of the hrStorageType object might be named hrStorageType.3
hrStorageIndex: A unique value for each logical storage area contained by the host.
hrStorageType: The type of storage represented by this entry.
hrStorageDescr: A description of the type and instance of the storage described by this entry.
hrStorageAllocationUnits: The size, in bytes, of the data objects allocated from this pool. If this entry is monitoring sectors, blocks, buffers, or packets, for example, this number will commonly be greater than one. Otherwise this number will typically be one.
hrStorageSize: The size of the storage represented by this entry, in units of hrStorageAllocationUnits.
hrStorageUsed: The amount of the storage represented by this entry that is allocated, in units of hrStorageAllocationUnits.
hrStorageAllocationFailures: The number of requests for storage represented by this entry that could not be honored due to not enough storage. It should be noted that because this object has a syntax of Counter, it does not have a defined initial value. However, it is recommended that this object be initialized to zero.

The device group

hrDeviceTable

The (conceptual) table of devices contained by the host.

hrDeviceEntry

A (conceptual) entry for one device contained by the host. As an example, an instance of the hrDeviceType object might be named hrDeviceType.3

hrDeviceIndex

A unique value for each device contained by the host. The value for each device must remain constant at least from one re-initialization of the agent to the next re-initialization.

hrDeviceType

An indication of the type of device. If this value is `hrDeviceProcessor { hrDeviceTypes 3 }' then an entry exists in the hrProcessorTable which corresponds to this device.

If this value is `hrDeviceNetwork { hrDeviceTypes 4 }', then an entry exists in the hrNetworkTable which corresponds to this device.

If this value is `hrDevicePrinter { hrDeviceTypes 5 }', then an entry exists in the hrPrinterTable which corresponds to this device.

If this value is `hrDeviceDiskStorage { hrDeviceTypes 6 }', then an entry exists in the hrDiskStorageTable which corresponds to this device.

hrDeviceDescr

A textual description of this device, including the device's manufacturer and revision, and optionally, its serial number.

hrDeviceID

The product ID for this device.

hrDeviceStatus

The current operational state of the device described by this row of the table. A value unknown(1) indicates that the current state of the device is unknown. running(2) indicates that the device is up and running and that no unusual error conditions are known. The warning(3) state indicates that agent has been informed of an unusual error condition by the operational software (for example, a disk device driver) but that the device is still 'operational'. An example would be high number of soft errors on a disk. A value of testing(4), indicates that the device is not available for use because it is in the testing state. The state of down(5) is used only when the agent has been informed that the device is not available for any use.

hrDeviceErrors

The number of errors detected on this device. It should be noted that as this object has a SYNTAX should be noted that as this object has a SYNTAX of Counter, that it does not have a defined initial value. However, it is recommended that this object be initialized to zero.

hrProcessorTable

The (conceptual) table of processors contained by the host. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDeviceProcessor'.

hrProcessorEntry

A (conceptual) entry for one processor contained by the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrProcessorEntry.

As an example of how objects in this table are named, an instance of the hrProcessorFrwID object might be named hrProcessorFrwID.3

hrProcessorFrwID

The product ID of the firmware associated with the processor.

hrProcessorLoad

The average, over the last minute, of the percentage of time that this processor was not idle.

hrNetworkTable

The (conceptual) table of network devices contained by the host. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDeviceNetwork'.

hrNetworkEntry

A (conceptual) entry for one network device contained by the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrNetworkEntry. As an example of how objects in this table are named, an instance of the hrNetworkIfIndex object might be named hrNetworkIfIndex.3

hrNetworkIfIndex

The value of ifIndex which corresponds to this network device.

hrPrinterTable

The (conceptual) table of printers local to the host. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDevicePrinter'.

hrPrinterEntry

A (conceptual) entry for one printer local to the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrPrinterEntry.

As an example of how objects in this table are named, an instance of the hrPrinterStatus object might be named hrPrinterStatus.3

hrPrinterStatus

The current status of this printer device. When in the idle(1), printing(2), or warmup(3) state, the corresponding hrDeviceStatus should be running(2) or warning(3). When in the unknown state, the corresponding hrDeviceStatus should be unknown(1).

hrPrinterDetectedErrorState

This object represents any error conditions detected by the printer. The error conditions are encoded as bits in an octet string, with the following definitions: lowPaper (0 bit) is a warning(3) condition; noPaper (1 bit) is a down(5) condition; lowToner (2 bit) is a warning(3) condition; noToner (3 bit) is a down(5) condition; doorOpen (4 bit) si a down(5) condition; jammed (5 bit) is a down(5) condition; offline (6 bit) is a down(5) condition; serviceRequested (7 bit) is a warning(3) condition. If multiple conditions are currently detected and the hrDeviceStatus would not otherwise be unknown(1) or testing(4), the hrDeviceStatus shall correspond to the worst state of those indicated, where down(5) is worse than warning(3) which is worse than running(2). Bits are numbered starting with the most significant bit of the first byte being bit 0, the least significant bit of the first byte being bit 7, the most significant bit of the second byte being bit 8, and so on. A one bit encodes that the condition was detected, while a zero bit encodes that the condition was not detected. This object is useful for alerting an operator to specific warning or error conditions that may occur, especially those requiring human intervention.

hrDiskStorageTable

The (conceptual) table of long-term storage devices contained by the host. In particular, disk devices accessed remotely over a network are not included here. Note that this table is potentially sparse: a (conceptual) entry exists only if the correspondent value of the hrDeviceType object is `hrDeviceDiskStorage'.

hrDiskStorageEntry

A (conceptual) entry for one long-term storage device contained by the host. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrDiskStorageEntry. As an example, an instance of the hrDiskStorageCapacity object might be named hrDiskStorageCapacity.3

hrDiskStorageAccess

An indication if this long-term storage device is readable and writable or only readable. This should reflect the media type, any write-protect mechanism, and any device configuration that affects the entire device.

hrDiskStorageMedia

An indication of the type of media used in this long-term storage device (other(1), unknown(2), hardDisk(3), floppyDisk(4), opticalDiskROM(5), opticalDiskWORM(6), opticalDiskRW(7), ramDisk(8)).

hrDiskStorageRemoveble

Denotes whether or not the disk media may be removed from the drive.

hrDiskStorageCapacity

The total size for this long-term storage device.

hrPartitionTable

The (conceptual) table of partitions for long-term storage devices contained by the host. In particular, partitions accessed remotely over a network are not included here.

hrPartitionEntry

A (conceptual) entry for one partition. The hrDeviceIndex in the index represents the entry in the hrDeviceTable that corresponds to the hrPartitionEntry. As an example of how objects in this table are named, an instance of the hrPartitionSize object might be named hrPartitionSize.3.1

hrPartitionIndex

A unique value for each partition on this long- term storage device. The value for each long-term storage device must remain constant at least from one re-initialization of the agent to the next re- initialization.

hrPartitionLabel

A textual description of this partition.

hrPartitionID

A descriptor which uniquely represents this partition to the responsible operating system. On some systems, this might take on a binary representation.

hrPartitionSize

The size of this partition.

hrPartitionFSIndex

The index of the file system mounted on this partition. If no file system is mounted on this partition, then this value shall be zero. Note that multiple partitions may point to one file system, denoting that that file system resides on those partitions. Multiple file systems may not reside on one partition.

hrFSTable

The (conceptual) table of file systems local to this host or remotely mounted from a file server. File systems that are in only one user's environment on a multi-user system will not be included in this table.

hrFSEntry

A (conceptual) entry for one file system local to this host or remotely mounted from a file server. File systems that are in only one user's environment on a multi-user system will not be included in this table.

As an example of how objects in this table are named, an instance of the hrFSMountPoint object might be named hrFSMountPoint.3

hrFSIndex

A unique value for each file system local to this host. The value for each file system must remain constant at least from one re-initialization of the agent to the next re-initialization.

hrFSMountPoint

The path name of the root of this file system.

hrFSRemoteMountPoint

A description of the name and/or address of the server that this file system is mounted from. This may also include parameters such as the mount point on the remote file system. If this is not a remote file system, this string should have a length of zero.

hrFSType

The value of this object identifies the type of this file system.

hrFSAccess

An indication if this file system is logically configured by the operating system to be readable and writable or only readable. This does not represent any local access-control policy, except one that is applied to the file system as a whole. A value of 1 indicates read-write; 2 indicates read-only.

hrFSBootable

A flag indicating whether this file system is bootable.

hrFSStorageIndex

The index of the hrStorageEntry that represents information about this file system. If there is no such information available, then this value shall be zero. The relevant storage entry will be useful in tracking the percent usage of this file system and diagnosing errors that may occur when it runs out of space.

hrFSLastFullBackupDate

The last date at which this complete file system was copied to another storage device for backup. This information is useful for ensuring that backups are being performed regularly. If this information is not known, then this variable shall have the value corresponding to January 1, year 0000, 00:00:00.0, which is encoded as (hex)'00 00 01 01 00 00 00 00'.

hrFSLastPartialBackupDate

The last date at which a portion of this file system was copied to another storage device for backup. This information is useful for ensuring that backups are being performed regularly. If this information is not known, then this variable shall have the value corresponding to January 1, year 0000, 00:00:00.0, which is encoded as (hex)'00 00 01 01 00 00 00 00'.

The running software group

hrSWOSIndex: The value of the hrSWRunIndex for the hrSWRunEntry that represents the primary operating system running on this host. This object is useful for quickly and uniquely identifying that primary operating system.
hrSWRunTable: The (conceptual) table of software running on the host.
hrSWRunEntry: A (conceptual) entry for one piece of software running on the host Note that because the installed software table only contains information for software stored locally on this host, not every piece of running software will be found in the installed software table. This is true of software that was loaded and run from a non-local source, such as a network-mounted file system. As an example of how objects in this table are named, an instance of the hrSWRunName object might be named hrSWRunName.1287
hrSWRunIndex: A unique value for each piece of software running on the host. Wherever possible, this should be the system's native, unique identification number.
hrSWRunName: A textual description of this running piece of software, including the manufacturer, revision, and the name by which it is commonly known. If this software was installed locally, this should be the same string as used in the corresponding hrSWInstalledName.
hrSWRunID: The product ID of this running piece of software.
hrSWRunPath: A description of the location on long-term storage (for example, a disk drive) from which this software was loaded.
hrSWRunParameters: A description of the parameters supplied to this software when it was initially loaded.
hrSWRunType: The type of this software.
hrSWRunStatus: The status of this running piece of software. Setting this value to invalid(4) shall cause this software to stop running and to be unloaded.

The running software performance group

hrSWRunPerfTable: The (conceptual) table of running software performance metrics.
hrSWRunPerfEntry: A (conceptual) entry containing software performance metrics. As an example, an instance of the hrSWRunPerfCPU object might be named hrSWRunPerfCPU.1287
hrSWRunPerfCPU: The number of centi-seconds of the total system's CPU resources consumed by this process. Note that on a multi-processor system, this value may increment by more than one centi-second in one centi-second of real (wall clock) time.
hrSWRunPerfMem: The total amount of real system memory allocated to this process.

The installed software group

hrSWInstalledLastChange: The value of sysUpTime when an entry in the hrSWInstalledTable was last added, renamed, or deleted. Because this table is likely to contain many entries, polling of this object allows a management station to determine when re-downloading of the table might be useful.
hrSWInstalledLastUpdateTime: The value of sysUpTime when the hrSWInstalledTable was last completely updated. Because caching of this data will be a popular implementation strategy, retrieval of this object allows a management station to obtain a guarantee that no data in this table is older than the indicated time.
hrSWInstalledTable: The (conceptual) table of software installed on this host.
hrSWInstalledEntry: A (conceptual) entry for a piece of software installed on this host. As an example of how objects in this table are named, an instance of the hrSWInstalledName object might be named hrSWInstalledName.96
hrSWInstalledIndex: A unique value for each piece of software installed on the host. This value shall be in the range from 1 to the number of pieces of software installed on the host.
hrSWInstalledName: A textual description of this installed piece of software, including the manufacturer, revision, the name by which it is commonly known, and optionally, its serial number.
hrSWInstalledID: The product ID of this installed piece of software.
hrSWInstalledType: The type of this software (unknown(1), operatingSystem(2), deviceDriver(3), application(4)).
hrSWInstalledDate: The last-modification date of this application as it would appear in a directory listing.