FREENAS-MIB

All MIBs › FREENAS-MIB

Organization: www.ixsystems.com

Last Updated: 2017-10-27

Category: Device Management, Domain: Server/Host Monitoring, Domain: Storage

Description: FreeNAS/TrueNAS storage appliance MIB providing ZFS pool health, dataset statistics, ARC cache metrics, and storage system status objects.

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 FREENAS-MIB?

FREENAS-MIB is the MIB for FreeNAS/TrueNAS, an open-source ZFS-based storage appliance operating system, placing it in the network-attached storage (NAS) technology area. It exposes ZFS storage-pool management data: pool size, allocation units, used/available capacity, overall health status, and read/write IOPS and byte-throughput counters per pool. It has a direct hardware/software status-monitoring role, since zpoolHealth reveals a pool transitioning to a degraded or faulted state (typically caused by a failing disk), while the read/write counters expose storage performance and load. No dependency on other standard MIBs is evident; it appears to be a self-contained module built around the ZFS subsystem and its own notification objects. It is typically deployed on FreeNAS/TrueNAS-based NAS servers in home-lab, SMB, or enterprise storage environments. Engineers can download the FREENAS-MIB file directly to load it into their MIB browser.

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

FreeNAS/TrueNAS storage appliance/server

Monitoring Examples

An administrator would poll zpoolTable (via zpoolEntry/zpoolIndex) to check zpoolHealth for each pool, watching for a transition away from a healthy state that would indicate a failed or failing disk. Tracking zpoolUsed against zpoolAvailable supports capacity planning, while zpoolReadOps/zpoolWriteOps and zpoolReadBytes reveal I/O load trends useful for spotting performance bottlenecks.

What Can Be Monitored

ZFS pool health status
pool capacity used and available
pool read/write IOPS
pool read throughput (bytes)

Imported Objects

From SNMPv2-SMI

Counter32
Counter64
Gauge32
Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE
enterprises

From SNMPv2-TC

DisplayString
TEXTUAL-CONVENTION

How to Use in IPNetwork Monitor

Example using zfsL2ArcHits OID:

Select a FreeNAS/TrueNAS ZFS storage appliance/server 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 zfsL2ArcHits into the Find box to locate it in the OID tree, then select it and click OK. The number of ZFS L2ARC cache hits. 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
freeNas	1.3.6.1.4.1.50536
zfs	1.3.6.1.4.1.50536.1
zpool	1.3.6.1.4.1.50536.1.1
zpoolTable	1.3.6.1.4.1.50536.1.1.1		not-accessible
zpoolEntry	1.3.6.1.4.1.50536.1.1.1.1		not-accessible
I32 zpoolIndex	1.3.6.1.4.1.50536.1.1.1.1.1	Integer32	not-accessible
STR zpoolDescr	1.3.6.1.4.1.50536.1.1.1.1.2	DisplayString	read-only
I32 zpoolAllocationUnits	1.3.6.1.4.1.50536.1.1.1.1.3	Integer32	read-only
I32 zpoolSize	1.3.6.1.4.1.50536.1.1.1.1.4	Integer32	read-write
I32 zpoolUsed	1.3.6.1.4.1.50536.1.1.1.1.5	Integer32	read-only
I32 zpoolAvailable	1.3.6.1.4.1.50536.1.1.1.1.6	Integer32	read-only
ZPO zpoolHealth	1.3.6.1.4.1.50536.1.1.1.1.7	ZPoolHealthType	read-only	The current health of the containing pool, as reported by zpool status.
C64 zpoolReadOps	1.3.6.1.4.1.50536.1.1.1.1.8	Counter64	read-only	The number of read I/O operations sent to the pool or device, including metadata requests (averaged since system booted).
C64 zpoolWriteOps	1.3.6.1.4.1.50536.1.1.1.1.9	Counter64	read-only	The number of write I/O operations sent to the pool or device (averaged since system booted).
C64 zpoolReadBytes	1.3.6.1.4.1.50536.1.1.1.1.10	Counter64	read-only	The bandwidth of all read operations (including metadata), expressed as units per second (averaged since system booted)
C64 zpoolWriteBytes	1.3.6.1.4.1.50536.1.1.1.1.11	Counter64	read-only	The bandwidth of all write operations, expressed as units per second (averaged since system booted).
C64 zpoolReadOps1sec	1.3.6.1.4.1.50536.1.1.1.1.12	Counter64	read-only	The number of read I/O operations sent to the pool or device, including metadata requests (over 1 second interval).
C64 zpoolWriteOps1sec	1.3.6.1.4.1.50536.1.1.1.1.13	Counter64	read-only	The number of write I/O operations sent to the pool or device (over 1 second interval).
C64 zpoolReadBytes1sec	1.3.6.1.4.1.50536.1.1.1.1.14	Counter64	read-only	The bandwidth of all read operations (including metadata), expressed as units per second (over 1 second interval)
C64 zpoolWriteBytes1sec	1.3.6.1.4.1.50536.1.1.1.1.15	Counter64	read-only	The bandwidth of all write operations, expressed as units per second (over 1 second interval).
dataset	1.3.6.1.4.1.50536.1.2
datasetTable	1.3.6.1.4.1.50536.1.2.1		not-accessible
datasetEntry	1.3.6.1.4.1.50536.1.2.1.1		not-accessible
I32 datasetIndex	1.3.6.1.4.1.50536.1.2.1.1.1	Integer32	not-accessible
STR datasetDescr	1.3.6.1.4.1.50536.1.2.1.1.2	DisplayString	read-only
I32 datasetAllocationUnits	1.3.6.1.4.1.50536.1.2.1.1.3	Integer32	read-only
I32 datasetSize	1.3.6.1.4.1.50536.1.2.1.1.4	Integer32	read-write
I32 datasetUsed	1.3.6.1.4.1.50536.1.2.1.1.5	Integer32	read-only
I32 datasetAvailable	1.3.6.1.4.1.50536.1.2.1.1.6	Integer32	read-only
zvol	1.3.6.1.4.1.50536.1.3
zvolTable	1.3.6.1.4.1.50536.1.3.1		not-accessible
zvolEntry	1.3.6.1.4.1.50536.1.3.1.1		not-accessible
I32 zvolIndex	1.3.6.1.4.1.50536.1.3.1.1.1	Integer32	not-accessible
STR zvolDescr	1.3.6.1.4.1.50536.1.3.1.1.2	DisplayString	read-only
I32 zvolAllocationUnits	1.3.6.1.4.1.50536.1.3.1.1.3	Integer32	read-only
I32 zvolSize	1.3.6.1.4.1.50536.1.3.1.1.4	Integer32	read-write
I32 zvolUsed	1.3.6.1.4.1.50536.1.3.1.1.5	Integer32	read-only
I32 zvolAvailable	1.3.6.1.4.1.50536.1.3.1.1.6	Integer32	read-only
arc	1.3.6.1.4.1.50536.1.4
G32 zfsArcSize	1.3.6.1.4.1.50536.1.4.1	Gauge32	read-only
G32 zfsArcMeta	1.3.6.1.4.1.50536.1.4.2	Gauge32	read-only
G32 zfsArcData	1.3.6.1.4.1.50536.1.4.3	Gauge32	read-only
G32 zfsArcHits	1.3.6.1.4.1.50536.1.4.4	Gauge32	read-only
G32 zfsArcMisses	1.3.6.1.4.1.50536.1.4.5	Gauge32	read-only
G32 zfsArcC	1.3.6.1.4.1.50536.1.4.6	Gauge32	read-only
G32 zfsArcP	1.3.6.1.4.1.50536.1.4.7	Gauge32	read-only
STR zfsArcMissPercent	1.3.6.1.4.1.50536.1.4.8	DisplayString	read-only	Arc Miss Percentage. (Note: Floating precision sent across SNMP as a String
STR zfsArcCacheHitRatio	1.3.6.1.4.1.50536.1.4.9	DisplayString	read-only	Arc Cache Hit Ration Percentage. (Note: Floating precision sent across SNMP as a String
STR zfsArcCacheMissRatio	1.3.6.1.4.1.50536.1.4.10	DisplayString	read-only	Arc Cache Miss Ration Percentage. (Note: Floating precision sent across SNMP as a String
l2arc	1.3.6.1.4.1.50536.1.5
C32 zfsL2ArcHitsEx	1.3.6.1.4.1.50536.1.5.1	Counter32	read-only
C32 zfsL2ArcMisses	1.3.6.1.4.1.50536.1.5.2	Counter32	read-only
C32 zfsL2ArcRead	1.3.6.1.4.1.50536.1.5.3	Counter32	read-only
C32 zfsL2ArcWrite	1.3.6.1.4.1.50536.1.5.4	Counter32	read-only
G32 zfsL2ArcSize	1.3.6.1.4.1.50536.1.5.5	Gauge32	read-only
zil	1.3.6.1.4.1.50536.1.6
C64 zfsZilstatOps1sec	1.3.6.1.4.1.50536.1.6.1	Counter64	read-only	The ops column parsed from the command zilstat 1 1
C64 zfsZilstatOps5sec	1.3.6.1.4.1.50536.1.6.2	Counter64	read-only	The ops column parsed from the command zilstat 5 1
C64 zfsZilstatOps10sec	1.3.6.1.4.1.50536.1.6.3	Counter64	read-only	The ops column parsed from the command zilstat 10 1
notifications	1.3.6.1.4.1.50536.2
notificationPrefix	1.3.6.1.4.1.50536.2.1
NTF alert	1.3.6.1.4.1.50536.2.1.1			An alert raised
NTF alertCancellation	1.3.6.1.4.1.50536.2.1.2			An alert cancelled
notificationObjects	1.3.6.1.4.1.50536.2.2
STR alertId	1.3.6.1.4.1.50536.2.2.1	DisplayString	read-only
ALE alertLevel	1.3.6.1.4.1.50536.2.2.2	AlertLevelType	read-only
STR alertMessage	1.3.6.1.4.1.50536.2.2.3	DisplayString	read-only

RFC description

Monitors FreeNAS ZFS storage pools, datasets, and cache performance including health status and statistics.

Start monitoring FreeNAS/TrueNAS ZFS storage appliance/server 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 FREENAS-MIB