h

IO

mon

  The File I/O Performance Monitor

 Making data performSM

Home  |  Products & Services  |  Contact  |  About hyperI/Osm

hIOmon

  hIOmon™ FAQs - WMI Browser Getting Started

The following help information provides simple "Quick Start" instructions that show you how you can use the hIOmon Windows® Management Instrumentation (WMI) Browser to quickly get started using the hIOmon File I/O Performance Monitor.  Please refer to the hIOmon User Guide for a full explanation of the hIOmon WMI support along with detailed descriptions of the various displays, control commands and other advanced facilities supported by the hIOmon software.  The following "Quick Start" instructions make use of the hIOmon WMI Browser; the hIOmon WMI Sample Index FAQ provides additional information about the hIOmon WMI support and the hIOmon WMI demonstration samples.  

IMPORTANT NOTE:  Once you have successfully completed installation of the hIOmon software (please refer to "question 2" within the "Installation FAQs" or to the "Installation Process" section of the hIOmon User Guide for more information), you can perform the following basic steps to start using hIOmon.  These steps show you how to first specify the particular files that are to be monitored by hIOmon and then display the "real-time" summarized file I/O operation performance information for these files; they assume that you will be using the hIOmon WMI Browser (which requires Microsoft® Internet Explorer version 5.5 or above).

Quick Start Step-by-Step

The "Quick Start" is basically a two-step process: 

  1. Selecting the particular file I/O operation activities of interest, which includes specifying the particular files to be monitored and the type of file I/O operation performance information that is to be collected;

  2. Viewing the particular real-time summarized file I/O performance metrics of interest to you.

This "Quick Start" assumes that both the hIOmon Manager and the hIOmon I/O Monitor are currently running; this should be the case if you successfully completed the installation of the hIOmon software (as described within the "Installation FAQs" or the "Installation Process" section of the hIOmon User Guide).  You can verify the current status of both the hIOmon Manager and the hIOmon I/O Monitor by using the hIOmon WMI Browser "View - Status" menu option.

Note that this "Quick Start" does not make use of the hIOmon Presentation Client; a "Quick Start" using the hIOmon Presentation Client can be found on the hIOmon Presentation Client "GettingStarted" FAQ.  Also note that the hIOmon WMI Browser "?" (question mark) menu-bar option can be used to display additional explanations regarding the particular use of the various hIOmon WMI Browser options and controls. 

Step 1: Select the particular files that are to be monitored

Defining a Filter Selection

The hIOmon WMI Browser "View - Filter Selections" and "Modify - Filter Selection" menu sub-options can be used to view and modify a "Filter Selection".  Files that are to be monitored by hIOmon are identified through the use of a "Filter Selection".

A "Filter Selection" consists of one or more file path names representing those particular files that are to be monitored (or specifically excluded from being monitored) by the hIOmon I/O Monitor.  Each of the individual file path names is considered to be a "filter".  That is, each file path name represents a filter in that the hIOmon I/O Monitor will match the name against the file I/O operations it observes to determine whether or not the I/O operation is to be monitored (i.e., whether or not I/O performance information is to be collected for the I/O operation, and if so, the type of performance information that is to be collected).  An asterisk ("*") can be used as a wildcard character in your specification of the file path name (that is, "filter").  Be sure that the associated device letter is entered as well.  Several examples are shown below:

Filter Examples:

         C:\Program Files\*

         C:\Program Files\myProgram.exe

         C:\junk.*

         D:\*

Using the WMIsampleFilters Filter Selection

The "WMIsampleFilters" Filter Selection is provided as part of the installation of the hIOmon software.  Use the hIOmon WMI Browser "View - Filter Selection" menu option to display a list of Filter Selections currently defined; click on the "Get FS Name List" button to retrieve the names of the Filter Selections.  The "WMIsampleFilters" Filter Selection should be included within the drop-down box.  Select "WMIsampleFilters" from the drop-down box to view the contents of this Filter Selection.

The "WMIsampleFilters" Filter Selection includes eight (8) Filters; seven for device "C" and one for device "D".  Except for the Filter that specifies the "pagefile.sys" file, the Filters for device C represent (popular) directories.  Wildcards are used so that all files/directories within the sub-folders will also be monitored by the hIOmon I/O Monitor.

The following instructions show how the Filters defined within the "WMIsampleFilters" Filter Selection can be modified.

NOTE:  Please be sure to remove any Filters that represent floppy, CD, or DVD lettered drive paths (otherwise you will encounter an error message when the hIOmon I/O Monitor tries to "Load" the Filter Selection; "Loading a Filter Selection" is further described below). 

Filter Options

To take a closer look at the specific type of information that the hIOmon I/O Monitor is to collect for each Filter, use the "Display Filter Selection - Filters" section of the hIOmon WMI Browser "View - Filter Selections" display.  Enter "WMIsampleFilters" within the box below the "Get Filters" button, then click on the "Get Filters" button.  The underlying display table will then show entries for each of the eight Filters defined within the "WMIsampleFilters" Filter Selection.  You will notice that one of the Filters is highlighted in bold; this indicates that the Filter represents an "exclusion" (i.e., that the respective files are explicitly excluded from being monitored by the hIOmon I/O Monitor).

You will also notice that one of the Filters has the "FileSummaryPeriodTime" Filter option set for 15 seconds (i.e., that the summarized file I/O operation performance information collected by the hIOmon I/O Monitor is to be prepared for offload to the hIOmon Manager on a periodic 15-second basis).  The remaining Filters show that the "FileSummaryOnFileAlert" Filter option has been set; this indicates that the summarized file I/O operation performance information collected by the hIOmon I/O Monitor is to be prepared for offload to the hIOmon Manager when an alert threshold has been reached/detected by the hIOmon I/O Monitor.

Which particular Alerts have been set?  A quick way to find out is to add the "Alerts active list" entry to the display table (by selecting "Alerts active list" from the drop-down box and then clicking on the "Add Filter Option to Table" button located to the left of the drop-down box), and then click on the "Get Filters" button again.  The "Alerts active list" column of the display table should now show, for each filter, a list representing the names of those Alert Filter options that have been activated (i.e., set to true).  You will notice that four Alerts have been set (i.e., alerts for average response time and maximum response time separately for read and for write I/O operations).  To see the actual alert threshold values for each of these alerts, add the "Alert_Value..." option for the respective Filter option (e.g., "Alert_Value_ResponseTimeAvg_Read" for the "Alert_ResponseTimeAvg_Read" Filter option) to the display table and then click on the "Get Filters" button again.  

Please note that the Filters within the WMIsampleFilters Filter Selection have been set so that only read and write (but not control) I/O operations are to be monitored by the hIOmon I/O Monitor.  I/O operations such as open, close, and create are considered to be "control" type I/O operations.

Optional Device Summaries

Lastly, please note that "Device Summaries" have also been defined within the WMIsampleFilters Filter Selection.  A "Device Summary" pertains to all Filters (within a Filter Selection) that are associated with the same device and for which an aggregate, collective sum of summarized file I/O operation performance metrics for all of these files is to be offloaded on a periodic basis (or when a "File-Close" or "File-Alert" occurs) for any of the files.  The WMIsampleFilters Filter Selection specifies a Device Summary for two devices (C and D), each on a one-minute periodic basis.  To view the particular filter option settings associated with these respective Device Summaries, enter "WMIsampleFilters" within the box below the "Get Device Summaries" button (located under the "Display Filter Selection - Device Summaries" section of the hIOmon WMI Browser "View - Filter Selections" display) and then click on the "Get Device Summaries" button; the underlying display table will then show the various filter option settings for each of the two Device Summaries associated with the WMIsampleFilters Filter Selection.

Adding, Modifying, and Deleting Filters

The hIOmon WMI Browser "Modify - Filter Selection" display provides various options that can be used to modify the Filters associated with a Filter Selection, delete a specific Filter from a Filter Selection, and also add a new Filter to a Filter Selection.  You can also create a new Filter Selection by adding a Filter to a new Filter Selection name.  Please be sure to look at the explanations (click on the "?" within the hIOmon WMI Browser menu bar while displaying the "Modify - Filter Selection" display panel) regarding the use of the various options that can be used to modify Filter Selections.  Also note that you can use the "Add/Modify/Delete - Device Summary Filters" section of the hIOmon WMI Browser "Modify - Filter Selection" display to modify the Device Summaries associated with a particular Filter Selection.

NOTE:  Please be sure to remove any Filters that represent floppy, CD, or DVD lettered drive paths (otherwise you will encounter an error message when the hIOmon I/O Monitor tries to "Load" the Filter Selection; "Loading a Filter Selection" is further described below).

Default Filter Selection

After you have made your changes (if any) to the Filters defined within the WMIsampleFilters Filter Selection, you can optionally make this Filter Selection the ‘default’ Filter Selection by using the "Make Default" button provided within the hIOmon WMI Browser "Modify - Filter Selection" display.  The "default" Filter Selection is automatically loaded into the hIOmon I/O Monitor when the hIOmon Manager "AutoStart" option is enabled to automatically activate file I/O operation monitoring by the hIOmon I/O Monitor when the hIOmon Manager is started.

Loading the Filter Selection

The final step in selecting the particular files to be monitored is loading the Filter Selection into the hIOmon I/O Monitor.  The hIOmon WMI Browser "Modify - Filter Selection" display provides a "Load" button to perform this "load" operation.  This option notifies the hIOmon Manager that it is to pass the selected Filter Selection down to its associated hIOmon I/O Monitor; consequently, the selected Filter Selection will be used by the hIOmon I/O Monitor when file I/O monitoring is activated within the hIOmon I/O Monitor; see the explanation within the hIOmon WMI Browser "Modify - Filter Selection" display for more information.

Also note that as a result of the Installation Default Settings (see the hIOmon User Guide for more information ), the hIOmon Manager will normally have automatically activated the collection of file I/O operation performance information by the hIOmon I/O Monitor when the hIOmon Manager is started.  If you need to manually activate the collection of I/O operation performance information by the hIOmon I/O Monitor, you can use the "enable file I/O operation monitoring" option provided by the hIOmon WMI Browser "Modify - I/O Monitor" display.

In Summary

In summary, the steps required to specify the particular files to be monitored by the hIOmon I/O Monitor are:

  1. Create (or modify) a Filter Selection that contains the Filters representing the particular files that you want monitored, the type of information to be collected (e.g., summarized performance metrics), and the manner in which the collected information is to be offloaded to the hIOmon Manager (e.g., periodic basis or Alert threshold).  You can use the "WMIsampleFilters" Filter Selection initially or as a template.

  2. Load the Filter Selection into the hIOmon I/O Monitor so that it can be used by the hIOmon I/O Monitor in determining which particular files are to be monitored along with the types of I/O operation information to be collected.

The hIOmon WMI Browser "Modify - Filter Selection" display can be used to create, modify and load Filter Selections; the "View - Filter Selection" display can be used to view the contents and current status of Filter Selections.

NOTE:  Please note that, depending upon the number and type of files selected to be monitored (along with the actual amount of associated file I/O activity), the quantity of I/O trace information collected by the hIOmon I/O Monitor can vary and sometimes become quite large.  As a first step, we recommend that you consider the use of the hIOmon filters and summary capabilities to begin your observations of file I/O operation performance from the overall perspective (i.e., a "top-down" approach); the Alert options, along with the ability to display the summarized file I/O operation performance information in a sorted order based upon a selected performance metric, can be especially helpful in this regard.  Then, based upon the file I/O operation performance information results provided by hIOmon, drill-down as necessary to the particular files of interest.  (The more advanced features of hIOmon, such as the support for "replay" mode and the ability to configure hIOmon I/O Monitor memory usage, do allow you to completely capture, if necessary, the entire I/O trace information for highly accessed files). 

Step 2: Display the real-time summarized file I/O performance metrics

The hIOmon WMI Browser "View" menu option provides a variety of ways to display the real-time summarized file I/O operation performance metrics collected by the hIOmon I/O Monitor:

  • Top Ten Files - displays a list of the top ten files based upon your selected sort order.

  • Top Ten Devices - displays a list of the top ten devices based upon overall "Device Summaries" and your selected sort order.

  • Top Ten Processes - displays a list of the top ten processes based upon your selected sort order.

  • File Performance Metrics - displays the selected real-time summarized file I/O operation performance metrics for a particular file of interest; also displays a list of files for which the hIOmon I/O Monitor currently has summarized file I/O operation performance metrics.  In addition, you can display the names of the particular processes that performed the file I/O operations directed to the respective files. 

  • Device Performance Metrics - displays the selected real-time summarized file I/O operation performance metrics on a "Device Summary" basis for a particular device of interest; also displays a list of devices for which the hIOmon I/O Monitor currently has summarized file I/O operation performance metrics on a Device Summary basis.

  • Process Performance Metrics - displays the selected real-time summarized file I/O operation performance metrics for a particular process of interest; also displays a list of processes for which the hIOmon I/O Monitor currently has summarized file I/O operation performance metrics.  In addition, you can display the names of the particular, respective files to which the processes performed the file I/O operations.

That's it.  Getting started using the hIOmon WMI Browser to view the "real-time" summarized performance metrics for selected file I/O operations is as easy as:

  1. Selecting the particular file I/O operation activities of interest along with the types of information to collect;

  2. Viewing the corresponding file I/O performance information in the manner that you like.

Once again, please refer to the hIOmon User Guide for further information about the hIOmon WMI Support.

hyperI/Osm improving the performance of storage I/O in computer servers

Legal and Privacy.  Copyright © 1999-2008  hyperI/O LLC.  All Rights Reserved. 

All trademarks mentioned herein are the property of their respective owners.