- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-DOT3-OAM-MIB | 102.88 KB |
Contents
DOT3-OAM-MIB
About this MIB
Ethernet Operation, Administration, and Maintenance (OAM) is a tool that monitors Layer 2 link status. It checks the connectivity of a link by sending OAM protocol data units (OAMPDUs) and reports to the network administrators when a link error occurs.
This MIB focuses on Ethernet OAM functions.
MIB file name
rfc4878-dot3-oam.mib
Root object
iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).dot3OamMIB(25506)
Tabular objects
dot3OamTable
About this table
This table contains information about basic Ethernet OAM functions of a port.
Support for operations
Create |
Edit/Modify |
Delete |
Read |
Supported |
Supported |
Supported |
Supported |
Columns
The table index is ifIndex.
Object (OID) |
Access |
Syntax |
Value range |
Description |
Implementation |
dot3OamAdminState (1.3.6.1.2.1.158.1.1.1.1) |
read-write |
INTEGER |
1..2 |
Whether Ethernet OAM is enabled on the port. |
As per the MIB. |
dot3OamOperStatus (1.3.6.1.2.1.158.1.1.1.2) |
read-only |
INTEGER |
disabled(1),linkFault(2),passiveWait(3),activeSendLocal(4),sendLocalAndRemote(5),sendLocalAndRemoteOk(6),oamPeeringLocallyRejected(7),oamPeeringRemotelyRejected(8),operational(9),nonOperHalfDuplex(10) |
OAM capability of the link when the interface enters discovery state upon initialization or link error of the OAM entities. |
As per the MIB. |
dot3OamMode (1.3.6.1.2.1.158.1.1.1.3) |
read-write |
IINTEGER |
1...2 |
OAM mode. Ethernet interfaces have two OAM modes: passive(1) and active(2). |
As per the MIB. |
dot3OamMaxOamPduSize (1.3.6.1.2.1.158.1.1.1.4) |
read-only |
Unsigned32 |
64…1518 |
Largest OAMPDU that the OAM entity supports. |
As per the MIB. |
dot3OamConfigRevision (1.3.6.1.2.1.158.1.1.1.5) |
read-only |
Unsigned32 |
0…65535 |
Configuration revision of the local OAM entity. |
As per the MIB. |
dot3OamFunctionsSupported (1.3.6.1.2.1.158.1.1.1.6) |
read-only |
BITS |
unidirectionalSupport(0),loopbackSupport(1),eventSupport(2),variableSupport(3) |
Functions supported by the OAM port. |
As per the MIB. |
dot3OamPeerTable
About this table
This table contains OAM peer configuration information.
Support for operations
Create |
Edit/Modify |
Delete |
Read |
Supported |
Supported |
Supported |
Supported |
Columns
The table index is ifIndex.
Object (OID) |
Access |
Syntax |
Value range |
Description |
Implementation |
dot3OamPeerMacAddress (1.3.6.1.2.1.158.1.2.1.1) |
read-only |
MacAddress |
OCTET STRING (6) Originaltype + valid length. |
MAC address of the OAM peer. |
As per the MIB. |
dot3OamPeerVendorOui (1.3.6.1.2.1.158.1.2.1.2) |
read-only |
EightOTwoOui |
OCTET STRING(3) |
Peer OUI. |
Not supported |
dot3OamPeerVendorInfo (1.3.6.1.2.1.158.1.2.1.3) |
read-only |
Gauge32 |
Standard MIB values. |
Vendor information of the OAM peer. |
Not supported |
dot3OamPeerMode (1.3.6.1.2.1.158.1.2.1.4) |
read-only |
INTEGER |
passive(1), active(2),unknown(3) |
Mode of the OAM peer. |
As per the MIB. |
dot3OamPeerMaxOamPduSize (1.3.6.1.2.1.158.1.2.1.5) |
read-only |
Unsigned32 |
1:0,2:64…1518 |
Maximum OAMPDU length of the OAM peer. |
As per the MIB. |
dot3OamPeerConfigRevision (1.3.6.1.2.1.158.1.2.1.6) |
read-only |
Unsigned32 |
0..65535 |
Configuration revision of the OAM peer. |
As per the MIB. |
dot3OamPeerFunctionsSupported (1.3.6.1.2.1.158.1.2.1.7) |
read-only |
BITS |
unidirectionalSupport(0), loopbackSupport(1), eventSupport(2), variableSupport(3) |
Functions supported by the OAM peer. |
As per the MIB. |
dot3OamStatsTable
About this table
This table contains OAM statistics information.
Support for operations
Create |
Edit/Modify |
Delete |
Read |
Supported |
Supported |
Supported |
Supported |
Columns
The table index is ifIndex.
Object (OID) |
Access |
Syntax |
Value range |
Description |
Implementation |
dot3OamInformationTx (1.3.6.1.2.1.158.1.4.1.1) |
read-only |
Counter32 |
Standard MIB values. |
Number of sent Information OAMPDUs. |
As per the MIB. |
dot3OamInformationRx (1.3.6.1.2.1.158.1.4.1.2) |
read-only |
Counter32 |
Standard MIB values. |
Number of received Information OAMPDUs. |
As per the MIB. |
dot3OamUniqueEventNotificationTx (1.3.6.1.2.1.158.1.4.1.3) |
read-only |
Counter32 |
Standard MIB values. |
Number of sent unique Event Notification OAMPDUs. |
As per the MIB. |
dot3OamUniqueEventNotificationRx (1.3.6.1.2.1.158.1.4.1.4) |
read-only |
Counter32 |
Standard MIB values. |
Number of received unique Event Notification OAMPDUs. |
As per the MIB. |
dot3OamDuplicateEventNotificationTx (1.3.6.1.2.1.158.1.4.1.5) |
read-only |
Counter32 |
Standard MIB values. |
Number of sent duplicate Event Notification OAMPDUs. |
As per the MIB. |
dot3OamDuplicateEventNotificationRx (1.3.6.1.2.1.158.1.4.1.6) |
read-only |
Counter32 |
Standard MIB values. |
Number of received duplicate Event Notification OAMPDUs. |
As per the MIB. |
dot3OamLoopbackControlTx (1.3.6.1.2.1.158.1.4.1.7) |
read-only |
Counter32 |
Standard MIB values. |
Number of sent Loopback Control OAMPDUs. |
As per the MIB. |
dot3OamLoopbackControlRx (1.3.6.1.2.1.158.1.4.1.8) |
read-only |
Counter32 |
Standard MIB values. |
Number of received Loopback Control OAMPDUs. |
As per the MIB. |
dot3OamVariableRequestTx (1.3.6.1.2.1.158.1.4.1.9) |
read-only |
Counter32 |
Standard MIB values. |
Number of sent Variable Request OAMPDUs. |
Not supported |
dot3OamVariableRequestRx (1.3.6.1.2.1.158.1.4.1.10) |
read-only |
Counter32 |
Standard MIB values. |
Number of received Variable Request OAMPDUs. |
Not supported |
dot3OamVariableResponseTx (1.3.6.1.2.1.158.1.4.1.11) |
read-only |
Counter32 |
Standard MIB values. |
Number of sent Variable Response OAMPDUs. |
Not supported |
dot3OamVariableResponseRx (1.3.6.1.2.1.158.1.4.1.12) |
read-only |
Counter32 |
Standard MIB values. |
Number of received Variable Response OAMPDUs. |
Not supported |
dot3OamOrgSpecificTx (1.3.6.1.2.1.158.1.4.1.13) |
read-only |
Counter32 |
Standard MIB values. |
Number of sent Organization Specific OAMPDUs. |
Not supported |
dot3OamOrgSpecificRx (1.3.6.1.2.1.158.1.4.1.14) |
read-only |
Counter32 |
Standard MIB values. |
Number of received Organization Specific OAMPDUs. |
Not supported |
dot3OamUnsupportedCodesTx (1.3.6.1.2.1.158.1.4.1.15) |
read-only |
Counter32 |
Standard MIB values. |
Number of sent OAMPDUs that do not support operation codes. |
Not supported |
dot3OamUnsupportedCodesRx (1.3.6.1.2.1.158.1.4.1.16) |
read-only |
Counter32 |
Standard MIB values. |
Number of received OAMPDUs that do not support operation codes. |
Not supported |
dot3OamFramesLostDueToOam (1.3.6.1.2.1.158.1.4.1.17) |
read-only |
Counter32 |
Standard MIB values. |
Number of dropped frames due to OAM. |
Not supported |
dot3OamEventConfigTable
About this table
This table contains OAM link event detection information.
Support for operations
Create |
Edit/Modify |
Delete |
Read |
Supported |
Supported |
Supported |
Supported |
Columns
The table index is ifIndex.
Object (OID) |
Access |
Syntax |
Value range |
Description |
Implementation |
dot3OamErrSymPeriodWindowHi (1.3.6.1.2.1.158.1.5.1.1) |
read-write |
Unsigned32 |
Standard MIB values. |
High 32 bits of the errored symbol event detection window. |
Not supported |
dot3OamErrSymPeriodWindowLo (1.3.6.1.2.1.158.1.5.1.2) |
read-write |
Unsigned32 |
Standard MIB values. |
Low 32 bits of the errored symbol event detection window. |
Not supported |
dot3OamErrSymPeriodThresholdHi (1.3.6.1.2.1.158.1.5.1.3) |
read-write |
Unsigned32 |
Standard MIB values. |
High 32 bits of the errored symbol event triggering threshold within the detection window. |
Not supported |
dot3OamErrSymPeriodThresholdLo (1.3.6.1.2.1.158.1.5.1.4) |
read-write |
Unsigned32 |
Standard MIB values. |
Low 32 bits of the errored symbol event triggering threshold within the detection window. |
Not supported |
dot3OamErrSymPeriodEvNotifEnable (1.3.6.1.2.1.158.1.5.1.5) |
read-write |
TruthValue |
true(1), false(2) |
Whether errored symbol event notification is enabled. |
As per the MIB. |
dot3OamErrFramePeriodWindow (1.3.6.1.2.1.158.1.5.1.6) |
read-write |
Unsigned32 |
100..60000(V5) 1-65535(V7) |
Errored frame period event detection window. |
Value range: 1 to 65535. Default: 1000. |
dot3OamErrFramePeriodThreshold (1.3.6.1.2.1.158.1.5.1.7) |
read-write |
Unsigned32 |
0.. 4294967295 |
Errored frame period event triggering threshold. |
As per the MIB. |
dot3OamErrFramePeriodEvNotifEnable (1.3.6.1.2.1.158.1.5.1.8) |
read-write |
TruthValue |
true(1), false(2) |
Whether errored frame period event notification is enabled. |
As per the MIB. |
dot3OamErrFrameWindow (1.3.6.1.2.1.158.1.5.1.9) |
read-write |
Unsigned32 |
10..600 |
Errored frame event detection window. |
Value range: 10 -600. Default: 10. |
dot3OamErrFrameThreshold (1.3.6.1.2.1.158.1.5.1.10) |
read-write |
Unsigned32 |
0.. 4294967295 |
Errored frame event triggering threshold. |
As per the MIB. |
dot3OamErrFrameEvNotifEnable (1.3.6.1.2.1.158.1.5.1.11) |
read-write |
TruthValue |
true(1), false(2) |
Whether errored frame event notification is enabled. |
As per the MIB. |
dot3OamErrFrameSecsSummaryWindow (1.3.6.1.2.1.158.1.5.1.12) |
read-write |
Integer32 |
100..9000 |
Errored frame seconds event detection window. |
Value range: 100 to 9000 Default: 600. |
dot3OamErrFrameSecsSummaryThreshold (1.3.6.1.2.1.158.1.5.1.13) |
read-write |
Integer32 |
1..900 |
Errored frame seconds event triggering threshold. |
As per the MIB. |
dot3OamErrFrameSecsEvNotifEnable (1.3.6.1.2.1.158.1.5.1.14) |
read-write |
TruthValue |
true(1), false(2) |
Whether errored frame seconds event notification is enabled. |
As per the MIB. |
dot3OamDyingGaspEnable (1.3.6.1.2.1.158.1.5.1.15) |
read-write |
TruthValue |
true(1), false(2) |
Whether Dying Gasp notification is enabled. |
Not supported |
dot3OamCriticalEventEnable (1.3.6.1.2.1.158.1.5.1.16) |
read-write |
TruthValue |
true(1), false(2) |
Whether critical event notification is enabled. |
Not supported |
dot3OamEventLogTable
About this table
This table contains OAM event log information.
Support for operations
Create |
Edit/Modify |
Delete |
Read |
Supported |
Supported |
Supported |
Supported |
Columns
The table indexes are ifIndex and dot3OamEventLogIndex.
Object (OID) |
Access |
Syntax |
Value range |
Description |
Implementation |
dot3OamEventLogIndex (1.3.6.1.2.1.158.1.6.1.1) |
not-accessible |
Unsigned32 |
1..100 |
Event index. |
As per the MIB. |
dot3OamEventLogTimestamp (1.3.6.1.2.1.158.1.6.1.2) |
read-only |
TimeStamp |
Standard MIB values. |
Timestamp of the event. |
As per the MIB. |
dot3OamEventLogOui (1.3.6.1.2.1.158.1.6.1.3) |
read-only |
EightOTwoOui |
OCTET STRING(3) |
OUI of the event packet. |
As per the MIB. |
dot3OamEventLogType (1.3.6.1.2.1.158.1.6.1.4) |
read-only |
Unsigned32 |
erroredSymbolEvent(1),erroredFramePeriodEvent(2),erroredFrameEvent(3),erroredFrameSecondsEvent(4),linkFault(256),dyingGaspEvent(257),criticalLinkEvent(258) |
Event type. |
As per the MIB. |
dot3OamEventLogLocation (1.3.6.1.2.1.158.1.6.1.5) |
read-only |
INTEGER |
local(1), remote(2) |
Whether the event is a local event or a peer event. |
As per the MIB. |
dot3OamEventLogWindowHi (1.3.6.1.2.1.158.1.6.1.6) |
read-only |
Unsigned32 |
Standard MIB values. |
High bits of the event statistics window. |
As per the MIB. |
dot3OamEventLogWindowLo (1.3.6.1.2.1.158.1.6.1.7) |
read-only |
Unsigned32 |
Standard MIB values. |
Low bits of the event statistics window. |
As per the MIB. |
dot3OamEventLogThresholdHi (1.3.6.1.2.1.158.1.6.1.8) |
read-only |
Unsigned32 |
Standard MIB values. |
High bits of the event statistics threshold. |
As per the MIB. |
dot3OamEventLogThresholdLo (1.3.6.1.2.1.158.1.6.1.9) |
read-only |
Unsigned32 |
Standard MIB values. |
Low bits of the event statistics threshold. |
As per the MIB. |
dot3OamEventLogValue (1.3.6.1.2.1.158.1.6.1.10) |
read-only |
CounterBasedGauge64 |
Standard MIB values. |
Number of occurrences for the event exceeding the threshold within the window. |
As per the MIB. |
dot3OamEventLogRunningTotal (1.3.6.1.2.1.158.1.6.1.11) |
read-only |
CounterBasedGauge64 |
Standard MIB values. |
Total number of occurrences for the running event. |
As per the MIB. |
dot3OamEventLogEventTotal (1.3.6.1.2.1.158.1.6.1.12) |
read-only |
Unsigned32 |
Standard MIB values. |
Total number of times the event has occurred. |
As per the MIB. |
Notifications
This section contains trap notifications.
dot3OamThresholdEvent
Basic information
OID |
Event |
Type |
Severity |
Recovery notification |
Default status |
1.3.6.1.2.1.158.0.1 |
A threshold-crossing event is detected. |
Informational |
N/A |
N/A |
OFF |
Description
A notification sent when a threshold-crossing event is detected on the local or remote end. A device detects local threshold-crossing events through the local entity and detects remote threshold-crossing events through received OAMPDUs.
Status control
ON
MIB: Set dot3OamErrSymEvNotifEnable to true(1).
MIB: Set dot3OamErrFramePeriodEvNotifEnable to true(1).
MIB: Set dot3OamErrFrameEvNotifEnable to true(1).
MIB: Set dot3OamErrFrameSecsEvNotifEnable to true(1).
OFF
MIB: Set dot3OamErrSymEvNotifEnable to false(0)
MIB: Set dot3OamErrFramePeriodEvNotifEnable to false(0).
MIB: Set dot3OamErrFrameEvNotifEnable to false(0).
MIB: Set dot3OamErrFrameSecsEvNotifEnable to false(0).
Objects
OID (object name) |
Description |
Index |
Type |
Value range |
1.3.6.1.2.1.158.1.6.1.2 (dot3OamEventLogTimestamp) |
Timestamp of the event. |
No |
TimeStamp |
TimeTicks |
1.3.6.1.2.1.158.1.6.1.3 (dot3OamEventLogOui) |
OUI of the event packet. |
No |
EightOTwoOui |
OCTET STRING (SIZE (1..255)) |
1.3.6.1.2.1.158.1.6.1.4 (dot3OamEventLogType) |
Event type. |
No |
Unsigned32 |
Standard MIB values. |
1.3.6.1.2.1.158.1.6.1.5 (dot3OamEventLogLocation) |
Whether the event is a local event or a peer event. |
No |
INTEGER |
local(1) remote(2) |
1.3.6.1.2.1.158.1.6.1.6 (dot3OamEventLogWindowHi) |
High bits of the event statistics window. |
No |
Unsigned32 |
0..65535 |
1.3.6.1.2.1.158.1.6.1.7 (dot3OamEventLogWindowLo) |
Low bits of the event statistics window. |
No |
Unsigned32 |
0..65535 |
1.3.6.1.2.1.158.1.6.1.8 (dot3OamEventLogThresholdHi) |
High bits of the event statistics threshold. |
No |
Unsigned32 |
Standard MIB values. |
1.3.6.1.2.1.158.1.6.1.9 (dot3OamEventLogThresholdLo) |
Low bits of the event statistics threshold. |
No |
Unsigned32 |
Standard MIB values. |
1.3.6.1.2.1.158.1.6.1.10 (dot3OamEventLogValue) |
Number of occurrences for the event exceeding the threshold within the window. |
No |
CounterBasedGauge64 |
Counter64 |
1.3.6.1.2.1.158.1.6.1.11 (dot3OamEventLogRunningTotal) |
Total number of occurrences for the running event. |
No |
CounterBasedGauge64 |
Counter64 |
1.3.6.1.2.1.158.1.6.1.12 (dot3OamEventLogEventTotal) |
Total number of times the event has occurred. |
No |
Unsigned32 |
Standard MIB values. |
This table does not contain indexes. For information about the index or indexes of a MIB object instance in an SNMP variable binding, see the section for that MIB object.
Recommended action
Detect links.
dot3OamNonThresholdEvent
Basic information
OID |
Event |
Type |
Severity |
Recovery notification |
Default status |
1.3.6.1.2.1.158.0.2 |
A non-threshold-crossing event is detected. |
Error |
Major |
N/A |
ON |
Description
A notification sent when a non-threshold-crossing event is detected on the local or remote end. A device detects local non-threshold-crossing events through the local entity and detects remote non-threshold-crossing events through received OAMPDUs.
Status control
The notification cannot be disabled.
Objects
OID (object name) |
Description |
Index |
Type |
Value range |
1.3.6.1.2.1.158.1.6.1.2 (dot3OamEventLogTimestamp) |
Timestamp of the event. |
No |
TimeStamp |
TimeTicks |
1.3.6.1.2.1.158.1.6.1.3 (dot3OamEventLogOui) |
OUI of the event packet. |
No |
EightOTwoOui |
OCTET STRING (SIZE (1..255)) |
1.3.6.1.2.1.158.1.6.1.4 (dot3OamEventLogType) |
Event type. |
No |
Unsigned32 |
linkFault(256) dyingGaspEvent(257) criticalLinkEvent(258) |
1.3.6.1.2.1.158.1.6.1.5 (dot3OamEventLogLocation) |
Whether the event is a local event or a peer event. |
No |
INTEGER |
local(1) remote(2) |
1.3.6.1.2.1.158.1.6.1.12 (dot3OamEventLogEventTotal) |
Total number of times the event has occurred. |
No |
Unsigned32 |
Standard MIB values. |
This table does not contain indexes. For information about the index or indexes of a MIB object instance in an SNMP variable binding, see the section for that MIB object.
Recommended action
Do not use the link before it recovers.