Ipswitch WhatsUp Gold User Guide - Ipswitch Documentation Server

Ipswitch WhatsUp Gold User Guide
To configure a WMI active script performance monitor:
1 On the Add Active Script Performance Monitor dialog, type a Name and Description for
the monitor as you want it to appear in the Performance Monitor Library.
2 Type a number for the timeout (in seconds), and for the device-specific Active Script
Performance Monitor, type a number (in minutes) for the Collection interval.
3 Choose the type of script (JScript or VBScript) you are using to write the monitor from
the Script type drop down menu.
4 Add a new variable to the Reference Variables list by clicking Add.
Important: You can add up to 10 reference variables.
Reference variables simplify your scripting code and enable you to write scripts
efficiently, without having to grab a list of device properties, as with the Script Action and
Script Active Monitor. They manage the underlying SNMP or WMI mechanisms that you
would normally manage to access SNMP or WMI counters on a remote device.
By using the Context.GetReferenceVariable (variable name), you only need to
specify the name of a pre-defined variable. WhatsUp Gold uses device credentials and
connects to the target device using SNMP or WMI to retrieve the requested information.
This information is stored in a variable you can use later in your script.
Important: The use of reference variables in the Active Script Performance Monitor is
optional. If you do use them, you must use Context.GetReferenceVariable,for
reference variables to be polled and their data graphed.
5 On the Add reference variables dialog, type a name and description for the variable.
6 Select the type of object (WMI) from the Object type drop-down menu.
7 Click the browse (...) button next to the Instance box. The Performance Counters dialog
appears.
8 Type the computer name or IP address of the computer to which you want to connect.
9 Select a credential from a list of Windows credentials (pulled from the Credentials
Library), then click OK to connect to the computer.
10 Use the Performance counter tree to navigate to the performance counter you want to
monitor.
11 Once you select the performance counter, select the specific instance you want to
monitor.
12 Click OK to add the variable to the Reference variable list on the Add active script
performance monitor dialog.
13 Write or paste your monitor code in the Script text box.
14 Click OK to save changes and to add the monitor to the Performance Monitor Library.
Warning: The first time that you poll a WMI reference variable that requires two polls in order
to calculate an average (such as "Processor\% Processor Time"), it returns "Null."
253