Monitoring LLDP Agents

The lldpadm show-agent subcommand displays the complete information that is advertised by an LLDP agent. Relative to a given system, the advertisement can be information about the local system that is transmitted to the rest of the network. Or, the advertisement can be information that is received by the system from other systems on the same network.

This section describes two procedures:

• How to Display Advertisements

• How to Display LLDP Statistics

How to Display Advertisements

This procedure shows how to display the information that is being advertised by an LLDP agent. The information can be either local or remote. Local information comes from the local system. Remote information comes from other systems on the network, which is received by the local system.

• Use the lldpadm show-agent subcommand with the appropriate option to display the information what you want.
  • To display local information that is advertised by the LLDP agent, type the following command:

    # lldpadm show-agent -l agent

  • To display remote information that is received by the LLDP agent, type the following command:

    # lldpadm show-agent -r agent

  • To display either the local or the remote information in detail, type the following command:

    # lldpadm show-agent -[l|r]v agent

Example 7-5 Obtaining LLDP Agent Information That Is Advertised

The following example shows how to display the information that is being advertised locally or remotely by an LLDP agent. By default, the information is displayed in short form. By using the -v option, you can obtain verbose or detailed information.

# lldpadm show-agent -l net0
AGENT   CHASSISID   PORTID
net0    004bb87f    00:14:4f:01:77:5d

# lldpadm show-agent -lv net0
                      Agent: net0
         Chassis ID Subtype: Local(7)
            Port ID Subtype: MacAddress(3)
                    Port ID: 00:14:4f:01:77:5d
           Port Description: net0
               Time to Live: 81 (seconds)
                System Name: hosta.example.com
         System Description: SunOS 5.11 dcb-clone-x-01-19-11 i86pc
     Supported Capabilities: bridge,router
       Enabled Capabilities: router
         Management Address: 192.168.1.2
         Maximum Frame Size: 3000
               Port VLAN ID: --
               VLAN Name/ID: vlan25/25
        VNIC PortID/VLAN ID: 02:08:20:72:71:31
    Aggregation Information: Capable, Not Aggregated
                PFC Willing: --
                    PFC Cap: --
                    PFC MBC: --
                 PFC Enable: --
                PFC Pending: --
Application(s) (ID/Sel/Pri): --
    Information Valid Until: 117 (seconds)

# lldpdadm show-agent -r net0
AGENT   SYSNAME   CHASSISID   PORTID
net0    hostb     0083b390    00:14:4f:01:59:ab

# llpdadm show-agent -rv net0
                      Agent: net0
         Chassis ID Subtype: Local(7)
            Port ID Subtype: MacAddress(3)
                    Port ID: 00:14:4f:01:59:ab
           Port Description: net0
               Time to Live: 121 (seconds)
                System Name: hostb.example.com
         System Description: SunOS 5.11 dcb-clone-x-01-19-11 i86pc
     Supported Capabilities: bridge,router
       Enabled Capabilities: router
         Management Address: 192.168.1.3
         Maximum Frame Size: 3000
               Port VLAN ID: --
               VLAN Name/ID: vlan25/25
        VNIC PortID/VLAN ID: 02:08:20:72:71:31
    Aggregation Information: Capable, Not Aggregated
                PFC Willing: --
                    PFC Cap: --
                    PFC MBC: --
                 PFC Enable: --
Application(s) (ID/Sel/Pri): --
    Information Valid Until: 117 (seconds)

How to Display LLDP Statistics

You can display LLDP statistics to obtain information about LLDP packets that are being advertised by the local system or by remote systems. The statistics refer to significant events that involve LLDP packet transmission and reception.

1. To display all the statistics about LLDP packet transmission and reception, use the following command:

   # lldpadm show-agent -s agent

2. To display selected statistics information, use the -o option.

   # lldpadm show-agent -s -o field[,field,...]agent

   where field refers to any field name in the output of the show-agent -s command.

Example 7-6 Displaying LLDP Packet Statistics

This example shows how to display information about LLDP packet advertisement.

# lldpadm show-agent -s net0
AGENT IFRAMES IEER IDISCARD OFRAMES OLENERR TLVDISCARD TLVUNRECOG AGEOUT
net0        9    0        0      14       0          4          5      0

The command output provides the following information:

• AGENT specifies the name of the LLDP agent, which is identical to the datalink on which the LLDP agent is enabled.

• IFRAMES, IEER, and IDISCARD display information about packets being received, incoming packets with errors, and incoming packets that are dropped.

• OFRAMES and OLENERR refer to outgoing packets as well as packets that have length errors.

• TLVDISCARD and TLVUNRECOG display information about TLV units that are discarded as well as TLV units that are not recognized.

• AGEOUT refers to packets that have timed out.

The example indicates that out of 9 frames received into the system, 5 TLV units are unrecognized, possibly because of noncompliance with standards. The example also shows that 14 frames were transmitted by the local system to the network.