SNMP MIB Files and Supported OIDs

Prev Next

This article provides the Cato Socket MIB file and a reference to the supported SNMP objects. A Management Information Base (MIB) defines the names, data types, and meanings of objects identified by an Object Identifier (OID).

For prerequisites, polling addresses, and configuration instructions, see Configuring SNMP Monitoring for Sockets and App Connectors.

MIB Files

Your SNMP monitoring platform may already include the standard MIBs listed below. Import the Cato private MIB to display readable names and definitions for Cato-specific objects.

MIB File or RFC

Description

CATO-SOCKET-MIB.mib

Cato private enterprise MIB under 1.3.6.1.4.1.64366. Defines Socket-specific operational data, including device identity, hardware and software versions, HA role and health, interface state and mapping, and tunnel/PoP status and MTU information.

SNMPv2-MIB / System Group — RFC 3418

System information, SNMP agent uptime, and registered MIB capabilities.

IF-MIB / Interfaces Group — RFC 2863

Interface information, status, traffic counters, and IF-MIB extensions, including high-capacity counters.

MIB-II IPv4 Address Table — RFC 1213

Interface IPv4 addresses, subnet masks, and related address information.

HOST-RESOURCES-MIB — RFC 2790

Per-core CPU load and physical RAM information.

Downloading and Importing the Cato MIB

  1. Download the CATO-SOCKET-MIB.mib file attached to this article.

  2. Import the file into your SNMP monitoring platform using its MIB import procedure. Ensure that any standard MIBs required by the file are available in the platform.

Supported Monitoring Data

The following MIB areas provide the supported monitoring data. Support applies to the objects listed below and does not imply support for every object in each MIB.

MIB Area

OID Root

Available Information

System

1.3.6.1.2.1.1

Device identity and location, SNMP agent uptime, and registered MIB capabilities.

Interfaces

1.3.6.1.2.1.2

LAN/WAN interface details, status, MTU, speed, and traffic counters.

IPv4 Addresses

1.3.6.1.2.1.4.20.1

Interface IPv4 addresses, subnet masks, and related address information.

Host Resources

1.3.6.1.2.1.25

Per-core CPU load and physical RAM information.

IF-MIB Extensions

1.3.6.1.2.1.31.1.1.1

Interface names and aliases, high-capacity byte and packet counters, and additional interface properties.

Cato Private MIB

1.3.6.1.4.1.64366

Socket identity and health, interface details, and tunnel/PoP information.

Reading the OID Reference

An OID ending in .0 identifies a scalar value. Table entries use an index suffix. Replace the placeholders below with the instance returned by the agent; the angle brackets are not part of the numeric OID.

  • <row>: row in the registered-capabilities table.

  • <if>: interface instance in the relevant table.

  • <ip>: IPv4 address expressed as a dotted numeric suffix.

  • <cpu>: processor instance.

  • <tunnel>: tunnel instance.

Use an SNMP walk to discover the available table instances. Index objects identify rows; they are not necessarily independently readable values. The physical RAM entries below use the specific row index 1.

System

Device information, SNMP agent uptime, and registered MIB capabilities.

Object

OID

Available Information

sysDescr

1.3.6.1.2.1.1.1.0

Device description, including platform and software information.

sysObjectID

1.3.6.1.2.1.1.2.0

Vendor or device-type object identifier.

sysUpTime

1.3.6.1.2.1.1.3.0

Time since the SNMP agent was initialized, in hundredths of a second.

sysContact

1.3.6.1.2.1.1.4.0

Administrative contact information.

sysName

1.3.6.1.2.1.1.5.0

Device name; maps to the site name.

sysLocation

1.3.6.1.2.1.1.6.0

Device location; maps to the site address.

sysServices

1.3.6.1.2.1.1.7.0

Network service layers supported by the device.

sysORLastChange

1.3.6.1.2.1.1.8.0

Value of sysUpTime when the registered-capabilities table last changed.

sysORIndex

1.3.6.1.2.1.1.9.1.1.<row>

Row identifier in the registered-capabilities table.

sysORID

1.3.6.1.2.1.1.9.1.2.<row>

Object identifier for a registered MIB capability.

sysORDescr

1.3.6.1.2.1.1.9.1.3.<row>

Description of the registered capability.

sysORUpTime

1.3.6.1.2.1.1.9.1.4.<row>

Value of sysUpTime when the capability row was registered.

Uptime: sysUpTime.0 measures SNMP agent uptime, which can reset when the agent restarts without a Socket reboot. The standard object intended to report Socket boot uptime, hrSystemUptime.0 (1.3.6.1.2.1.25.1.1.0), is currently unavailable because of a known issue and is not included in the supported-object list.

Interfaces

Standard interface information and traffic counters for the exposed LAN/WAN interfaces.

Object

OID

Available Information

ifNumber

1.3.6.1.2.1.2.1.0

Number of interfaces exposed through SNMP.

ifIndex

1.3.6.1.2.1.2.2.1.1.<if>

Interface identifier.

ifDescr

1.3.6.1.2.1.2.2.1.2.<if>

Interface description.

ifType

1.3.6.1.2.1.2.2.1.3.<if>

Interface type.

ifMtu

1.3.6.1.2.1.2.2.1.4.<if>

Maximum packet size for the interface, in bytes.

ifSpeed

1.3.6.1.2.1.2.2.1.5.<if>

Reported interface speed, in bits per second.

ifPhysAddress

1.3.6.1.2.1.2.2.1.6.<if>

Interface physical address, such as its MAC address.

ifAdminStatus

1.3.6.1.2.1.2.2.1.7.<if>

Configured administrative state.

ifOperStatus

1.3.6.1.2.1.2.2.1.8.<if>

Current operational state.

ifLastChange

1.3.6.1.2.1.2.2.1.9.<if>

Value of sysUpTime at the latest operational-state change.

ifInOctets

1.3.6.1.2.1.2.2.1.10.<if>

Received bytes, as a 32-bit counter.

ifInUcastPkts

1.3.6.1.2.1.2.2.1.11.<if>

Received unicast packets.

ifInNUcastPkts

1.3.6.1.2.1.2.2.1.12.<if>

Received multicast and broadcast packets.

ifInDiscards

1.3.6.1.2.1.2.2.1.13.<if>

Received packets discarded without errors.

ifInErrors

1.3.6.1.2.1.2.2.1.14.<if>

Received packets containing errors.

ifInUnknownProtos

1.3.6.1.2.1.2.2.1.15.<if>

Received packets discarded because of an unknown or unsupported protocol.

ifOutOctets

1.3.6.1.2.1.2.2.1.16.<if>

Transmitted bytes, as a 32-bit counter.

ifOutUcastPkts

1.3.6.1.2.1.2.2.1.17.<if>

Outbound unicast packet requests.

ifOutNUcastPkts

1.3.6.1.2.1.2.2.1.18.<if>

Outbound multicast and broadcast packet requests.

ifOutDiscards

1.3.6.1.2.1.2.2.1.19.<if>

Outbound packets discarded without errors.

ifOutErrors

1.3.6.1.2.1.2.2.1.20.<if>

Outbound packets not transmitted because of errors.

ifOutQLen

1.3.6.1.2.1.2.2.1.21.<if>

Output queue length, in packets.

ifSpecific

1.3.6.1.2.1.2.2.1.22.<if>

Reference to interface media-specific MIB definitions.

IPv4 Addresses

IPv4 address information for the exposed interfaces.

Object

OID

Available Information

ipAdEntAddr

1.3.6.1.2.1.4.20.1.1.<ip>

Interface IPv4 address.

ipAdEntIfIndex

1.3.6.1.2.1.4.20.1.2.<ip>

Interface index associated with this IPv4 address.

ipAdEntNetMask

1.3.6.1.2.1.4.20.1.3.<ip>

Subnet mask for this IPv4 address.

ipAdEntBcastAddr

1.3.6.1.2.1.4.20.1.4.<ip>

Least significant bit of the interface broadcast address.

ipAdEntReasmMaxSize

1.3.6.1.2.1.4.20.1.5.<ip>

Maximum IP datagram reassembly size for the interface, in bytes.

Host Resources

Per-core CPU load and physical RAM information. The listed storage objects describe RAM; they do not add disk or process monitoring.

Object

OID

Available Information

hrProcessorLoad

1.3.6.1.2.1.25.3.3.1.2.<cpu>

Per-core CPU utilization, averaged over approximately the preceding minute.

hrMemorySize

1.3.6.1.2.1.25.2.2.0

Total physical RAM, in KB.

hrStorageIndex

1.3.6.1.2.1.25.2.3.1.1.1

Storage row identifier; row 1 represents physical RAM.

hrStorageType

1.3.6.1.2.1.25.2.3.1.2.1

Storage type for the physical RAM row.

hrStorageDescr

1.3.6.1.2.1.25.2.3.1.3.1

Description of the physical RAM row.

hrStorageAllocationUnits

1.3.6.1.2.1.25.2.3.1.4.1

Number of bytes in one allocation unit.

hrStorageSize

1.3.6.1.2.1.25.2.3.1.5.1

Total RAM size, in allocation units.

hrStorageUsed

1.3.6.1.2.1.25.2.3.1.6.1

Used RAM, in allocation units.

hrStorageAllocationFailures

1.3.6.1.2.1.25.2.3.1.7.1

Allocation requests that failed because of insufficient storage.

For the RAM row, calculate memory utilization as hrStorageUsed / hrStorageSize × 100. To convert the total or used size to bytes, multiply it by hrStorageAllocationUnits.

IF-MIB Extensions

Additional interface identifiers, properties, and 64-bit traffic counters.

Object

OID

Available Information

ifName

1.3.6.1.2.1.31.1.1.1.1.<if>

Interface name.

ifHCInOctets

1.3.6.1.2.1.31.1.1.1.6.<if>

Received bytes, as a 64-bit counter.

ifHCInUcastPkts

1.3.6.1.2.1.31.1.1.1.7.<if>

Received unicast packets, as a 64-bit counter.

ifHCOutOctets

1.3.6.1.2.1.31.1.1.1.10.<if>

Transmitted bytes, as a 64-bit counter.

ifHCOutUcastPkts

1.3.6.1.2.1.31.1.1.1.11.<if>

Outbound unicast packet requests, as a 64-bit counter.

ifHighSpeed

1.3.6.1.2.1.31.1.1.1.15.<if>

Reported interface speed, in millions of bits per second (Mbps).

ifPromiscuousMode

1.3.6.1.2.1.31.1.1.1.16.<if>

Reported promiscuous-mode state.

ifConnectorPresent

1.3.6.1.2.1.31.1.1.1.17.<if>

Whether the interface has a physical connector.

ifAlias

1.3.6.1.2.1.31.1.1.1.18.<if>

Interface alias or descriptive label.

Use the 64-bit byte counters for traffic-rate calculations where your monitoring platform supports them. The speed objects describe reported interface bandwidth, not measured traffic throughput: ifSpeed uses bits per second, while ifHighSpeed uses Mbps. All listed objects are available through Cato's read-only polling implementation; their presence does not enable SNMP SET operations.

Cato Private MIB

The Cato private MIB under 1.3.6.1.4.1.64366 exposes Socket-specific identity, health, interface, and tunnel information.

Socket Identity and Status

Object

OID

Available Information

socketModel

1.3.6.1.4.1.64366.1.1.1.0

Socket model.

socketHardwareRev

1.3.6.1.4.1.64366.1.1.2.0

Socket hardware revision.

socketSerial

1.3.6.1.4.1.64366.1.1.3.0

Socket serial number.

socketFirmwareVersion

1.3.6.1.4.1.64366.1.1.4.0

Socket firmware version.

socketBuildRevision

1.3.6.1.4.1.64366.1.1.5.0

Socket software build revision.

socketRole

1.3.6.1.4.1.64366.1.1.6.0

Socket role reported by the agent.

socketBootTime

1.3.6.1.4.1.64366.1.1.7.0

Socket boot-time value reported by the agent.

socketUpTime

1.3.6.1.4.1.64366.1.1.8.0

Socket uptime value reported by the agent.

socketHealthState

1.3.6.1.4.1.64366.1.1.9.0

Socket health state reported by the agent.

Interface Details

Object

OID

Available Information

socketIfIndex

1.3.6.1.4.1.64366.1.2.1.1.1.<if>

Interface identifier in the Cato interface table.

socketIfDestination

1.3.6.1.4.1.64366.1.2.1.1.2.<if>

Configured interface destination.

socketIfWanOutletId

1.3.6.1.4.1.64366.1.2.1.1.3.<if>

WAN outlet identifier associated with the interface.

socketIfState

1.3.6.1.4.1.64366.1.2.1.1.4.<if>

Interface state reported by the agent.

Tunnel and PoP Details

Object

OID

Available Information

socketTunnelIndex

1.3.6.1.4.1.64366.1.3.1.1.1.<tunnel>

Tunnel identifier in the Cato tunnel table.

socketTunnelIfIndex

1.3.6.1.4.1.64366.1.3.1.1.2.<tunnel>

Interface identifier associated with the tunnel.

socketTunnelStatusCode

1.3.6.1.4.1.64366.1.3.1.1.3.<tunnel>

Tunnel status code reported by the agent.

socketTunnelMtu

1.3.6.1.4.1.64366.1.3.1.1.4.<tunnel>

Tunnel MTU reported by the agent.

socketTunnelDiscoveredMtu

1.3.6.1.4.1.64366.1.3.1.1.5.<tunnel>

Discovered tunnel MTU reported by the agent.

socketTunnelNetworkMtu

1.3.6.1.4.1.64366.1.3.1.1.6.<tunnel>

Tunnel network MTU reported by the agent.

socketTunnelServerIp

1.3.6.1.4.1.64366.1.3.1.1.7.<tunnel>

Server IP address for the tunnel.

socketTunnelPopName

1.3.6.1.4.1.64366.1.3.1.1.8.<tunnel>

Name of the PoP associated with the tunnel.

socketTunnelConnectedSecs

1.3.6.1.4.1.64366.1.3.1.1.9.<tunnel>

Tunnel connection duration, in seconds.