BEGEMOT-HAST-MIB

All MIBs › BEGEMOT-HAST-MIB

Organization: FreeBSD

Last Updated: 2013-04-13

Category: Net-SNMP and Linux

Description: Monitors FreeBSD HAST (Highly Available Storage) block device replication status and error counters.

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

BEGEMOT-HAST-MIB is a FreeBSD-project (Begemot enterprise namespace) MIB for HAST, FreeBSD's Highly Available Storage block-device replication framework. It exposes configuration data for each replicated resource -- its name, local device path, provider name, and remote replication peer address -- alongside status data such as the resource's current role. Its monitoring value centers on storage/disk subsystem health: the resource role (primary/secondary) and remote-address reachability reveal whether replication is functioning correctly or whether a split-brain or failover condition has occurred. It is part of FreeBSD's Begemot enterprise MIB family alongside other Begemot-prefixed modules, without a direct IETF standard dependency. It is typically deployed on pairs of FreeBSD servers built into storage clusters or NAS-like redundant setups using HAST for block-level replication, often alongside CARP or ZFS, and a BEGEMOT-HAST-MIB download is commonly bundled with FreeBSD's Begemot MIB collection for import into monitoring tools.

IPNetwork Monitor allows you to monitor SNMP objects defined in BEGEMOT-HAST-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 servers running HAST storage replication
FreeBSD-based storage/NAS clusters

Monitoring Examples

hastResourceTable/hastResourceEntry rows, indexed by hastResourceIndex, expose hastResourceName, hastResourceRole, hastResourceLocalPath, and hastResourceRemoteAddr for each replicated resource. An administrator would poll hastResourceRole to confirm a given resource is in its expected primary or secondary role and check hastResourceRemoteAddr connectivity to ensure the replication peer is reachable. An unexpected role flip or an unreachable remote address would reveal a failover event or a broken replication link needing attention.

What Can Be Monitored

resource replication role (primary/secondary)
local device path
remote/source replication peer address
extent size configuration
dirty-region tracking (keepDirty)

Imported Objects

From BEGEMOT-MIB

begemot

MODULE-IDENTITY

From IF-MIB

InterfaceIndex
ifIndex	OBJECT-TYPE

From SNMPv2-SMI

Counter64
Integer32
MODULE-IDENTITY
NOTIFICATION-TYPE
OBJECT-TYPE

From SNMPv2-TC

RowStatus
TEXTUAL-CONVENTION

How to Use in IPNetwork Monitor

Example using hastResourceDirty 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 hastResourceDirty into the Find box to locate it in the OID tree, selecting the specific row/instance you want to monitor since this is a table column, then select it and click OK. It reports the current number of dirty extents for the resource. 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 Counter64-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
begemotHast	1.3.6.1.4.1.12325.1.220			The Begemot MIB for managing HAST.
begemotHastObjects	1.3.6.1.4.1.12325.1.220.1
hastConfig	1.3.6.1.4.1.12325.1.220.1.1
OCT hastConfigFile	1.3.6.1.4.1.12325.1.220.1.1.1	OCTET STRING	read-only	HAST configuration file location.
hastResourceTable	1.3.6.1.4.1.12325.1.220.1.2		not-accessible	A table containing information about all HAST resources.
hastResourceEntry	1.3.6.1.4.1.12325.1.220.1.2.1		not-accessible	Table entry that describes one HAST resource.
I32 hastResourceIndex	1.3.6.1.4.1.12325.1.220.1.2.1.1	Integer32	read-only	Resource index.
OCT hastResourceName	1.3.6.1.4.1.12325.1.220.1.2.1.2	OCTET STRING	read-only	Resource name.
INT hastResourceRole	1.3.6.1.4.1.12325.1.220.1.2.1.3	INTEGER	read-write	Resource role.
OCT hastResourceProvName	1.3.6.1.4.1.12325.1.220.1.2.1.4	OCTET STRING	read-only	Resource GEOM provider name that appears as /dev/hast/.
OCT hastResourceLocalPath	1.3.6.1.4.1.12325.1.220.1.2.1.5	OCTET STRING	read-only	Path to the local component which is used as a backend provider for the resource.
I32 hastResourceExtentSize	1.3.6.1.4.1.12325.1.220.1.2.1.6	Integer32	read-only	Size of an extent. Extent is a block which is used for synchronization. hastd(8) maintains a map of dirty extents and extent is the smallest region that can be marked as dirty. If any part of an extent is modified, entire extent will be synchronized when nodes connect.
I32 hastResourceKeepDirty	1.3.6.1.4.1.12325.1.220.1.2.1.7	Integer32	read-only	Maximum number of dirty extents to keep dirty all the time. Most recently used extents are kept dirty to reduce number of metadata updates.
OCT hastResourceRemoteAddr	1.3.6.1.4.1.12325.1.220.1.2.1.8	OCTET STRING	read-only	Address of the remote hastd(8) daemon for the resource.
OCT hastResourceSourceAddr	1.3.6.1.4.1.12325.1.220.1.2.1.9	OCTET STRING	read-only	Local address the resource is bound to.
INT hastResourceReplication	1.3.6.1.4.1.12325.1.220.1.2.1.10	INTEGER	read-only	Resource replication mode.
INT hastResourceStatus	1.3.6.1.4.1.12325.1.220.1.2.1.11	INTEGER	read-only	Resource replication status.
C64 hastResourceDirtyEx	1.3.6.1.4.1.12325.1.220.1.2.1.12	Counter64	read-only	Current number of dirty extents for the resource.
C64 hastResourceReads	1.3.6.1.4.1.12325.1.220.1.2.1.13	Counter64	read-only	Count of resource local read operations.
C64 hastResourceWrites	1.3.6.1.4.1.12325.1.220.1.2.1.14	Counter64	read-only	Count of resource local write operations.
C64 hastResourceDeletes	1.3.6.1.4.1.12325.1.220.1.2.1.15	Counter64	read-only	Count of resource local delete operations.
C64 hastResourceFlushes	1.3.6.1.4.1.12325.1.220.1.2.1.16	Counter64	read-only	Count of resource local flush operations.
C64 hastResourceActivemapUpdates	1.3.6.1.4.1.12325.1.220.1.2.1.17	Counter64	read-only	Count of resource local activemap updates.
C64 hastResourceReadErrors	1.3.6.1.4.1.12325.1.220.1.2.1.18	Counter64	read-only	Count of resource local read operations that failed.
C64 hastResourceWriteErrors	1.3.6.1.4.1.12325.1.220.1.2.1.19	Counter64	read-only	Count of resource local write operations that failed.
C64 hastResourceDeleteErrors	1.3.6.1.4.1.12325.1.220.1.2.1.20	Counter64	read-only	Count of resource local delete operations that failed.
C64 hastResourceFlushErrors	1.3.6.1.4.1.12325.1.220.1.2.1.21	Counter64	read-only	Count of resource local flush operations that failed.
INT hastResourceWorkerPid	1.3.6.1.4.1.12325.1.220.1.2.1.22	INTEGER	read-only	Worker process ID.
U32 hastResourceLocalQueue	1.3.6.1.4.1.12325.1.220.1.2.1.23	UNSIGNED32	read-only	Number of outstanding I/O requests to the local component.
U32 hastResourceSendQueue	1.3.6.1.4.1.12325.1.220.1.2.1.24	UNSIGNED32	read-only	Number of outstanding I/O requests to send to the remote component.
U32 hastResourceRecvQueue	1.3.6.1.4.1.12325.1.220.1.2.1.25	UNSIGNED32	read-only	Number of outstanding I/O requests waiting for response from the remote component.
U32 hastResourceDoneQueue	1.3.6.1.4.1.12325.1.220.1.2.1.26	UNSIGNED32	read-only	Number of processed I/O requests to return to the kernel.
U32 hastResourceIdleQueue	1.3.6.1.4.1.12325.1.220.1.2.1.27	UNSIGNED32	read-only	Number of request objects in the free bucket.

RFC description

Manages FreeBSD Highly Available STorage (HAST) replication and resource monitoring.

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-HAST-MIB