OPENBSD-RELAYD-MIB

MIB Reference — IPNetwork Monitor

All MIBsOPENBSD-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.

Imported Objects

From INET-ADDRESS-MIB

InetAddress
InetAddressType

From OPENBSD-BASE-MIB

openBSDMODULE-IDENTITY

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

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

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.

What Can Be Monitored

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

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.

OIDs
OID symbolicOID numericTypeAccessDescription
relaydMIBObjects1.3.6.1.4.1.30155.3The MIB module for gathering relayd status information
relaydInfo1.3.6.1.4.1.30155.3.2
relaydRedirects1.3.6.1.4.1.30155.3.2.1not-accessibleA list of configured redirections
relaydRedirectEntry1.3.6.1.4.1.30155.3.2.1.1not-accessibleAn entry describing a configured redirection
I32 relaydRedirectIndex1.3.6.1.4.1.30155.3.2.1.1.1Integer32read-onlyA unique value, greater than zero, for each redirection
INT relaydRedirectStatus1.3.6.1.4.1.30155.3.2.1.1.2INTEGERread-onlyDenotes whether the redirection is active, administively disabled, down, or configured as a backup
OCT relaydRedirectName1.3.6.1.4.1.30155.3.2.1.1.3OCTET STRINGread-onlyThe name of the redirection
C64 relaydRedirectCnt1.3.6.1.4.1.30155.3.2.1.1.4Counter64read-onlyNumber of packets passed via this redirect
G32 relaydRedirectAvg1.3.6.1.4.1.30155.3.2.1.1.5Gauge32read-onlyAverage number of packets passed via this redirect per statistics interval
G32 relaydRedirectLast1.3.6.1.4.1.30155.3.2.1.1.6Gauge32read-onlyNumber of packets passed via this redirect in the current statistics interval
G32 relaydRedirectAvgHour1.3.6.1.4.1.30155.3.2.1.1.7Gauge32read-onlyAverage number of packets passed via this redirect per hour
G32 relaydRedirectLastHour1.3.6.1.4.1.30155.3.2.1.1.8Gauge32read-onlyNumber of packets passed via this redirect in the previous hour
G32 relaydRedirectAvgDay1.3.6.1.4.1.30155.3.2.1.1.9Gauge32read-onlyAverage number of packets passed via this redirect per day
G32 relaydRedirectLastDay1.3.6.1.4.1.30155.3.2.1.1.10Gauge32read-onlyNumber of packets passed via this redirect in the previous day
relaydRelays1.3.6.1.4.1.30155.3.2.2not-accessibleA list of configured relays
relaydRelayEntry1.3.6.1.4.1.30155.3.2.2.1not-accessibleAn entry describing a configured relay
I32 relaydRelayIndex1.3.6.1.4.1.30155.3.2.2.1.1Integer32read-onlyA unique value, greater than zero, for each relay
INT relaydRelayStatus1.3.6.1.4.1.30155.3.2.2.1.2INTEGERread-onlyIndicates whether the relay is active or administratively disabled
OCT relaydRelayName1.3.6.1.4.1.30155.3.2.2.1.3OCTET STRINGread-onlyThe name of the relay
C64 relaydRelayCnt1.3.6.1.4.1.30155.3.2.2.1.4Counter64read-onlyNumber of packets passed via this relay
G32 relaydRelayAvg1.3.6.1.4.1.30155.3.2.2.1.5Gauge32read-onlyAverage number of packets passed via this relay per statistics interval
G32 relaydRelayLast1.3.6.1.4.1.30155.3.2.2.1.6Gauge32read-onlyNumber of packets passed via this relay in the current statistics interval
G32 relaydRelayAvgHour1.3.6.1.4.1.30155.3.2.2.1.7Gauge32read-onlyAverage number of packets passed via this relay per hour
G32 relaydRelayLastHour1.3.6.1.4.1.30155.3.2.2.1.8Gauge32read-onlyNumber of packets passed via this relay in the previous hour
G32 relaydRelayAvgDay1.3.6.1.4.1.30155.3.2.2.1.9Gauge32read-onlyAverage number of packets passed via this relay per day
G32 relaydRelayLastDay1.3.6.1.4.1.30155.3.2.2.1.10Gauge32read-onlyNumber of packets passed via this relay in the previous day
relaydRouters1.3.6.1.4.1.30155.3.2.3not-accessibleA list of configured routers
relaydRouterEntry1.3.6.1.4.1.30155.3.2.3.1not-accessibleAn entry describing the configured router
I32 relaydRouterIndex1.3.6.1.4.1.30155.3.2.3.1.1Integer32read-onlyA unique value, greater than zero, for each router
I32 relaydRouterTableIndex1.3.6.1.4.1.30155.3.2.3.1.2Integer32read-onlyIndex of the Table entry under relaydTables which corresponds to this Router
INT relaydRouterStatus1.3.6.1.4.1.30155.3.2.3.1.3INTEGERread-onlyIndicates whether the Router is active or administratively disabled
OCT relaydRouterName1.3.6.1.4.1.30155.3.2.3.1.4OCTET STRINGread-onlyName of the Router
OCT relaydRouterLabel1.3.6.1.4.1.30155.3.2.3.1.5OCTET STRINGread-onlyThe PF label, if any, associated with this Router
INT relaydRouterRtable1.3.6.1.4.1.30155.3.2.3.1.6INTEGERread-onlyRtable number associated with this Router
relaydNetRoutes1.3.6.1.4.1.30155.3.2.4not-accessibleA list of configured network routes
relaydNetRouteEntry1.3.6.1.4.1.30155.3.2.4.1not-accessibleAn entry describing the configured network route
I32 relaydNetRouteIndex1.3.6.1.4.1.30155.3.2.4.1.1Integer32read-onlyA unique value, greater than zero, for each NetRoute
IP relaydNetRouteAddr1.3.6.1.4.1.30155.3.2.4.1.2InetAddressread-onlyNetwork address portion of NetRoute
IPt relaydNetRouteAddrType1.3.6.1.4.1.30155.3.2.4.1.3InetAddressTyperead-onlyAddress family of NetRoute
INT relaydNetRoutePrefixLen1.3.6.1.4.1.30155.3.2.4.1.4INTEGERread-onlyLength of address prefix of NetRoute
I32 relaydNetRouteRouterIndex1.3.6.1.4.1.30155.3.2.4.1.5Integer32read-onlyThe index of the Router to which this NetRoute belongs
relaydHosts1.3.6.1.4.1.30155.3.2.5not-accessibleA list of configured Host entries
relaydHostEntry1.3.6.1.4.1.30155.3.2.5.1not-accessibleAn entry describing the configured Host
I32 relaydHostIndex1.3.6.1.4.1.30155.3.2.5.1.1Integer32read-onlyA unique value, greater than zero, for each Host
I32 relaydHostParentIndex1.3.6.1.4.1.30155.3.2.5.1.2Integer32read-onlyIndex of Host, if any, from which up/down state is inherited
I32 relaydHostTableIndex1.3.6.1.4.1.30155.3.2.5.1.3Integer32read-onlyIndex of the Table to which this Host belongs
OCT relaydHostName1.3.6.1.4.1.30155.3.2.5.1.4OCTET STRINGread-onlyName for Host
IP relaydHostAddress1.3.6.1.4.1.30155.3.2.5.1.5InetAddressread-onlyInternet address for Host
IPt relaydHostAddressType1.3.6.1.4.1.30155.3.2.5.1.6InetAddressTyperead-onlyIP address version for Host
INT relaydHostStatus1.3.6.1.4.1.30155.3.2.5.1.7INTEGERread-onlyAvailability of Host
C64 relaydHostCheckCnt1.3.6.1.4.1.30155.3.2.5.1.8Counter64read-onlyNumber of times the status of Host has been checked
C64 relaydHostUpCnt1.3.6.1.4.1.30155.3.2.5.1.9Counter64read-onlyNumber of status checks for Host in which host has been up
INT relaydHostErrno1.3.6.1.4.1.30155.3.2.5.1.10INTEGERread-onlyError number for Host
relaydSessions1.3.6.1.4.1.30155.3.2.6not-accessibleA list of active Sessions
relaydSessionEntry1.3.6.1.4.1.30155.3.2.6.1not-accessibleAn entry describing the active Session
I32 relaydSessionIndex1.3.6.1.4.1.30155.3.2.6.1.1Integer32read-onlyA unique value, greater than zero, for each Session
I32 relaydSessionRelayIndex1.3.6.1.4.1.30155.3.2.6.1.2Integer32read-onlyThe index of the Relay to which this Session belongs
IP relaydSessionInAddr1.3.6.1.4.1.30155.3.2.6.1.3InetAddressread-onlyIncoming address of this Session
IPt relaydSessionInAddrType1.3.6.1.4.1.30155.3.2.6.1.4InetAddressTyperead-onlyIncoming address family of this Session
IP relaydSessionOutAddr1.3.6.1.4.1.30155.3.2.6.1.5InetAddressread-onlyOutgoing address of this Session
IPt relaydSessionOutAddrType1.3.6.1.4.1.30155.3.2.6.1.6InetAddressTyperead-onlyOutgoing address family of this Session
INT relaydSessionPortIn1.3.6.1.4.1.30155.3.2.6.1.7INTEGERread-onlyIncoming port of this Session
INT relaydSessionPortOut1.3.6.1.4.1.30155.3.2.6.1.8INTEGERread-onlyOutgoing port of this Session
TIK relaydSessionAge1.3.6.1.4.1.30155.3.2.6.1.9TimeTicksread-onlyAge of this Session
TIK relaydSessionIdle1.3.6.1.4.1.30155.3.2.6.1.10TimeTicksread-onlyIdle time of this Session
INT relaydSessionStatus1.3.6.1.4.1.30155.3.2.6.1.11INTEGERread-onlyStatus of this Session
INT relaydSessionPid1.3.6.1.4.1.30155.3.2.6.1.12INTEGERread-onlyProcess ID of process which is handling this Session
relaydTables1.3.6.1.4.1.30155.3.2.7not-accessibleA list of configured host tables
relaydTableEntry1.3.6.1.4.1.30155.3.2.7.1not-accessibleAn entry describing the host table
I32 relaydTableIndex1.3.6.1.4.1.30155.3.2.7.1.1Integer32read-onlyA unique value, greater than zero, for each table
OCT relaydTableName1.3.6.1.4.1.30155.3.2.7.1.2OCTET STRINGread-onlyThe name of the table
INT relaydTableStatus1.3.6.1.4.1.30155.3.2.7.1.3INTEGERread-onlyIndicates 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