`show lag`

Displays Link Aggregation Group (LAG) information.

Syntax

Parameters

lag-name: Displays information about the LAG specified by name.
brief: Displays the LAG information summary.
deployed: Displays information about all the deployed LAGs.
dynamic: Displays information about dynamic LAGs.
idnumber: Displays information about the LAG specified by the ID number.
keep-alive: Displays information about keep-alive LAGs.
static: Displays information about static LAGs.

Modes

User EXEC mode

Privileged EXEC mode

LAG configuration mode

The show lag command displays the following information:

Output Field	Description
Total number of LAGS	The total number of LAGs that have been configured on the device.
Total number of deployed LAGS	The total number of LAGs on the device that are currently deployed.
Total number of trunks created	The total number of trunks that have been created on the LAG. The total number of LAGs available is shown also. Because keep-alive LAGs do not use LAG IDs, they are not listed and do not subtract from the number of LAGs available.
LACP System Priority /ID	The system priority configured for the device. The ID is the system priority that is the base MAC address of the device.
LACP Long timeout	The number of seconds used for the LACP long timeout mode. This is only applicable for dynamic or keep-alive LAGs.
LACP Short timeout	The number of seconds used for the LACP short timeout mode. This is only applicable for dynamic or keep-alive LAGs.

The following information is displayed per-LAG in the show lag brief command:

Output Field	Description
LAG	The name of the LAG, LAG ID number, the configured type of the LAG: static, dynamic, or keep-alive, and the status of LAG deployment (Y/N).

The following information is displayed per-LAG in the show lag command for each LAG configured:

Output Field	Description
LAG Configuration
Ports	The list of ports configured with the LAG.
Port Count	The number of ports configured on the LAG.
Lag Interface	The LAG virtual interface.
Trunk Type	The load-sharing method configured for the LAG. The trunk types are hash-based and resilient-hash.
LACP Key	The link aggregation key for the LAG.

The following information is displayed for the show lag deployed command:

Output Field	Description
Deployment
LAG ID	The LAG ID number.
Active Primary	The port within the LAG where most protocol packets are transmitted. This is not the same as the configured primary port of the LAG.
Port	The chassis slot and port number of the interface.
Link	The status of the link, which can be one of the following values: up down
State	The Layer 2 state for the port.
Dupl	The duplex state of the port, which can be one of the following values: Full Half None
Speed	The bandwidth of the interface.
Trunk	The LAG ID of the port.
Tag	Indicates whether the ports have 802.1q VLAN tagging. The value can be Yes or No.
Pri	Indicates the Quality of Service (QoS) priority of the ports. The priority can be a value from 0 through 7.
MAC	The MAC address of the port.
Name	The name (if any) configured for the port.
Sys P	Lists the system priority configured for the device.
Port P	Lists the link aggregation priority of the port.
Key	Lists the link aggregation key.
Act	Indicates the link aggregation mode, which can be one of the following values: No: The mode is passive on the port. If link aggregation is enabled (and the mode is passive), the port can send and receive LACPDU messages to participate in negotiation of an aggregate link initiated by another port, but cannot search for a link aggregation port or initiate negotiation of an aggregate link. Yes: The mode is active. The port can send and receive LACPDU messages.
Tio	Indicates the timeout value of the port. The timeout value can be one of the following values: L: Long. The LAG has already been formed and the port is therefore using a longer message timeout for the LACPDU messages exchanged with the remote port. Typically, these messages are used as confirmation of the health of the aggregate link. S: Short. The port has just started the LACPDU message exchange process with the port at the other end of the link. The S timeout value also can mean that the link aggregation information received from the remote port has expired and the ports are starting a new information exchange.
Agg	Indicates the link aggregation state of the port. The state can be one of the following values: Agg: Link aggregation is enabled on the port. No: Link aggregation is disabled on the port.
Syn	Indicates the synchronization state of the port. The state can be one of the following values: No: The port is out of sync with the remote port. The port does not understand the status of the LACPDU process and is not prepared to enter a LAG link. Syn: The port is in sync with the remote port. The port understands the status of the LACPDU message exchange process, and therefore knows the LAG to which it belongs, the link aggregation state of the remote port, and so on.
Dis	Indicates the collection state of the port, which determines whether the port is ready to send traffic over the LAG link: Col: The port is ready to send traffic over the LAG link. No: The port is not ready to send traffic over the LAG link.
Col	Indicates the distribution state of the port, which determines whether the port is ready to receive traffic over the LAG link: Dis: The port is ready to receive traffic over the LAG link. No: The port is not ready to receive traffic over the LAG link.
Def	Indicates whether the port is using default link aggregation values. The port uses default values if it has not received link aggregation information through LACP from the port at the remote end of the link. This field can have one of the following values: Def: The port has not received link aggregation values from the port at the other end of the link and is therefore using its default link aggregation LACP settings. No: The port has received link aggregation information from the port at the other end of the link and is using the settings negotiated with that port.
Exp	Indicates whether the negotiated link aggregation settings have expired. The settings expire if the port does not receive an LACPDU message from the port at the other end of the link before the message timer expires. This field can have one of the following values: Exp: The link aggregation settings this port negotiated with the port at the other end of the link have expired. The port is now using its default link aggregation settings. No: The link aggregation values that this port negotiated with the port at the other end of the link have not expired. The port is still using the negotiated settings.
Ope	Indicates the operational state of the LAG. This field can have one of the following values: Ope (operational): The port is operating normally. Blo (blocked): The port is blocked because the adjacent port is not configured with link aggregation or because it is not able to join a LAG. An LACP port is blocked until it becomes part of a LAG. Also, an LACP port is blocked if its state becomes "default". To unblock the port and bring it to an operational state, enable link aggregation on the adjacent port and ensure that the ports have the same key. Frc (force-up): The port is in "force-up" mode. If you have configured the `force-up ethernet` command on the member port of a dynamic LAG, the port goes into "force-up" mode and is logically operational when the dynamic LAG is not operating. Err: If there is a peer information mismatch, then that particular port is moved to the Error disable state (Err).
Port	The chassis slot and port number of the interface.
Partner System ID	The partner system ID indicating the system priority and the MAC address of the port.
Partner Key	The partner key value. Valid key values range from 1 through 65535.
LACP Rx Count	This is the counter for LACPDUs received on this port.
LACP Tx Count	This is the counter for LACPDUs transmitted from this port.

Examples

The following example shows sample output of the show lag command. Information displayed is in sequential order by LAG ID.

device# show lag
Total number of LAGs:          2
Total number of deployed LAGs: 2
Total number of trunks created:2 (126 available)
LACP System Priority / ID:     1 / 609c.9fbc.bf14
LACP Long timeout:             90, default: 90
LACP Short timeout:            3, default: 3
=== LAG "tosp12" ID 1 (dynamic Deployed) ===
LAG Configuration:
   Ports:         e 1/1/5 e 1/1/7
   Port Count:    2
   Lag Interface: lg1
   Trunk Type:    hash-based
   LACP Key:      20001
Deployment: HW Trunk ID 1
Port       Link    State   Dupl Speed Trunk Tag Pvid Pri MAC             Name
1/1/5      Down    None    None None  1     No  1    0   609c.9fbc.bf14

1/1/7      Disable None    None None  1     No  1    0   609c.9fbc.bf14

Port       [Sys P] [Port P] [ Key ] [Act][Tio][Agg][Syn][Col][Dis][Def][Exp][Ope]
1/1/5           1        1   20001   Yes   S   Agg  Syn  No   No   Def  No   Dwn
1/1/7           1        1   20001   Yes   S   Agg  Syn  No   No   Def  No   Dwn
 Partner Info and PDU Statistics
Port          Partner         Partner     LACP      LACP
             System ID         Key     Rx Count  Tx Count
1/1/5    1-0000.0000.0000        4        0         0
1/1/7    1-0000.0000.0000        6        0         0
=== LAG "tosp16" ID 2 (static Deployed) ===
LAG Configuration:
   Ports:         e 1/1/6 e 1/1/8
   Port Count:    2
   Lag Interface: lg2
   Trunk Type:    hash-based
Deployment: HW Trunk ID 2
Port       Link    State   Dupl Speed Trunk Tag Pvid Pri MAC             Name
1/1/6      Down    None    None None  2     No  1    0   609c.9fbc.bf14

1/1/8      Down    None    None None  2     No  1    0   609c.9fbc.bf14

The following example shows sample output of the show lag command with the resilient-hash ("hash-based") trunk type in the LAG configuration.

device(config)# show lag id 1
Total number of LAGs:          4
Total number of deployed LAGs: 2
Total number of trunks created:2 (126 available)
LACP System Priority / ID:     1 / 609c.9fbc.bf14
LACP Long timeout:             90, default: 90
LACP Short timeout:            3, default: 3
=== LAG "tosp16" ID 2 (static Deployed) ===
LAG Configuration:
   Ports:         e 1/1/6 e 1/1/8
   Port Count:    2
   Lag Interface: lg2
   Trunk Type:    hash-based
Deployment: HW Trunk ID 2
Port       Link    State   Dupl Speed Trunk Tag Pvid Pri MAC             Name
1/1/6      Down    None    None None  2     No  1    0   609c.9fbc.bf14

1/1/8      Down    None    None None  2     No  1    0   609c.9fbc.bf14

History

Release version	Command history
08.0.30d	This command was modified to display a changed output for the deployed keyword.
08.0.50	This command was modified to display a changed output for the "resilient-hash" trunk type in the LAG configuration.
08.0.61	This command was modified to include LAG ID options.
08.0.92	This command was modified to display LAG information ordered by LAG ID.

Show Commands

show lag

`show lag`