SNMP Test

The SNMP test enables administrators to monitor the SNMP traffic processed by the Citrix ADC appliance, so they can promptly capture:

  • Sudden and significant surges in the SNMP traffic;

  • Drops in SNMP requests;

  • Abnormal SNMP messages;

  • Errors in SNMP traffic

  • SNMP packets dropped and the reasons for the same;

Target of the test : A Citrix ADC VPX/MPX

Agent deploying the test : A remote agent

Outputs of the test : One set of results for the Citrix ADC VPX/MPX appliance being monitored.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The IP address of the host for which the test is being configured.

NetScaler Username, NetScaler Password, and Confirm Password

To monitor a NetScaler device, the eG agent should be configured with the credentials of a user with read-only privileges to the target NetScaler device. Specify the credentials of such a user in the NetScaler Username and NetScaler Password text boxes. Then, confirm the password by retyping it in the Confirm Password text box.

SSL

The eG agent collects performance metrics by invoking NITRO (NetScaler Interface Through Restful interfaces and Objects) APIs on the target NetScaler device. Typically, the NITRO APIs can be invoked through the HTTP or the HTTPS mode. By default, the eG agent invokes the NITRO APIs using the HTTPS mode. This is why, the SSL flag is set to Yes by default. If the target NetScaler device is not SSL-enabled, then the NITRO APIs can be accessed through the HTTP mode only. In this case, set the SSL flag to No.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

SNMP packets received

Indicates the number of SNMP packets received during the last measurement period.

Number

Track the variations in the values of these measures across time to promptly capture steady / sporadic rise in SNMP traffic.

 

SNMP packets transmitted

Indicates the number of SNMP packets transmitted during the last measurement period.

Number

Get requests received

Indicates the number of SNMP Get-Request PDUs that have been accepted and processed during the last measurement period.

Number

 

Get-next requests received

Indicates the number of SNMP Get-Next PDUs that have been accepted and processed during the last measurement period.

Number

 

Get-bulk requests received

Indicates the number of SNMP Get-Bulk PDUs that have been accepted and processed during the last measurement period.

Number

 

Responses transmitted

Indicates the number of SNMP Get-Response PDUs that have been generated by the NetScaler during the last measurement period.

Number

 

Traps messages transmitted

Indicates the number of SNMP Trap PDUs that have been generated by the NetScaler during the last measurement period.

Number

 

Requests dropped

Indicates the number of SNMP requests dropped during the last measurement period.

Number

Ideally, the value of this measure should be 0.

ASN.1/BER errors in requests

Indicates the number of ASN.1 or BER errors encountered when decoding received SNMP Messages during the last measurement period.

Number

ASN.1 is a flexible notation that allows one to define a variety data types, from simple types such as integers and bit strings to structured types such as sets and sequences, as well as complex types defined in terms of others. BER describes how to represent or encode values of each ASN.1 type as a string of eight-bit octets.

Unsupported SNMP version

Indicates the number of SNMP messages received, which were for an unsupported SNMP version during the last measurement period.

Number

Ideally, the value of this measure should be 0.

Unknown community name

Indicates the number of SNMP messages received, which used an SNMP community name not known to the NetScaler during the last measurement period.

Number

Ideally, the value of this measure should be 0.

No permission on community

Indicates the number of SNMP messages received during the last measurement period that represented an SNMP operation which was not allowed by the SNMP community named in the Message.

Number

Ideally, the value of this measure should be 0.

Unsupported security level

Indicates the number of SNMP packets that were dropped during the last measurement period because they requested a security level that is unknown to the NetScaler appliance or otherwise unavailable.

Number

Ideally, the value of this measure should be 0.

Not in time window

Indicates the number of he SNMP packets that are dropped during the last measurement period because they appeared outside the Window of the authoritative SNMP engine.

Number

Ideally, the value of this measure should be 0.

Unknown user name

Indicates the number of SNMP packets that are dropped during the last measurement period because they referenced a user that is not known to the SNMP engine..

Number

Ideally, the value of this measure should be 0.

Unknown engine id

Indicates the number of SNMP packets that are dropped during the last measurement period because they referenced an SNMP engine ID that is not known to the NetScaler appliance.

Number

Ideally, the value of this measure should be 0.

Wrong digest value

Indicates the number of SNMP packets that were dropped during the last measurement period because they do not contain the expected digest value.

Number

Ideally, the value of this measure should be 0.

Decryption errors

Indicates the number of SNMP packets that were dropped during the last measurement period because they cannot be decrypted.

Number

Ideally, the value of this measure should be 0.