How can I check that Statseeker is able to capture the data I would like from a device?
Please check that the devices SNMP Management Information Base (MIB) has the information you would like available.
The MIB is a text-based database file that acts as a dictionary or instruction manual for Simple Network Management Protocol (SNMP) devices.
SNMP uses MIB's (Management Information Base's) as dictionaries that define the readable names and data structures of OID's (Object Identifiers).
The OID's are the actual numeric addresses that network devices query to retrieve or set specific device value.
The relationship is:
- The OID (e.g.,
1.3.6.1.2.1.1.5.0) is the number of the particular value we wish to ask the device for. - The MIB is the translation layer that assigns a human-readable name (e.g.,
sysName.0) and rules (data type, read/write access) to that OID.
Component Breakdown
| Component | Definition | Function | Example |
|---|---|---|---|
| OID | A dotted sequence of numbers. | Uniquely identifies a specific managed object or variable on a device. | 1.3.6.1.2.1.1.1.0 (System Description) |
| MIB | A text file written in ASN.1 format. | Translates numeric OIDs into readable labels and defines their data syntax. | RFC1213-MIB or Vendor-specific files (e.g., Cisco CISCO-VTP-MIB) |
| SNMP | The application-layer communication protocol. | Transports the requests and replies regarding the data behind those OIDs. | GET or SET commands sent across the network |
The first thing you can do to check if Statseeker is capturing the information you would like is to discover the device in Statseeker and view the device using the Device Viewer in the Console tab.
Please note that waiting at least 15 minutes after adding a device will ensure that a few data gathering cycles have passed and information will be available for viewing.
To check if Statseeker collects the MIB-OID information you would like please go to the command line and grep for the MIB in the directory:
/usr/local/statseeker/ss/etc/customoids
e.g. for the CISCO-SWITCH-HARDWARE-CAPACITY-MIB
statseeker$ pwd
/usr/local/statseeker/ss-25.2/etc/customoids
statseeker$ grep CISCO-SWITCH-HARDWARE-CAPACITY-MIB *
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamLogicalTotal",
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamLogicalUsed",
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamTotal",
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamUsed",
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamWidthType",
nim-custom-oid-cisco_fib_tcam.cfg: "{CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamLogicalTotal}"
nim-custom-oid-cisco_fib_tcam.cfg: "{CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamLogicalUsed}"
nim-custom-oid-cisco_fib_tcam.cfg: "{CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamTotal}"
nim-custom-oid-cisco_fib_tcam.cfg: "{CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamUsed}"
nim-custom-oid-cisco_fib_tcam.cfg: "{CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamWidthType}"
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamLogicalTotal": {
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamLogicalUsed": {
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamTotal": {
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamUsed": {
nim-custom-oid-cisco_fib_tcam.cfg: "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamWidthType": {
nim-custom-oid-cisco_fib_tcam.cfg: "1.3.6.1.4.1.9.9.663.1.1.2.2": "CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamUsageTable"
Please check for the MIB you would like in the output.
If it is not there please request a Custom Data Type (CDT) Package as per the document linked below:
https://docs.statseeker.com/hdi/cdt-request/
If you have an OID that you would like to check is in Statseeker please use the nim-snmpmibresolve command as the statseeker user.
e.g.
statseeker$ nim-snmpmibresolve 1.3.6.1.4.1.9.9.663.1.1.2.2
1.3.6.1.4.1.9.9.663.1.1.2.2 CISCO-SWITCH-HARDWARE-CAPACITY-MIB.cshcProtocolFibTcamUsageTable
If the OID is not there Statseeker will return the OID twice.
e.g.
statseeker$ nim-snmpmibresolve 1.3.6.1.4.1.9.123.663.1.1.2.2
1.3.6.1.4.1.9.123.663.1.1.2.2 1.3.6.1.4.1.9.123.663.1.1.2.2