Creating new WMI based parameters

Creating new WMI-based parameters using the PATROL WMI Wizard

1. Make sure that you have loaded the PATROL Wizard for Microsoft Performance Monitor and WMI KM files as described in Loading the PATROL Wizard for Microsoft Performance Monitor and WMI.
2. Access the WMI Wizard (NT_WMI) application menu as described in Accessing KM menu commands.
3. Choose the Create New Parameters menu command to display the Create WMI parameter dialog box.
4. Type a name for the parameter you want to create using WMI data in the Parameter Name field.

5. Type a valid statement in the Enter a WQL Query field. The query must return a numerical value.

   Example

    select NumberOfProcesses from Win32_OperatingSystem or select CurrentSize from Win32_Registry

   For WMI classes that begin with Win32_PerfRawData, the query must return a number for a single WMI property. For more information, see WMI queries for the WMI classes that begin with Win32_PerfRawData.

   Example

   select VirtualBytes from Win32_PerfRawData_PerfProc_Process where Name="Idle" 

6. Select the Format Raw Counter Data check box to normalize and display formatted performance data. 

   Note

   You can select this check box only for Win32_PerfRawData WMI classes. For more information, see Performance counters supported through Win32_PerfRawData WMI class.

   This counter is required only when this option is checked. 

7. Specify the counter type qualifier for properties in Win32_PerfRawData classes under Counter Type field. To Configure the counter type qualifier click here

   This value is required only when format raw counter data option is selected.

8.  In the Scaling Factor text box, enter a value between 0 and 2147483647to scale down values that cannot be directly set to parameters, such as WMI queries that return 64-bit integer values. 

   Example

   If you specify the Select CommittedBytes from Win32_PerfRawData_PerfOS_Memory WMI query for a parameter specific to memory, enter a scaling factor of 1024. Thus, the returned value is divided by the specified scaling factor. Similarly, if the parameter is specific to time, you can enter a scaling factor of 1000 to convert a return value in milliseconds to seconds.

   Note

   By default, the scaling factor is 1. For 64-bit performance counters, if the return value of the WMI query is greater than 32-bit, you must scale down the values to get appropriate results. 

9. Click Next to see the result of query.

10. Click Create to create the parameter according to the SQL Query that you entered and close the dialog box.

11. Click Done to create the parameters.
    The dialog box closes and PATROL creates your new parameters.
    If you want to create new parameters over again, click Next and continue with  step 7.
    After you have created new parameters on a particular PATROL Agent, other PATROL console users will not be able to see the new parameters that you created until they load the NT_PERFMON_WIZARD.kml file.