Adding custom Performance Monitors to the Performance Monitor Library

Performance Monitors gather specific types of data on the devices they are assigned to. System wide monitors are configured using the Performance Monitor Library, but you can also create specific SNMP and WMI monitors to be used on a per-device basis. The default performance monitors (CPU, memory, disk, and interface utilization; and ping latency and availability) cannot be edited or changed from their default settings. By creating custom performance monitors, you can adjust the settings to fit your specific monitoring needs.

To create custom performance monitors (for system wide use):

1. In the WhatsUp Gold web interface from the Go menu, go to Configure > Performance Monitor Library.

   

2. In the Performance Monitor Library, click New.
3. Select the monitor type: SNMP, WMI, or Active Script Performance Monitor, then click OK.
4. Follow the instructions below for the type of monitor you choose.

To configure an SNMP monitor:

1. In the Add SNMP Performance Counter dialog, enter a Name and Description for the monitor as it will appear in the Performance Monitor Library.
2. Either enter the Performance counter OID and Instance or click the Browse (...) button next to the Instance box to go to the SNMP MIB Walker dialog.
3. In the MIB Browser dialog, enter the share name or IP address of the computer in which you want to connect.
4. Enter the SNMP credential used to connect to the device (or click the Browse (...) button to access the Credentials Library to create a new credential.)
5. If needed, adjust the Timeout and Retries count for the connection to the device.
6. Click OK. The SNMP MIB Walker appears.

   

7. Use the navigation tree in the left panel to select the specific MIB you want to monitor for the selected computer or device.
8. In the right pane, select the Property of that MIB you want to monitor. You can view more information about the property/value pair at the bottom of the dialog.
9. Click OK to add the OID to the Performance counter and Instance box in the Add SNMP Performance counter dialog.
10. Verify the configuration and click OK to add the monitor to the Performance Monitor Library.

Note: After the monitor has been added to the library, make sure that you enable that monitor through Device Properties > Performance Monitors for that device or other devices.

To configure a WMI monitor:

1. On the Add WMI Performance Counter dialog, enter a Name and Description for the monitor, as it will appear in the Performance Monitor Library.
2. Click the Browse (...) button next to the Instance box.
3. In the dialog that appears, enter the share name or IP address of the computer in which you want to connect.
4. Enter the domain and user login for the account on this computer. If a domain account is used, then the expected user name is domain\user. If the device is on a workgroup, there are two possible user names: workgroup name\user or machine name\user.
5. Enter the password for the login used above and click OK to connect to the computer.
6. Use the Performance counter tree to navigate to the performance counter you want to monitor.

   

7. Once you select the performance counter, select the specific instance you want to monitor.
8. Click OK to add the counter and instance to the Add Performance Counter dialog.
9. Verify the configuration and click OK to add the monitor to the Performance Monitor Library.

Note: After the monitor has been added to the library, you can enable that monitor through Device Properties > Performance Monitors for that device or other devices.

To configure an SNMP active script performance monitor:

1. On the Add Active Script Performance Monitor dialog, enter a Name and Description for the monitor as it will appear in the Performance Monitor Library.
2. Enter a number for the timeout (in seconds).
3. Choose the type of script (JScript or VBScript) you will be 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 to the monitor.

5. On the Add reference variables dialog, enter a name and description for the variable.
6. Select the type of object (SNMP or WMI) from the Object type drop-down menu.
7. If needed, adjust the Timeout and Retries count for connection to the device.
8. Click the Browse (...) button next to the Instance box. The SNMP MIB Browser appears.
9. Enter the share name or IP address of the computer in which you are trying to connect.
10. Enter the SNMP credential used to connect to the device (or click the Browse (...) button to access the Credentials Library to create a new credential.)
11. If needed, adjust the Timeout and Retries count for the computer in which you are trying to connect.
12. Click OK. The SNMP MIB Walker appears.
13. Use the navigation tree in the left panel to select the specific MIB you want to monitor. You can view more information about the property/value at the bottom of the dialog.
14. Click OK to add the OID to the Performance counter and Instance box in the Add new reference variable dialog.
15. Verify the configuration and click OK to add the variable to the Reference variable list on the Add active script performance monitor dialog.
16. Write or paste your monitor code in the Script text box.
17. Click OK to save changes and add the monitor to the Performance Monitor Library.

To configure a WMI active script performance monitor:

1. On the Add Active Script Performance Monitor dialog, enter a Name and Description for the monitor as it will appear in the Performance Monitor Library.
2. Enter a number for the timeout (in seconds).
3. Choose the type of script (JScript or VBScript) you will be 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 to the monitor.

5. On the Add reference variables dialog, enter a name and description for the variable.
6. Select the type of object (SNMP or WMI) from the Object type drop-down menu.
7. Click the Browse (...) button next to the Instance box.
8. In the dialog that appears, enter the share name or IP address of the computer in which you want to connect.
9. Enter the domain and user login for the account on this computer. If a domain account is used, then the expected user name is domain\user. If the device is on a workgroup, there are two possible user names: workgroup name\user or machine name\user.
10. Enter a password for the login used above and click OK to connect to the computer.
11. Use the Performance counter tree to navigate to the performance counter you want to monitor.
12. Once you select the performance counter, select the specific instance you want to monitor.
13. Click OK to add the variable to the Reference variable list on the Add active script performance monitor dialog.
14. Write or paste your monitor code in the Script text box.
15. Click OK to save changes and to add the monitor to the Performance Monitor Library.

Related Topics Performance Monitor overview Configuring and enabling Performance Monitors About performance reporting