Article Contents
- Configuration OIDs
- Performance Metric OIDs
- Troubleshooting with snmpwalk
Below is the list of the OIDs used to collect configuration data and performance metrics related to Network Device elements in up.time.
Configuration OIDs
These configuration information OIDs are collected when the Network Device is added to up.time and updated regularly by the Configuration Update Gatherer which rescans every 24 hours.
| OID | MIB | Name | Mandatory |
|---|---|---|---|
| 1.3.6.1.2.1.1.5.0 | RFC1213-MIB | System Name | Yes |
| 1.3.6.1.2.1.1.1.0 | RFC1213-MIB | System Description | Yes |
| 1.3.6.1.2.1.1.4.0 | RFC1213-MIB | System Contact | No |
| 1.3.6.1.2.1.1.6.0 | RFC1213-MIB | System Location | No |
| 1.3.6.1.2.1.31.1.1 | IF-MIB | Interface Table | Yes |
If the Network Device being added is a switch or router, the following additional OIDs will be gathered as well.
| OID | MIB | Name | Notes |
|---|---|---|---|
| 1.3.6.1.2.1.2.2.1.1 | RFC1213-MIB | Port Index | |
| 1.3.6.1.2.1.31.1.1.1.1 | IF-MIB | Port Name | If unavailable, 1.3.6.1.2.1.2.2.1.1 (RFC1213-MIB) will be used instead |
| 1.3.6.1.2.1.2.2.1.2 | RFC1213-MIB | Port Description | |
| 1.3.6.1.2.1.2.2.1.3 | RFC1213-MIB | Port Type | |
| 1.3.6.1.2.1.2.2.1.7 | RFC1213-MIB | Port Admin Status | |
| 1.3.6.1.2.1.2.2.1.8 | RFC1213-MIB | Port Operational Status | |
| 1.3.6.1.2.1.2.2.1.5 | RFC1213-MIB | Port Speed | |
| 1.3.6.1.2.1.2.2.1.6 | RFC1213-MIB | Port MAC |
Performance Metric OIDs
Performance metrics are only collected for Network Devices that are switches or routers added in up.time. Metrics will be gathered for ports that have "Port Admin Status" as up and have a valid speed value available.
| OID | MIB | Name | Units | Notes |
|---|---|---|---|---|
| 1.3.6.1.2.1.31.1.1.1.6 | IF-MIB | In Rate | Kbps | If unavailable, 1.3.6.1.2.1.2.2.1.10 (RFC1213-MIB) will be used instead |
| In Usage | Percent | Calculated by dividing In Rate by interface speed. | ||
| 1.3.6.1.2.1.31.1.1.1.10 | IF-MIB | Out Rate | Kbps | If unavailable, 1.3.6.1.2.1.2.2.1.16 (RFC1213-MIB) will be used instead |
| Out Usage | Percent | Calculated by dividing Out Rate by interface speed. | ||
| Usage | Percent | Calculated by adding In Usage and Out Usage together. | ||
| 1.3.6.1.2.1.2.2.1.14 | RFC1213-MIB | In Errors | #/sec | |
| 1.3.6.1.2.1.2.2.1.20 | RFC1213-MIB | Out Errors | #/sec | |
| Errors | #/sec | Calculated by adding In Errors and Out Errors together. | ||
| 1.3.6.1.2.1.2.2.1.13 | RFC1213-MIB | In Discards | #/sec | |
| 1.3.6.1.2.1.2.2.1.19 | RFC1213-MIB | Out Discards | #/sec | |
| Discards | #/sec | Calculated by adding In Discards and Out Discards together. |
Troubleshooting with snmpwalk
Although most SNMP enabled network devices provide the OID's listed above, not all do. If there are issues adding a network device to up.time, it is helpful to use snmpwalk to review the OIDs available on the device. The article "Troubleshooting Network Device Issues with snmpwalk" explains how to do this.