LAG-MIB

MIB Reference — IPNetwork Monitor

All MIBsLAG-MIB

Organization: IEEE 802.3ad Working Group

Last Updated: 1999-11-22

Category: Network Interfaces, Standard: IETF, Technology: Link Aggregation, Technology: Switching/L2

Description:

IEEE 802.3ad Link Aggregation Group (LAG) MIB for managing LACP-based link bundles, member port states, and aggregator parameters.

Imported Objects

From IF-MIB

InterfaceIndex

From SNMPv2-CONF

MODULE-COMPLIANCE
OBJECT-GROUP

From SNMPv2-SMI

BITS
Counter32
MODULE-IDENTITY
OBJECT-TYPE
TimeTicks

From SNMPv2-TC

DisplayString
MacAddress
TEXTUAL-CONVENTION
TruthValue

What Is LAG-MIB?

LAG-MIB is the standard IETF/IEEE MIB (based on IEEE 802.3ad) for managing Link Aggregation Groups formed via LACP, covering aggregator definitions, member port state, and actor/partner negotiation parameters. It exposes configuration and operational data such as aggregator MAC address, system priority and ID, admin/operational keys, and partner system identification, along with a change-tracking timestamp (dot3adTablesLastChanged). Its monitoring value is squarely in link/interface health: comparing dot3adAggActorAdminKey against dot3adAggActorOperKey reveals whether a port is successfully negotiated into its intended aggregate, and tracking dot3adAggPartnerSystemID/dot3adAggPartnerSystemPriority helps confirm the correct peer switch is on the other end of the bundle, both key to detecting a misconfigured or degraded link aggregation group. It depends on and works alongside the standard IF-MIB, since aggregator and aggregation-port entries correspond to interface indices defined there. It is deployed on any Ethernet switch or router supporting 802.3ad LACP-based link bundling, across virtually all vendors that implement the IEEE standard, commonly referenced as the ieee8023-lag-mib in vendor documentation and MIB repositories.

IPNetwork Monitor allows you to monitor SNMP objects defined in LAG-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

  • aggregator MAC address
  • actor/partner system ID and priority
  • actor admin vs. operational key match
  • aggregate/individual port state
  • last-changed timestamp for aggregation tables

Supported Devices

  • vendor-neutral, standards-based MIB, not tied to a specific manufacturer
  • Ethernet switches and routers supporting IEEE 802.3ad LACP link aggregation

Monitoring Examples

A network engineer would poll dot3adAggTable via dot3adAggIndex to read dot3adAggActorOperKey and confirm all expected member ports have negotiated into the same aggregate, flagging a port stuck outside the bundle if its key differs. dot3adAggPartnerSystemID and dot3adAggPartnerSystemPriority would be checked to verify the aggregate is forming with the expected partner switch rather than a misconnected device. dot3adTablesLastChanged would be monitored for unexpected recent changes, which often correlates with a port flap or reconfiguration event within the LAG.

OIDs
OID symbolicOID numericTypeAccessDescription
lagMIB1.2.840.10006.300.43The Link Aggregation module for managing IEEE 802.3ad.
lagMIBObjects1.2.840.10006.300.43.1
dot3adAgg1.2.840.10006.300.43.1.1
dot3adAggTable1.2.840.10006.300.43.1.1.1not-accessibleA table that contains information about every Aggregator that is associated with this System.
dot3adAggEntry1.2.840.10006.300.43.1.1.1.1not-accessibleA list of the Aggregator parameters. This is indexed by the ifIndex of the Aggregator.
NUM dot3adAggIndex1.2.840.10006.300.43.1.1.1.1.1InterfaceIndexnot-accessibleThe unique identifier allocated to this Aggregator by the local System. This attribute identifies an Aggregator instance among the subordinate managed objects of the containing object. This value is read-only.
MAC dot3adAggMACAddress1.2.840.10006.300.43.1.1.1.1.2MacAddressread-onlyA 6-octet read-only value carrying the individual MAC address assigned to the Aggregator.
INT dot3adAggActorSystemPriority1.2.840.10006.300.43.1.1.1.1.3INTEGERread-writeA 2-octet read-write value indicating the priority value associated with the Actor's System ID.
MAC dot3adAggActorSystemID1.2.840.10006.300.43.1.1.1.1.4MacAddressread-onlyA 6-octet read-write MAC address value used as a unique identifier for the System that contains this Aggregator. NOTE -- From the perspective of the Link Aggregation mechanisms described in Clause 43, only a single combination of Actor's System ID and System Priority are considered, and no distinction is made between the values of these parameters for an Aggregator and the port(s) that are associated with it; i.e., the protocol is described in terms of the operation of aggregation within a single System. However, the managed objects provided for the Aggregator and the port both allow management of these parameters. The result of this is to permit a single piece of equipment to be configured by management to contain more than one System from the point of view of the operation of Link Aggregation. This may be of particular use in the configuration of equipment that has limited aggregation capability (see 43.6).
T/F dot3adAggAggregateOrIndividual1.2.840.10006.300.43.1.1.1.1.5TruthValueread-onlyA read-only Boolean value indicating whether the Aggregator represents an Aggregate ('TRUE ') or an Individual link ('FALSE ').
LAC dot3adAggActorAdminKey1.2.840.10006.300.43.1.1.1.1.6LacpKeyread-writeThe current administrative value of the Key for the Aggregator. The administrative Key value may differ from the operational Key value for the reasons discussed in 43.6.2. This is a 16-bit, read-write value. The meaning of particular Key values is of local significance.
LAC dot3adAggActorOperKey1.2.840.10006.300.43.1.1.1.1.7LacpKeyread-onlyThe current operational value of the Key for the Aggregator. The administrative Key value may differ from the operational Key value for the reasons discussed in 43.6.2. This is a 16-bit read-only value. The meaning of particular Key values is of local significance.
MAC dot3adAggPartnerSystemID1.2.840.10006.300.43.1.1.1.1.8MacAddressread-onlyA 6-octet read-only MAC address value consisting of the unique identifier for the current protocol Partner of this Aggregator. A value of zero indicates that there is no known Partner. If the aggregation is manually configured, this System ID value will be a value assigned by the local System.
INT dot3adAggPartnerSystemPriority1.2.840.10006.300.43.1.1.1.1.9INTEGERread-onlyA 2-octet read-only value that indicates the priority value associated with the Partner's System ID. If the aggregation is manually configured, this System Priority value will be a value assigned by the local System.
LAC dot3adAggPartnerOperKey1.2.840.10006.300.43.1.1.1.1.10LacpKeyread-onlyThe current operational value of the Key for the Aggregator's current protocol Partner. This is a 16-bit read-only value. If the aggregation is manually configured, this Key value will be a value assigned by the local System.
INT dot3adAggCollectorMaxDelay1.2.840.10006.300.43.1.1.1.1.11INTEGERread-writeThe value of this 16-bit read-write attribute defines the maximum delay, in tens of microseconds, that may be imposed by the Frame Collector between receiving a frame from an Aggregator Parser, and either delivering the frame to its MAC Client or discarding the frame (see 43.2.3.1.1).
dot3adAggPortListTable1.2.840.10006.300.43.1.1.2not-accessibleA table that contains a list of all the ports associated with each Aggregator.
dot3adAggPortListEntry1.2.840.10006.300.43.1.1.2.1not-accessibleA list of the ports associated with a given Aggregator. This is indexed by the ifIndex of the Aggregator.
POR dot3adAggPortListPorts1.2.840.10006.300.43.1.1.2.1.1PortListread-onlyThe complete set of ports currently associated with this Aggregator. Each bit set in this list represents an Actor Port member of this Link Aggregation.
dot3adAggPort1.2.840.10006.300.43.1.2
dot3adAggPortTable1.2.840.10006.300.43.1.2.1not-accessibleA table that contains Link Aggregation Control configuration information about every Aggregation Port associated with this device. A row appears in this table for each physical port.
dot3adAggPortEntry1.2.840.10006.300.43.1.2.1.1not-accessibleA list of Link Aggregation Control configuration parameters for each Aggregation Port on this device.
NUM dot3adAggPortIndex1.2.840.10006.300.43.1.2.1.1.1InterfaceIndexnot-accessibleThe ifIndex of the port
INT dot3adAggPortActorSystemPriority1.2.840.10006.300.43.1.2.1.1.2INTEGERread-writeA 2-octet read-write value used to define the priority value associated with the Actor's System ID.
MAC dot3adAggPortActorSystemID1.2.840.10006.300.43.1.2.1.1.3MacAddressread-onlyA 6-octet read-only MAC address value that defines the value of the System ID for the System that contains this Aggregation Port.
LAC dot3adAggPortActorAdminKey1.2.840.10006.300.43.1.2.1.1.4LacpKeyread-writeThe current administrative value of the Key for the Aggregation Port. This is a 16-bit read-write value. The meaning of particular Key values is of local significance.
LAC dot3adAggPortActorOperKey1.2.840.10006.300.43.1.2.1.1.5LacpKeyread-writeThe current operational value of the Key for the Aggregation Port. This is a 16-bit read-only value. The meaning of particular Key values is of local significance.
INT dot3adAggPortPartnerAdminSystemPriority1.2.840.10006.300.43.1.2.1.1.6INTEGERread-writeA 2-octet read-write value used to define the administrative value of priority associated with the Partner's System ID. The assigned value is used, along with the value of aAggPortPartnerAdminSystemID, aAggPortPartnerAdminKey, aAggPortPartnerAdminPort, and aAggPortPartnerAdminPortPriority, in order to achieve manually configured aggregation.
INT dot3adAggPortPartnerOperSystemPriority1.2.840.10006.300.43.1.2.1.1.7INTEGERread-onlyA 2-octet read-only value indicating the operational value of priority associated with the Partner's System ID. The value of this attribute may contain the manually configured value carried in aAggPortPartnerAdminSystemPriority if there is no protocol Partner.
MAC dot3adAggPortPartnerAdminSystemID1.2.840.10006.300.43.1.2.1.1.8MacAddressread-writeA 6-octet read-write MACAddress value representing the administrative value of the Aggregation Port's protocol Partner's System ID. The assigned value is used, along with the value of aAggPortPartnerAdminSystemPriority, aAggPortPartnerAdminKey, aAggPortPartnerAdminPort, and aAggPortPartnerAdminPortPriority, in order to achieve manually configured aggregation.
MAC dot3adAggPortPartnerOperSystemID1.2.840.10006.300.43.1.2.1.1.9MacAddressread-onlyA 6-octet read-only MACAddress value representing the current value of the Aggregation Port's protocol Partner's System ID. A value of zero indicates that there is no known protocol Partner. The value of this attribute may contain the manually configured value carried in aAggPortPartnerAdminSystemID if there is no protocol Partner.
LAC dot3adAggPortPartnerAdminKey1.2.840.10006.300.43.1.2.1.1.10LacpKeyread-writeThe current administrative value of the Key for the protocol Partner. This is a 16-bit read-write value. The assigned value is used, along with the value of aAggPortPartnerAdminSystemPriority, aAggPortPartnerAdminSystemID, aAggPortPartnerAdminPort, and aAggPortPartnerAdminPortPriority, in order to achieve manually configured aggregation.
LAC dot3adAggPortPartnerOperKey1.2.840.10006.300.43.1.2.1.1.11LacpKeyread-onlyThe current operational value of the Key for the protocol Partner. The value of this attribute may contain the manually configured value carried in aAggPortPartnerAdminKey if there is no protocol Partner. This is a 16-bit read-only value.
NUM dot3adAggPortSelectedAggID1.2.840.10006.300.43.1.2.1.1.12InterfaceIndexread-onlyThe identifier value of the Aggregator that this Aggregation Port has currently selected. Zero indicates that the Aggregation Port has not selected an Aggregator, either because it is in the process of detaching from an Aggregator or because there is no suitable Aggregator available for it to select. This value is read-only.
NUM dot3adAggPortAttachedAggID1.2.840.10006.300.43.1.2.1.1.13InterfaceIndexread-onlyThe identifier value of the Aggregator that this Aggregation Port is currently attached to. Zero indicates that the Aggregation Port is not currently attached to an Aggregator. This value is read-only.
INT dot3adAggPortActorPort1.2.840.10006.300.43.1.2.1.1.14INTEGERread-onlyThe port number locally assigned to the Aggregation Port. The port number is communicated in LACPDUs as the Actor_Port. This value is read-only.
INT dot3adAggPortActorPortPriority1.2.840.10006.300.43.1.2.1.1.15INTEGERread-writeThe priority value assigned to this Aggregation Port. This 16-bit value is read-write.
INT dot3adAggPortPartnerAdminPort1.2.840.10006.300.43.1.2.1.1.16INTEGERread-writeThe current administrative value of the port number for the protocol Partner. This is a 16-bit read-write value. The assigned value is used, along with the value of aAggPortPartnerAdminSystemPriority, aAggPortPartnerAdminSystemID, aAggPortPartnerAdminKey, and aAggPortPartnerAdminPortPriority, in order to achieve manually configured aggregation.
INT dot3adAggPortPartnerOperPort1.2.840.10006.300.43.1.2.1.1.17INTEGERread-onlyThe operational port number assigned to this Aggregation Port by the Aggregation Port's protocol Partner. The value of this attribute may contain the manually configured value carried in aAggPortPartnerAdminPort if there is no protocol Partner. This 16-bit value is read-only.
INT dot3adAggPortPartnerAdminPortPriority1.2.840.10006.300.43.1.2.1.1.18INTEGERread-writeThe current administrative value of the port priority for the protocol Partner. This is a 16-bit read-write value. The assigned value is used, along with the value of aAggPortPartnerAdminSystemPriority, aAggPortPartnerAdminSystemID, aAggPortPartnerAdminKey, and aAggPortPartnerAdminPort, in order to achieve manually configured aggregation.
INT dot3adAggPortPartnerOperPortPriority1.2.840.10006.300.43.1.2.1.1.19INTEGERread-onlyThe priority value assigned to this Aggregation Port by the Partner. The value of this attribute may contain the manually configured value carried in aAggPortPartnerAdminPortPriority if there is no protocol Partner. This 16-bit value is read-only.
LAC dot3adAggPortActorAdminState1.2.840.10006.300.43.1.2.1.1.20LacpStateread-writeA string of 8 bits, corresponding to the administrative values of Actor_State (43.4.2) as transmitted by the Actor in LACPDUs. The first bit corresponds to bit 0 of Actor_State (LACP_Activity), the second bit corresponds to bit 1 (LACP_Timeout), the third bit corresponds to bit 2 (Aggregation), the fourth bit corresponds to bit 3 (Synchronization), the fifth bit corresponds to bit 4 (Collecting), the sixth bit corresponds to bit 5 (Distributing), the seventh bit corresponds to bit 6 (Defaulted), and the eighth bit corresponds to bit 7 (Expired). These values allow administrative control over the values of LACP_Activity, LACP_Timeout and Aggregation. This attribute value is read-write.
LAC dot3adAggPortActorOperState1.2.840.10006.300.43.1.2.1.1.21LacpStateread-onlyA string of 8 bits, corresponding to the current operational values of Actor_State as transmitted by the Actor in LACPDUs. The bit allocations are as defined in 30.7.2.1.20. This attribute value is read-only.
LAC dot3adAggPortPartnerAdminState1.2.840.10006.300.43.1.2.1.1.22LacpStateread-writeA string of 8 bits, corresponding to the current administrative value of Actor_State for the protocol Partner. The bit allocations are as defined in 30.7.2.1.20. This attribute value is read-write. The assigned value is used in order to achieve manually configured aggregation.
LAC dot3adAggPortPartnerOperState1.2.840.10006.300.43.1.2.1.1.23LacpStateread-onlyA string of 8 bits, corresponding to the current values of Actor_State in the most recently received LACPDU transmitted by the protocol Partner. The bit allocations are as defined in 30.7.2.1.20. In the absence of an active protocol Partner, this value may reflect the manually configured value aAggPortPartnerAdminState. This attribute value is read-only.
T/F dot3adAggPortAggregateOrIndividual1.2.840.10006.300.43.1.2.1.1.24TruthValueread-onlyA read-only Boolean value indicating whether the Aggregation Port is able to Aggregate ('TRUE ') or is only able to operate as an Individual link ('FALSE ').
dot3adAggPortStatsTable1.2.840.10006.300.43.1.2.2not-accessibleA table that contains Link Aggregation information about every port that is associated with this device. A row appears in this table for each physical port.
dot3adAggPortStatsEntry1.2.840.10006.300.43.1.2.2.1not-accessibleA list of Link Aggregation Control Protocol statistics for each port on this device.
C32 dot3adAggPortStatsLACPDUsRx1.2.840.10006.300.43.1.2.2.1.1Counter32read-onlyThe number of valid LACPDUs received on this Aggregation Port. This value is read-only.
C32 dot3adAggPortStatsMarkerPDUsRx1.2.840.10006.300.43.1.2.2.1.2Counter32read-onlyThe number of valid Marker PDUs received on this Aggregation Port. This value is read-only.
C32 dot3adAggPortStatsMarkerResponsePDUsRx1.2.840.10006.300.43.1.2.2.1.3Counter32read-onlyThe number of valid Marker Response PDUs received on this Aggregation Port. This value is read-only.
C32 dot3adAggPortStatsUnknownRx1.2.840.10006.300.43.1.2.2.1.4Counter32read-onlyThe number of frames recei ed that either: - carry the Slow Protocols Ethernet Type value (43B.4), but contain an unknown PDU, or: - are addressed to the Slow Protocols group MAC Address (43B.3), but do not carry the Slow Protocols Ethernet Type. This value is read-only.
C32 dot3adAggPortStatsIllegalRx1.2.840.10006.300.43.1.2.2.1.5Counter32read-onlyThe number of frames received that carry the Slow Protocols Ethernet Type value (43B.4), but contain a badly formed PDU or an illegal value of Protocol Subtype (43B.4). This value is read-only.
C32 dot3adAggPortStatsLACPDUsTx1.2.840.10006.300.43.1.2.2.1.6Counter32read-onlyThe number of LACPDUs transmitted on this Aggregation Port. This value is read-only.
C32 dot3adAggPortStatsMarkerPDUsTx1.2.840.10006.300.43.1.2.2.1.7Counter32read-onlyThe number of Marker PDUs transmitted on this Aggregation Port. This value is read-only.
C32 dot3adAggPortStatsMarkerResponsePDUsTx1.2.840.10006.300.43.1.2.2.1.8Counter32read-onlyThe number of Marker Response PDUs transmitted on this Aggregation Port. This value is read-only.
dot3adAggPortDebugTable1.2.840.10006.300.43.1.2.3not-accessibleA table that contains Link Aggregation debug information about every port that is associated with this device. A row appears in this table for each physical port.
dot3adAggPortDebugEntry1.2.840.10006.300.43.1.2.3.1not-accessibleA list of the debug parameters for a port.
INT dot3adAggPortDebugRxState1.2.840.10006.300.43.1.2.3.1.1INTEGERread-onlyThis attribute holds the value 'current ' if the Receive state machine for the Aggregation Port is in the CURRENT state, 'expired' if the Receive state machine is in the EXPIRED state, 'defaulted' if the Receive state machine is in the DEFAULTED state, 'initialize' if the Receive state machine is in the INITIALIZE state, 'lacpDisabled' if the Receive state machine is in the LACP_DISABLED state, or 'portDisabled' if the Receive state machine is in the PORT_DISABLED state. This value is read-only.
TIK dot3adAggPortDebugLastRxTime1.2.840.10006.300.43.1.2.3.1.2TimeTicksread-onlyThe value of aTimeSinceSystemReset (F.2.1) when the last LACPDU was received by this Aggregation Port. This value is read-only.
INT dot3adAggPortDebugMuxState1.2.840.10006.300.43.1.2.3.1.3INTEGERread-onlyThis attribute holds the value 'detached' if the Mux state machine (43.4.14) for the Aggregation Port is in the DETACHED state, 'waiting' if the Mux state machine is in the WAITING state, 'attached' if the Mux state machine for the Aggregation Port is in the ATTACHED state, 'collecting' if the Mux state machine for the Aggregation Port is in the COLLECTING state, 'distributing' if the Mux state machine for the Aggregation Port is in the DISTRIBUTING state, and 'collecting-distributing' if the Mux state machine for the Aggregation Port is in the COLLECTING-DISTRIBUTING state. This value is read-only.
STR dot3adAggPortDebugMuxReason1.2.840.10006.300.43.1.2.3.1.4DisplayStringread-onlyA human-readable text string indicating the reason for the most recent change of Mux machine state. This value is read-only.
CHU dot3adAggPortDebugActorChurnState1.2.840.10006.300.43.1.2.3.1.5ChurnStateread-onlyThe state of the Actor Churn Detection machine (43.4.17) for the Aggregation Port. A value of 'noChurn' indicates that the state machine is in either the NO_ACTOR_CHURN or the ACTOR_CHURN_MONITOR state, and 'churn' indicates that the state machine is in the ACTOR_CHURN state. This value is read-only.
CHU dot3adAggPortDebugPartnerChurnState1.2.840.10006.300.43.1.2.3.1.6ChurnStateread-onlyThe state of the Partner Churn Detection machine (43.4.17) for the Aggregation Port. A value of 'noChurn' indicates that the state machine is in either the NO_PARTNER_CHURN or the PARTNER_CHURN_MONITOR state, and 'churn' indicates that the state machine is in the PARTNER_CHURN state. This value is read-only.
C32 dot3adAggPortDebugActorChurnCount1.2.840.10006.300.43.1.2.3.1.7Counter32read-onlyCount of the number of times the Actor Churn state machine has entered the ACTOR_CHURN state. This value is read-only.
C32 dot3adAggPortDebugPartnerChurnCount1.2.840.10006.300.43.1.2.3.1.8Counter32read-onlyCount of the number of times the Partner Churn state machine has entered the PARTNER_CHURN state. This value is read-only.
C32 dot3adAggPortDebugActorSyncTransitionCount1.2.840.10006.300.43.1.2.3.1.9Counter32read-onlyCount of the number of times the Actor's Mux state machine (43.4.15) has entered the IN_SYNC state. This value is read-only.
C32 dot3adAggPortDebugPartnerSyncTransitionCount1.2.840.10006.300.43.1.2.3.1.10Counter32read-onlyCount of the number of times the Partner's Mux state machine (43.4.15) has entered the IN_SYNC state. This value is read-only.
C32 dot3adAggPortDebugActorChangeCount1.2.840.10006.300.43.1.2.3.1.11Counter32read-onlyCount of the number of times the Actor's perception of the LAG ID for this Aggregation Port has changed. This value is read-only.
C32 dot3adAggPortDebugPartnerChangeCount1.2.840.10006.300.43.1.2.3.1.12Counter32read-onlyCount of the number of times the Partner's perception of the LAG ID (see 43.3.6.1) for this Aggregation Port has changed. This value is read-only.
TIK dot3adTablesLastChanged1.2.840.10006.300.43.1.3TimeTicksread-onlyThis object indicates the time of the most recent change to the dot3adAggTable, dot3adAggPortListTable, or dot3adAggPortTable.
dot3adAggConformance1.2.840.10006.300.43.2
dot3adAggGroups1.2.840.10006.300.43.2.1
dot3adAggGroup1.2.840.10006.300.43.2.1.1A collection of objects providing information about an aggregation.
dot3adTablesLastChangedGroup1.2.840.10006.300.43.2.1.1.6A collection of objects providing information about the time of changes to the configuration of aggregations and their ports.
dot3adAggPortListGroup1.2.840.10006.300.43.2.1.2A collection of objects providing information about every port in an aggregation.
dot3adAggPortGroup1.2.840.10006.300.43.2.1.3A collection of objects providing information about every port in an aggregation.
dot3adAggPortStatsGroup1.2.840.10006.300.43.2.1.4A collection of objects providing information about every port in an aggregation.
dot3adAggPortDebugGroup1.2.840.10006.300.43.2.1.5A collection of objects providing debug information about every aggregated port.
dot3adAggCompliances1.2.840.10006.300.43.2.2
dot3adAggCompliance1.2.840.10006.300.43.2.2.1The compliance statement for device support of Link Aggregation.

RFC description

IEEE 802.3ad Link Aggregation management for logical port aggregation and LACP protocol.

Start monitoring Vendor-neutral IEEE 802.3ad standard (Ethernet switches/routers with LACP link aggregation) 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 LAG-MIB