8.24 SNMPGet

Use this Knowledge Script to monitor SNMP activity for the device or computer you specify. This script performs an SNMP v1 Get or GetNext against the selected SNMP agent, allowing you to check SNMP MIB (management information base) variable values. The value returned can be compared to the thresholds you set or a text string. This script requires the Microsoft SNMP Service to be running.

NOTE:When setting the parameters for this script, choose whether the jobs should perform a threshold comparison, equality check, or string matching. These operations are mutually exclusive operations.

8.24.1 Resource Objects

Any Windows server or CIM server with an SNMP agent installed and running

8.24.2 Default Schedule

The default interval for this script is Every 5 minutes.

8.24.3 Setting Parameter Values

Set the following parameters as needed:

Parameter	How to Set It
Raise event if MIB variable matches string or numeric value, or exceeds or falls below threshold?	Set to y to raise an event if a MIB value falls below or exceeds the threshold, or if a value matches the parameters you set for Equality check? or String match. The default is y.
Collect data for MIB variable?	Set to y to collect data for charts and reports. If enabled, data collection returns the value of the MIB variable for graphing. If the MIB variable you specify is of an octet string type, the value is displayed in the graph data detail message. The default is y.
MIB object identifier	Specify a MIB object identifier in OID notation (for example, .1.2.3.456.78) or ODE notation (for example, system.sysUpTime.0). The default is system.sysName.0. OID notation must include the dot (.) at the beginning of the identifier. ODE notation must be case-sensitive. You can use the ODE if the mib.bin file has been compiled on the agent computer in the %windir%/system32 directory. For information about compiling the mib.bin, see the Windows Resource Kit.
SNMP community string	Provide the SNMP community string for the device or computer on which you want to monitor SNMP activity. Leave this parameter blank to use the SNMP community name entered in the AppManager Security Manager. The default is public.
SNMP agent	Specify the hostname or IP address of the device or computer on which you want to monitor SNMP activity. If you do not specify an SNMP agent, the local client computer is assumed.
Threshold - Maximum MIB variable value	Specify the maximum value the MIB variable can attain before an event is raised. The default is 600000.
Threshold - Minimum MIB variable value	Specify the minimum value the MIB variable must maintain to prevent an event from being raised. The default is 300000.
Check for equality to numeric MIB variable	Set to e to compare the MIB variable’s value to a specific value (set in the Numeric MIB variable value parameter) and raise an event when the values are equal. Set to n to compare the MIB variable’s value to a specific value (set in the Numeric MIB variable value parameter) and raise an event when the values are not equal. Set to s to skip testing for equality. This parameter is applicable for numeric MIB variables such as INTEGER, GAUGE, or COUNTER. The default is s.
Numeric MIB variable value	Specify the value that you want to compare with the returned MIB variable value. If Check for equality to numeric MIB value? is set to e, an event is raised when the MIB variable equals the value you specify in this parameter. If Check for equality to numeric MIB value? is set to n, an event is raised when the values are not equal. The default is 0.
Text string or IP address MIB variable value	Specify the text string or IP address that you want to compare with the returned MIB variable value. This parameter is applicable only when the MIB type is OCTETSTRING or IPADDRESS. The MIB variable value is compared to this string, and an event is raised if they are equal.
Enforce case-sensitive string match?	Set to y to enable this script to match case when checking for a match to the string entered for the String match parameter. The default is n.
Event severity when MIB variable matches string or numeric value, or exceeds or falls below threshold?	Set the event severity level, from 1 to 40, to indicate the importance of an event in which a MIB variable value exceeds or falls below the threshold, or if a value matches the parameters you set for Equality check? or String match. The default is 5 (red event indicator).
Select operation: Get or GetNext	Specify whether to perform SNMP Get or GetNext. The default is Get.
Number of times to perform the operation	Specify the number of times this script should try to perform the Get operation before returning an error. The default is 3 times.
Number of seconds to wait for operation to complete	Specify the number of seconds this script should wait for the Get or GetNext operation to complete before timing out and returning an error. The default is 5 seconds.
Event message text	Provide the text to display in the event detail message. If you do not enter a message, a default message consisting of the MIB variable and value is used.