Use this Knowledge Script to poll SNMP attributes on a Device at short time intervals during each Knowledge Script iteration. Only numeric SNMP attributes may be polled. For each set of polled values, this script computes a minimum, maximum, average and standard deviation. This script raises an event if computed values exceed the threshold you set.
When this script is run on multiple devices, they are polled successively, and not simultaneously. To poll devices simultaneously, a different job must be created for each device.
NOTE:The number of Polling attempts multiplied by the Polling interval and then multiplied by the number of devices on which the Knowledge Script is run must not exceed the time interval between Knowledge Script iterations. Attempting to do so causes the script to abort, as the polling would not be able to complete before the next iteration is due to execute.
This script continues polling the SNMP device regardless of whether any previous attempts failed. At least two polling attempts must succeed for any meaningful data to be calculated.
This script individually collects separate data streams for each SNMP attribute. By default, this script calculates the percent bandwidth utilization for the first interface listed in the ifTable for the SNMP device, assuming the speed of this interface is standard Ethernet of 100 Megabits per second. If the speed of this interface is different, the values returned by the default settings are not valid.
If one or more numerical conversions are selected, they are performed in the following order: Delta, Multiplication, Division and Percentage.
When polling the growth of SNMP counter values using the Delta option, all values are normalized on a per second basis, regardless of the length of the polling interval. For example, this script can be used to calculate the Kilobytes per second flowing through an interface by polling ifInOctets and ifOutOctets and dividing the returned values by 1024. The values reported are Kilobytes per second regardless of the length of the polling interval.
SNMP Device objects
By default, this script runs once.
Set the following parameters as needed:
|
Parameter |
How to Set It |
|---|---|
|
Polling Parameters |
|
|
SNMP ODE/OIDs |
Supply a list of SNMP attribute ODEs and/or OIDs. ODEs can only be used if the SNMP proxy agent computer has the corresponding MIB available. The default is: "ifInOctets.1, ifOutOctets.1". |
|
Polling interval |
Specify the time interval between polling attempts during each Knowledge Script iteration. The default is 5 seconds. |
|
Polling attempts |
Specify the number of polling attempts to perform during each Knowledge Script iteration. The default is 12. Combined with the default interval of 5 seconds, the script by default polls the SNMP device for 1 minute. The minimum value is 2. |
|
SNMP port number |
Specify the UDP port number on the remote SNMP device to which you want to send SNMP requests. The default is 161. |
|
SNMP timeout |
Specify the number of seconds to wait for a response before timing out an SNMP request. The default is 5 seconds. |
|
Polled Values Check |
|
|
Collect data for polled values? |
Set to Yes to collect data for use in graphs and reports. The data is stored in the AppManager repository. If enabled, returns a data stream for each SNMP device/SNMP attribute pair. The default is unchecked. |
|
Polling calculation type |
For each set of polled values, the Average, Minimum, Maximum and Standard Deviation are calculated. Use this parameter to select which calculated value serves as the data point. |
|
Calculated units |
Specify a name to identify the units being polled and calculated by this script. The default is “Percent”. |
|
Calculate delta for polled value? |
Set to Yes to specify that the retrieved values should be considered a delta from the value retrieved by the previous polling attempt. The difference between the new value and the previous value is calculated. Normally this is used to monitor growth of SNMP counter values between polling attempts. By default, a delta calculation is performed. When set to Yes, integer math (not floating point math) is used; thus, any remainder is discarded. NOTE:When this parameter is enabled, the script reports one less polling attempt than was specified for Polling attempts because the first polling attempt is used to set a baseline for the delta calculations to follow. |
|
Use multiplier for polled value? |
Set to Yes to specify that the retrieved values are numeric and should be multiplied by the value in the next parameter. The default is unchecked. |
|
Multiplier value |
If the Use multiplier for numeric OID value? parameter is enabled, the retrieved SNMP attributes are multiplied by this value before being reported. The default is 1. |
|
Use divisor for polled value? |
Set to Yes to specify that the retrieved values should be divided by the value in the next parameter. Values are converted to real numbers to perform the division and retain the precision of any remainder. The default is unchecked. |
|
Divisor value |
If the Use divisor for numeric OID value? parameter is enabled, the retrieved SNMP attributes are divided by this value before being reported. The default is 1. |
|
Calculate percentage of polled value? |
Set to Yes to specify that the retrieved values should be converted to a percentage of the maximum value supplied in the next parameter. Values are converted to real numbers to perform the percentage calculation and retain the precision of any remainder. Calculated values are restricted to a real number between 0% and 100%. The default is Yes. |
|
Maximum value |
If the Percentage of numeric OID value? parameter is enabled, the retrieved SNMP attributes are converted to a percentage of the maximum value entered here. The default is 12500000 bytes (or 100 Megabits) per second. |
|
Raise event when maximum threshold exceeded? |
Set to Yes to specify that the retrieved values should be compared against the maximum threshold value supplied in the next parameter. If enabled, the check is performed after any mathematical conversions that may have been selected above. The default is unchecked. |
|
Threshold -- Maximum OID value (post-calculation) |
This parameter has no effect unless Raise event when maximum threshold exceeded? is enabled. For numeric attributes, specify the maximum threshold value. If this value is exceeded by a retrieved value after any selected calculations have been performed, an event is raised. Polling threshold values are real numbers. The default is 90. |
|
Raise event when minimum threshold not met? |
Set to Yes to specify that the retrieved values should be compared against the minimum threshold value supplied in the next parameter.If enabled, the threshold check is done after any mathematical conversions that may have been selected above. The default is unchecked. |
|
Threshold -- Minimum OID value (post-calculation) |
This parameter has no effect unless Raise event when minimum threshold not met? is enabled. Specify a minimum threshold value. If the retrieved value fails to meet the threshold value after any calculations have been performed, an event is raised. Polling threshold values are real numbers. The default is 0. |
|
Event severity when polled value violates check |
Set the severity level, from 1 to 40, to indicate the importance of an event in which a threshold is crossed or an equality/inequality check fails. The default is 5. |
|
Event Notification |
|
|
Raise event if SNMP operation succeeds? |
Set to Yes to raise an event if the SNMP Get or GetNext operation is successful. The details of the event contain the retrieved data. |
|
Event severity when SNMP operation succeeds |
Set the severity level, from 1 to 40, to indicate the importance of an event in which an SNMP operation succeeds. The default is 25. |
|
Raise event if SNMP timeout exceeded? |
Set to Yes to raise an event if the SNMP Get or GetNext request receives no response from the device, and all retries fail. |
|
Event severity when SNMP timeout exceeded |
Set the severity level, from 1 to 40, to indicate the importance of an event in which the SNMP timeout period is exceeded. The default is 15. |
|
Raise event if SNMP Response error received? |
Set to Yes to raise an event if an SNMP response error is received from the device. The type of error is reported in the event details. |
|
Event severity when SNMP Response error received |
Set the severity level, from 1 to 40, to indicate the importance of an event in which an SNMP Response error is received. The default is 10. |