display snmp-agent statistics

Function

The display snmp-agent statistics command displays statistics about SNMP packets on the switch.

Format

display snmp-agent statistics

Parameters

None

Views

All views

Default Level

3: Management level

Usage Guidelines

In an SNMP management system, the NMS and the SNMP Agent exchange SNMP messages as follows:

The NMS acts as a manager to send an SNMP Request message to the SNMP Agent.
The SNMP Agent searches the MIB on the device for the required information and sends an SNMP Response message to the NMS.
When the trap triggering conditions are met, the SNMP Agent sends a trap to the NMS to report the event occurring on the device. In this manner, the network administrator can process the event occurring on the network in time.

You can run the display snmp-agent statistics command to analyze the statistics about SNMP packets exchanged between the NMS and SNMP Agent, facilitating fault location.

If large number of messages are received in short period, a great number of CPU resources are occupied. The number of received messages depends on the frequency at which the NMS sends the Request messages.

Example

# Display the statistics about SNMP packets on the switch.

<HUAWEI> display snmp-agent statistics
  0 Messages delivered to the SNMP entity
  0 Messages which were for an unsupported version
  0 Messages which used a SNMP community name not known
  0 Messages which represented an illegal operation for the community supplied
  0 ASN.1 or BER errors in the process of decoding
  7 Messages passed from the SNMP entity
  0 SNMP PDUs which had badValue error-status
  0 SNMP PDUs which had genErr error-status
  0 SNMP PDUs which had noSuchName error-status
  0 SNMP PDUs which had tooBig error-status
  0 MIB objects retrieved successfully
  0 MIB objects altered successfully
  0 GetRequest-PDU accepted and processed
  0 GetNextRequest-PDU accepted and processed
  0 GetResponse-PDU accepted and processed
  0 SetRequest-PDU accepted and processed
  0 Trap-PDU accepted and processed
  0 Inform-PDU sent
  0 Inform ACK PDUs failed to be processed
  0 Inform ACK PDUs successfully processed

**Table 1** Description of the **display snmp-agent statistics** command output
Item	Description
Messages delivered to the SNMP entity	Total number of received SNMP messages
Messages which were for an unsupported version	Number of SNMP messages with version errors
Messages which used an SNMP community name not known	Number of SNMP messages with community name errors
Messages which represented an illegal operation for the community supplied	Number of SNMP messages with authority errors corresponding to community name
ASN.1 or BER errors in the process of decoding	Number of SNMP messages with encoding errors
Messages passed from the SNMP entity	Total number of sent SNMP messages
SNMP PDUs which had badValue error-status	Number of SNMP messages with bad values
SNMP PDUs which had genErr error-status	Number of SNMP messages with general errors
SNMP PDUs which had noSuchName error-status	Number of SNMP messages with requests for non-existing MIB objects
SNMP PDUs which had tooBig error-status	Number of SNMP messages with Too_big errors
MIB objects retrieved successfully	Number of variables requested by NMS
MIB objects altered successfully	Number of variables set by NMS
GetRequest-PDU accepted and processed	Number of received SNMP Get-request messages
GetNextRequest-PDU accepted and processed	Number of received SNMP GetNext-request messages
GetResponse-PDU accepted and processed	Number of sent SNMP Get-response messages
SetRequest-PDU accepted and processed	Number of received SNMP Set-request messages
Trap-PDU accepted and processed	Number of sent SNMP Trap messages
Inform-PDU sent	Number of sent SNMP Inform messages
Inform ACK PDUs failed to be processed	Number of SNMP Inform messages received with no acknowledgement
Inform ACK PDUs successfully processed	Number of SNMP Inform messages received with acknowledgement