OPENBSD-RELAYD-MIB

All MIBs › OPENBSD-RELAYD-MIB

Organization: OpenBSD

Last Updated: 2015-10-15

Category: Operating Systems

Description: Monitors relayd load balancer service health, relay session counts, and redirection status on OpenBSD hosts.

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 OPENBSD-RELAYD-MIB?

OPENBSD-RELAYD-MIB is an OpenBSD-specific SNMP module that exposes status and statistics from relayd, OpenBSD's built-in load balancer and relay/redirection daemon. It provides data on configured redirects, including per-redirect status, connection counts, and traffic averages/totals over recent, hourly, and daily windows. Its monitoring emphasis is on software service health: whether the relayd process and its redirects are active and healthy (relaydRedirectStatus), and whether traffic volumes and averages are within expected ranges, which can reveal an overloaded backend or a redirect that has silently stopped forwarding traffic. As an OpenBSD-native daemon MIB it has no dependency on external vendor MIBs, though it is typically monitored alongside general host and network interface MIBs on the same system. It is deployed on OpenBSD systems configured as load balancers or reverse proxies in front of application server pools. Engineers can download the OPENBSD-RELAYD-MIB file directly to load it into their MIB browser.

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

OpenBSD load balancer/relay host

Monitoring Examples

An admin would check relaydRedirectStatus for each entry in relaydRedirects to confirm a redirect is up, then review relaydRedirectCnt and relaydRedirectAvg to gauge current connection volume and average load. Comparing relaydRedirectAvgHour/relaydRedirectLastHour against relaydRedirectAvgDay/relaydRedirectLastDay would reveal whether traffic to a backend pool has spiked or dropped off relative to its normal daily pattern. A redirect showing status down or a sudden drop in relaydRedirectCnt would indicate the load balancer has stopped sending traffic to that service, often signaling a backend health-check failure.

What Can Be Monitored

relayd redirect status
current and average connection counts
hourly traffic averages
daily traffic averages
relayd service info

Imported Objects

From INET-ADDRESS-MIB

InetAddress
InetAddressType

From OPENBSD-BASE-MIB

openBSD

MODULE-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

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

How to Use in IPNetwork Monitor

Example using relaydRedirectCnt OID:

Select an OpenBSD load balancer/relay host (relayd status) 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 relaydRedirectCnt 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 number of packets passed via this redirect. 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
IP relaydHostAddress	1.3.6.1.4.1.30155.3.2.5.1.5	InetAddress	read-only	Internet address for Host
IPt relaydHostAddressType	1.3.6.1.4.1.30155.3.2.5.1.6	InetAddressType	read-only	IP address version for Host
C64 relaydHostCheckCnt	1.3.6.1.4.1.30155.3.2.5.1.8	Counter64	read-only	Number of times the status of Host has been checked
relaydHostEntry	1.3.6.1.4.1.30155.3.2.5.1		not-accessible	An entry describing the configured Host
INT relaydHostErrno	1.3.6.1.4.1.30155.3.2.5.1.10	INTEGER	read-only	Error number for Host
I32 relaydHostIndex	1.3.6.1.4.1.30155.3.2.5.1.1	Integer32	read-only	A unique value, greater than zero, for each Host
OCT relaydHostName	1.3.6.1.4.1.30155.3.2.5.1.4	OCTET STRING	read-only	Name for Host
I32 relaydHostParentIndex	1.3.6.1.4.1.30155.3.2.5.1.2	Integer32	read-only	Index of Host, if any, from which up/down state is inherited
relaydHosts	1.3.6.1.4.1.30155.3.2.5		not-accessible	A list of configured Host entries
INT relaydHostStatus	1.3.6.1.4.1.30155.3.2.5.1.7	INTEGER	read-only	Availability of Host
I32 relaydHostTableIndex	1.3.6.1.4.1.30155.3.2.5.1.3	Integer32	read-only	Index of the Table to which this Host belongs
C64 relaydHostUpCnt	1.3.6.1.4.1.30155.3.2.5.1.9	Counter64	read-only	Number of status checks for Host in which host has been up
relaydInfo	1.3.6.1.4.1.30155.3.2
relaydMIBObjects	1.3.6.1.4.1.30155.3			The MIB module for gathering relayd status information
IP relaydNetRouteAddr	1.3.6.1.4.1.30155.3.2.4.1.2	InetAddress	read-only	Network address portion of NetRoute
IPt relaydNetRouteAddrType	1.3.6.1.4.1.30155.3.2.4.1.3	InetAddressType	read-only	Address family of NetRoute
relaydNetRouteEntry	1.3.6.1.4.1.30155.3.2.4.1		not-accessible	An entry describing the configured network route
I32 relaydNetRouteIndex	1.3.6.1.4.1.30155.3.2.4.1.1	Integer32	read-only	A unique value, greater than zero, for each NetRoute
INT relaydNetRoutePrefixLen	1.3.6.1.4.1.30155.3.2.4.1.4	INTEGER	read-only	Length of address prefix of NetRoute
I32 relaydNetRouteRouterIndex	1.3.6.1.4.1.30155.3.2.4.1.5	Integer32	read-only	The index of the Router to which this NetRoute belongs
relaydNetRoutes	1.3.6.1.4.1.30155.3.2.4		not-accessible	A list of configured network routes
G32 relaydRedirectAvg	1.3.6.1.4.1.30155.3.2.1.1.5	Gauge32	read-only	Average number of packets passed via this redirect per statistics interval
G32 relaydRedirectAvgDay	1.3.6.1.4.1.30155.3.2.1.1.9	Gauge32	read-only	Average number of packets passed via this redirect per day
G32 relaydRedirectAvgHour	1.3.6.1.4.1.30155.3.2.1.1.7	Gauge32	read-only	Average number of packets passed via this redirect per hour
C64 relaydRedirectCntEx	1.3.6.1.4.1.30155.3.2.1.1.4	Counter64	read-only	Number of packets passed via this redirect
relaydRedirectEntry	1.3.6.1.4.1.30155.3.2.1.1		not-accessible	An entry describing a configured redirection
I32 relaydRedirectIndex	1.3.6.1.4.1.30155.3.2.1.1.1	Integer32	read-only	A unique value, greater than zero, for each redirection
G32 relaydRedirectLast	1.3.6.1.4.1.30155.3.2.1.1.6	Gauge32	read-only	Number of packets passed via this redirect in the current statistics interval
G32 relaydRedirectLastDay	1.3.6.1.4.1.30155.3.2.1.1.10	Gauge32	read-only	Number of packets passed via this redirect in the previous day
G32 relaydRedirectLastHour	1.3.6.1.4.1.30155.3.2.1.1.8	Gauge32	read-only	Number of packets passed via this redirect in the previous hour
OCT relaydRedirectName	1.3.6.1.4.1.30155.3.2.1.1.3	OCTET STRING	read-only	The name of the redirection
relaydRedirects	1.3.6.1.4.1.30155.3.2.1		not-accessible	A list of configured redirections
INT relaydRedirectStatus	1.3.6.1.4.1.30155.3.2.1.1.2	INTEGER	read-only	Denotes whether the redirection is active, administively disabled, down, or configured as a backup
G32 relaydRelayAvg	1.3.6.1.4.1.30155.3.2.2.1.5	Gauge32	read-only	Average number of packets passed via this relay per statistics interval
G32 relaydRelayAvgDay	1.3.6.1.4.1.30155.3.2.2.1.9	Gauge32	read-only	Average number of packets passed via this relay per day
G32 relaydRelayAvgHour	1.3.6.1.4.1.30155.3.2.2.1.7	Gauge32	read-only	Average number of packets passed via this relay per hour
C64 relaydRelayCnt	1.3.6.1.4.1.30155.3.2.2.1.4	Counter64	read-only	Number of packets passed via this relay
relaydRelayEntry	1.3.6.1.4.1.30155.3.2.2.1		not-accessible	An entry describing a configured relay
I32 relaydRelayIndex	1.3.6.1.4.1.30155.3.2.2.1.1	Integer32	read-only	A unique value, greater than zero, for each relay
G32 relaydRelayLast	1.3.6.1.4.1.30155.3.2.2.1.6	Gauge32	read-only	Number of packets passed via this relay in the current statistics interval
G32 relaydRelayLastDay	1.3.6.1.4.1.30155.3.2.2.1.10	Gauge32	read-only	Number of packets passed via this relay in the previous day
G32 relaydRelayLastHour	1.3.6.1.4.1.30155.3.2.2.1.8	Gauge32	read-only	Number of packets passed via this relay in the previous hour
OCT relaydRelayName	1.3.6.1.4.1.30155.3.2.2.1.3	OCTET STRING	read-only	The name of the relay
relaydRelays	1.3.6.1.4.1.30155.3.2.2		not-accessible	A list of configured relays
INT relaydRelayStatus	1.3.6.1.4.1.30155.3.2.2.1.2	INTEGER	read-only	Indicates whether the relay is active or administratively disabled
relaydRouterEntry	1.3.6.1.4.1.30155.3.2.3.1		not-accessible	An entry describing the configured router
I32 relaydRouterIndex	1.3.6.1.4.1.30155.3.2.3.1.1	Integer32	read-only	A unique value, greater than zero, for each router
OCT relaydRouterLabel	1.3.6.1.4.1.30155.3.2.3.1.5	OCTET STRING	read-only	The PF label, if any, associated with this Router
OCT relaydRouterName	1.3.6.1.4.1.30155.3.2.3.1.4	OCTET STRING	read-only	Name of the Router
INT relaydRouterRtable	1.3.6.1.4.1.30155.3.2.3.1.6	INTEGER	read-only	Rtable number associated with this Router
relaydRouters	1.3.6.1.4.1.30155.3.2.3		not-accessible	A list of configured routers
INT relaydRouterStatus	1.3.6.1.4.1.30155.3.2.3.1.3	INTEGER	read-only	Indicates whether the Router is active or administratively disabled
I32 relaydRouterTableIndex	1.3.6.1.4.1.30155.3.2.3.1.2	Integer32	read-only	Index of the Table entry under relaydTables which corresponds to this Router
TIK relaydSessionAge	1.3.6.1.4.1.30155.3.2.6.1.9	TimeTicks	read-only	Age of this Session
relaydSessionEntry	1.3.6.1.4.1.30155.3.2.6.1		not-accessible	An entry describing the active Session
TIK relaydSessionIdle	1.3.6.1.4.1.30155.3.2.6.1.10	TimeTicks	read-only	Idle time of this Session
IP relaydSessionInAddr	1.3.6.1.4.1.30155.3.2.6.1.3	InetAddress	read-only	Incoming address of this Session
IPt relaydSessionInAddrType	1.3.6.1.4.1.30155.3.2.6.1.4	InetAddressType	read-only	Incoming address family of this Session
I32 relaydSessionIndex	1.3.6.1.4.1.30155.3.2.6.1.1	Integer32	read-only	A unique value, greater than zero, for each Session
IP relaydSessionOutAddr	1.3.6.1.4.1.30155.3.2.6.1.5	InetAddress	read-only	Outgoing address of this Session
IPt relaydSessionOutAddrType	1.3.6.1.4.1.30155.3.2.6.1.6	InetAddressType	read-only	Outgoing address family of this Session
INT relaydSessionPid	1.3.6.1.4.1.30155.3.2.6.1.12	INTEGER	read-only	Process ID of process which is handling this Session
INT relaydSessionPortIn	1.3.6.1.4.1.30155.3.2.6.1.7	INTEGER	read-only	Incoming port of this Session
INT relaydSessionPortOut	1.3.6.1.4.1.30155.3.2.6.1.8	INTEGER	read-only	Outgoing port of this Session
I32 relaydSessionRelayIndex	1.3.6.1.4.1.30155.3.2.6.1.2	Integer32	read-only	The index of the Relay to which this Session belongs
relaydSessions	1.3.6.1.4.1.30155.3.2.6		not-accessible	A list of active Sessions
INT relaydSessionStatus	1.3.6.1.4.1.30155.3.2.6.1.11	INTEGER	read-only	Status of this Session
relaydTableEntry	1.3.6.1.4.1.30155.3.2.7.1		not-accessible	An entry describing the host table
I32 relaydTableIndex	1.3.6.1.4.1.30155.3.2.7.1.1	Integer32	read-only	A unique value, greater than zero, for each table
OCT relaydTableName	1.3.6.1.4.1.30155.3.2.7.1.2	OCTET STRING	read-only	The name of the table
relaydTables	1.3.6.1.4.1.30155.3.2.7		not-accessible	A list of configured host tables
INT relaydTableStatus	1.3.6.1.4.1.30155.3.2.7.1.3	INTEGER	read-only	Indicates the state of use of the table

RFC description

OpenBSD relayd load balancer MIB monitoring redirections, relay sessions, and performance statistics.

Start monitoring OpenBSD load balancer/relay host (relayd 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.

Download OPENBSD-RELAYD-MIB