hIOmon™ Disk I/O Ranger Display Help Information

Brief help information for the following topics related to the hIOmon Disk I/O Ranger Display application (HTA) is provided below:

Background Information

The hIOmon "Disk I/O Ranger Display" application can be used to display the hIOmon "Performance Threshold Range Metrics", which are a selected set of summarized I/O operation performance metrics that are specifically focused upon the ranges of I/O operations per second (IOPS), megabytes-per-second (MB/s) data transfer rates, response time (RT), I/O operation queue depths/lengths (QD), and data transfer sizes/lengths (DTS) actually observed by the hIOmon I/O Monitor for individual files, devices, and processes.

The IOPS, MB/s, QD, and RT metrics are automatically included within the summarized I/O operation performance information collected by the hIOmon software.  The DTS summarized metrics are optionally collected separately.  Also note that the capture of the hIOmon "Performance Threshold Range Metrics" does not require I/O operation trace collection.

All of these metrics can also be displayed by the hIOmon Presentation Client, the hIOmon CLI, and the hIOmon WMI Browser, all of which are included within the "hIOmon I/O Performance Monitor" software package from hyperI/O.  These metrics can additionally be accessed via the hIOmon WMI Support.

The hIOmon “Performance Threshold Range Metrics” can also be directly exported to a CSV-formatted "hIOmon Manager Export File", which is another feature that is included within the "hIOmon I/O Performance Monitor" software package.

In addition, the hIOmon Presentation Client can be used to display these metrics within a “Bar Chart” graphic format similar to that shown by the hIOmon "Disk I/O Ranger Display" application.

Please note that the hIOmon "Performance Threshold Range Metrics” reflect the actual I/O operation activity observed by the hIOmon I/O Monitor software component.  For instance, the "IOPS < 100" Range Count for read I/O operations reflects the number of one-second intervals during which the hIOmon I/O Monitor actually observed a total number of monitored read I/O operations that was less than 100 read I/O operations.

Similarly, the "MBS 100 < 200" Range Count for write I/O operations reflects the number of one-second intervals during which the hIOmon I/O Monitor actually observed a total amount of data transferred by write I/O operations that was 100 000 000 bytes (i.e., 100 megabytes) or more, but less than 200 000 000 bytes (i.e., 200 megabytes).

Also note that the hIOmon "Disk I/O Ranger Display" application displays the selected Performance Threshold Range Metrics in real-time.  That is, the current summarized values of these metrics (as maintained by the hIOmon I/O Monitor) are retrieved by the hIOmon "Disk I/O Ranger Display" application from the hIOmon I/O Monitor and then displayed.  This display is repeatedly refreshed (i.e., the latest values are retrieved from the hIOmon I/O Monitor and then displayed) upon a user-selected periodic basis (e.g., every five seconds). 

The hIOmon "Performance Threshold Range Metrics" provide a quick and easy way to assess the actual "speeds and feeds" I/O performance of your particular files, devices and applications in everyday, normal usage!
 

The hIOmon "Disk I/O Ranger Display" application also supports the display and export of the hIOmon "DataTransferred/Time Index" metric, which provides a "high-level" means for relative comparison of I/O performance, where basically "higher is better"; that is, the "higher" the Index number, the better the performance - as in more data transferred and/or less required response time (i.e., application wait).  It resembles the "fuel economy" index for an automotive vehicle (i.e., "miles-per-gallon" or "kilometres/litre") as an overall measure of "performance efficiency"

The hIOmon "Disk I/O Ranger Display" application is run as a Microsoft Windows HTML Application (HTA).  The metrics displayed are those currently collected by the hIOmon I/O Monitor, which must be properly configured to collect the particular types of metrics displayed by the hIOmon "Disk I/O Ranger Display" application.  See the section immediately below for the configuration requirements.

Configuration Information

The hIOmon software must be properly configured in order to collect the "Performance Threshold Range Metrics" for display by the hIOmon "Disk I/O Ranger Display" application.  This proper configuration includes an active/loaded hIOmon "Filter Selection".  The hIOmon "Filter Selection" specifies the particular files/devices that are to be monitored by the hIOmon software as well as the specific types of I/O operations to be monitored and the types of I/O operation performance metrics to be collected.  Moreover, the collection of I/O operation performance metrics generally begins when the Filter Selection is loaded/activated (these metrics are also reset to zeros when a Filter Selection is re-loaded/activated).

More specifically, the active Filter Selection must be configured to request the monitoring of read I/O operations (if "Read Range Counts" are to be displayed) and/or write I/O operations (if "Write Range Counts" as to be displayed) along with the collection of "summary" metrics (including "Device Summary" metrics)  for the particular files and logical devices, physical volume(s), and/or physical device(s) of interest.

Please note that the "summary" metrics collected by hIOmon are summarized I/O operation performance metrics which are automatically aggregated by the hIOmon I/O Monitor at the time that it observes the individual I/O operations.  Moreover, the collection of these "summary" metrics does not require the collection of "I/O operation trace" data (which is a separate option also provided by the "hIOmon I/O Performance Monitor" software package).  The "summary" metrics are an unique feature of the hIOmon software.

The hIOmon "Disk I/O Ranger Display" application provides a simple and quick way to display a selected subset (specifically the "Performance Threshold Range Metrics") within the large, comprehensive set of summary metrics that can be captured, displayed, and exported by the hIOmon I/O Monitor.

Please note that this application also provides a limited means to configure the hIOmon software so as to collect the summary metrics required for display.  Additional information is provided within the "Getting Started" section below.

In addition, a hIOmon client (e.g., the hIOmon Presentation Client, the hIOmon WMI Browser, etc.) can be used to configure more specifically the hIOmon software in accordance with particular monitoring requirements; please note that these clients are included with the "hIOmon I/O Performance Monitor" software package.

The various hIOmon "Add-Ons" that are included with the "hIOmon I/O Performance Monitor" software package can also be used to quickly and easily configure the hIOmon software so as to meet particular configuration requirements.  For example, the hIOmon "SSD I/O Performance Metrics Analysis Add-On" uses a series of interactive input prompts that allow you to simply specify the particular physical volumes and/or physical devices for which the hIOmon software is to collect SSD TRIM-related metrics (and optionally summary metrics for read and write I/O operations, including the "Performance Threshold Range Metrics").  Based upon your selected input parameters, this hIOmon Add-On will then automatically configure the hIOmon software; please note that a restart/reboot of the computer system might be required in order to activate the required hIOmon configuration changes.

Installation Information

The hIOmon “Disk I/O Ranger Display” application can be found in the “hIOmonDiskIORanger” folder within the “..\hyperIO\hIOmon\Support\AddOns\” directory where the hIOmon software was installed; this applies to both the "hIOmon Disk I/O Ranger" and the "hIOmon I/O Performance Monitor" software products.

A "hIOmon Disk I/O Ranger” icon is placed upon the desktop along with the “Start -> Programs -> hIOmon -> hIOmon Disk I/O Ranger” shortcut (both of which are added by the Windows Installer as part of the hIOmon software installation process).

Getting Started

To use/run the hIOmon "Disk I/O Ranger Display" application, simply double-click upon the "hIOmon Disk I/O Ranger” desktop icon or use the the “Start -> Programs -> hIOmon -> hIOmon Disk I/O Ranger” shortcut.

You can also run the hIOmon “Disk I/O Ranger Display” application by simply double-clicking upon the "hIOmonDiskIORanger.hta" file located within the “hIOmonDiskIORanger” folder as noted above within the "Installation Information" section.

When first run after the installation of the hIOmon software package, the hIOmon Disk I/O Ranger Display application will by default determine whether there is an existing Filter Selection that is currently active, which should not be the case if you have not yet used any of the hIOmon clients (e.g., the hIOmon Presentation Client, the hIOmon WMI Brower, etc.) or a hIOmon Add-On to configure the hIOmon software.

If no active Filter Selection is found, then the hIOmon Disk I/O Ranger Display application will automatically perform the following steps:

  1. Create a Filter Selection (named "IORangerFS" by default) that will include a single filter specifying that both read and write I/O operations for all files upon the "C:" logical drive are to be monitored by the hIOmon I/O Monitor and that "summary" I/O operation performance metrics are to be collected for the monitored files.

  2. In addition, "Device Summary" metrics will also be collected for the "C:" logical drive; these "Device Summary" metrics reflect the combined totals for all of the monitored files that reside upon the C: logical disk and for which the hIOmon I/O Monitor observed read and/or write I/O operations.

  3. Will display an input prompt asking whether you also want both read and write I/O operations to be monitored by the hIOmon I/O Monitor for the physical disk associated with the "C:" logical drive.  If you enter a response indicating "Yes", then an additional filter for this physical disk will be included within the created Filter Selection; this filter will specify that "summary" I/O operation performance metrics are to be collected by the hIOmon I/O Monitor for both read and write I/O operations to the physical disk.

  4. After successfully creating this "IORangerFS" Filter Selection, the hIOmon Disk I/O Ranger Display application will then load/activate this Filter Selection.  The hIOmon I/O Monitor will immediately begin monitoring I/O operations for files residing upon the C: drive and collecting summary metrics; please note that no reboot of the system is required in this case since the hIOmon I/O Monitor will not be monitoring I/O operations at either the physical volume level or physical device level within the Windows OS I/O stack.

    Please note that no reboot of the system will be required unless you requested (in step 3 above) that I/O operation performance metrics are also to be collected for the physical disk associated with the C: drive.  If you did request that physical device metrics also be collected, then you will need to restart the system in order to complete the configuration of the hIOmon software; the hIOmon I/O Monitor will be able to monitor I/O operations at the physical device level within the Windows OS I/O stack after the system has been restarted.  If you do not restart the system in this case, then an error message will be shown when you try to display I/O operation performance metrics for the physical device.

  5. The hIOmon Disk I/O Ranger Display application will then make the "IORangerFS" Filter Selection the "default" Filter Selection.  The hIOmon Manager software component loads the "default" Filter Selection (if any) automatically each time the system is started.

The hIOmon Disk I/O Ranger Display application is initially configured so that only the combined "Read/Write" IOPS and Response Time (RT) metrics are displayed, with the display refreshed with the current metric values upon a five-second periodic basis.  This initial configuration does not include the optional collection of the DTS (Data Transfer Size) summary metrics.

Please note that the above configuration settings for the hIOmon Disk I/O Ranger Display application can be changed by using the "Settings" button/option at the bottom of the "Main Display".

Main Display

The Main Display includes the optional detailed display of four basic "Performance Threshold Range Metric" groups (i.e., the IOPS, MBs, Queue Depth (QD), Response Time (RT), and Data Transfer Sizes (DTS) Range Counts) along with important contextual information:

The "Settings" button at the bottom of the Main Display can be used to select a different monitored item to be displayed.  Simply click on the "Settings" button, then select the item of interest from the drop-down list box of names near the top of the "Settings" window and click on the "OK" button at the bottom of the "Settings" window.  The hIOmon Disk I/O Ranger display window will change to display the summary I/O operation performance metrics for the selected item of interest; also note that the selected item will be highlighted with a green background within the drop-down list of names (since it is the item currently being shown within the hIOmon Disk I/O Ranger display).  See the "Metrics for monitored:" description below for additional details.

Also please note the following:

  1. All of the above metrics reflect the total, cumulative values that have been automatically accumulated by the hIOmon I/O Monitor during the indicated Observation Period.  Also please note that only those I/O operations that were successfully performed are included within the displayed IOPS, MBs, RT, and DTS Range Counts.  In addition, the DTS Range Counts require that the separate, optional collection of DTS summary metrics be enabled within the Filter Selection for the particular file, device, and/or process of interest.

  2. Note that the first "one-second interval" begins with the first monitored read (in the case of the read and the combined read/write metrics) or write (in the case of the write and the combined read/write metrics) I/O operation observed by the hIOmon I/O Monitor for the respective file, device, or process.

  3. The metrics are displayed upon a individual monitored item basis (i.e., for a single file, process, logical disk, physical volume, or physical device).  The "Settings" button/option can be used to select a different monitored item for which the metrics are to be displayed.

  4. The display of the metric values is periodically refreshed/updated automatically to the current values.  You can view the refresh time interval by clicking on the "Settings" button/option; the "Settings" options can also be used to select a different refresh time interval.  Also please note that only those IOPS, MBs, QD, RT, and DTS Range Counts that have a non-zero value are displayed.

  5. An error indication will be displayed near the bottom of the Main Display in the event that the hIOmon Disk I/O Ranger Display application encounters an error.  Click on the "Settings" option/button to view additional details about the error.

  6. If a Filter Selection change is made while the hIOmon Disk I/O Ranger Display application is active (i.e., is running), then the hIOmon Disk I/O Ranger Display application will subsequently display the selected metrics for the new Observation Period.

  7. You can invoke/run more than one instance of the hIOmon Disk I/O Ranger Display application.  Each instance can be configured to display the current metrics for a different monitored item (i.e., file, process, logical disk, physical volume, or physical device).

Settings Display

The Settings Display includes the following display information and configuration options:

Note that the first percentage that is always shown for DTS Range Counts is described above.

Please note that the "OK" button must subsequently be clicked for any changes to these checkboxes to take effect within the Main Display. 

Monitored device/file.  Either a drop-down list box (that lists all of the "filters" included within the currently selected "Filter Selection" and from which you can select a specific filter to be removed) or a text input box (that enables you to enter a new filter which is to be either added to the currently selected Filter Selection or to a new Filter Selection) is displayed.  

A hIOmon "Filter Selection" specifies the particular files/devices that are to be monitored by the hIOmon I/O Monitor.  The Filter Selection is comprised of one or more "filters", each of which identifies the specific name of a device or file that is to be monitored by hIOmon.

Please note that those "filters" that are "exclusion" filters are identified with a gray background within the drop-down list box of filters that are present within the currently selected Filter Selection.  An "exclusion" filter is a filter whose file path name represents those files/directories that are explicitly excluded from being monitored by the hIOmon I/O Monitor (i.e., the hIOmon I/O Monitor will not collect any I/O operation performance metrics for those files/directories that have been explicitly excluded from being monitored by the hIOmon I/O Monitor). 

Add:  To add a new filter to an existing Filter Selection, first select the specific Filter Selection to which you want to add the new filter.  The currently selected Filter Selection is highlighted within the "Filter Selections:" drop-down list box as described below.

Then click on the "Add" button, after which a text input box will be displayed (instead of the drop-down box that shows all of the filters currently included within the selected Filter Selection).  Enter into this text box the filter that is to be added to the currently selected Filter Selection, then click upon the "Add" button again.  The hIOmon Disk I/O Ranger Display application will then immediately update the Filter Selection by adding the filter specified within the text input box.  The drop-down list box of filters will then be shown with the newly added filter.

To add the first filter to a Filter Selection being newly created, first click on the "Add" button, after which a text input box will be displayed (instead of the drop-down box listing the filters currently included within the selected Filter Selection).  Enter into this text box the filter that is to be included within the new Filter Selection to be created, then click upon the "New" button (rather than the "Add" button again).  The hIOmon Disk I/O Ranger Display application will then immediately create a new Filter Selection that includes the filter specified within the text input box.  The drop-down list box of filters will then be shown that includes the filter, and the new Filter Selection will become the currently selected Filter Selection.

When specifying the filter, you can enter, for example, the following to monitor all files upon Logical Drive "C:":  C:\*  (or simply enter the letter C, in which case the hIOmon Disk I/O Ranger Display application will automatically append the ":\*" wildcard indicator to the drive letter).

To monitor a specific file, enter the full file path name; for instance: C:\pagefile.sys

To monitor all files within a particular folder/directory, enter the full path name for the folder/directory followed by the wildcard indicator; for example: C:\Program Files\*

To monitor a specific physical device, enter the full device name (e.g., \Device\Harddisk0\DR0) or simply enter the letter of a Logical Drive associated with the physical device along with the physical device alias character (an exclamation mark: "!"); for example: C!

You can also simply enter the physical device number; for example, to monitor physical device \Device\Harddisk0\DR0, simply enter: DR0

To monitor a specific physical volume, you can simply the letter of a Logical Drive associated with the physical volume along with the physical volume alias character (a question mark: "?"); for example: C?

Also please note that the system may need to be rebooted as a result of adding a filter for a physical volume or a physical device.  If a system reboot is required, the hIOmon Disk I/O Ranger Display application will display a message saying that a system reboot is required.  Monitoring of the physical volume/device will not be successful until the restart/reboot is performed.     

Remove:  To remove a filter from a Filter Selection, first select (from within the "Filter Selections:" drop-down list box) the specific Filter Selection from which you want to remove the filter.

Then select the particular filter that you want to be removed from the drop-down list box that lists all of the "filters" included within the currently selected "Filter Selection".  After you have selected the particular filter to be removed, click on the "Remove" button.

The hIOmon Disk I/O Ranger Display application will then immediately update the selected Filter Selection by removing the filter that you selected.  Also note that the Filter Selection will automatically be deleted if the last filter within the Filter Selection is removed. 

DTS:  To enable or disable the collection of DTS summary metrics for a particular file or file path, first select (from within the "Filter Selections:" drop-down list box) the specific Filter Selection that contains the filter for the file or file path for which you want to enable or disable the collection of DTS summary metrics.

Then select the particular filter for which you want to enable or disable the collection of DTS summary metrics.  Those filters for which the collection of DTS summary metrics is enabled are highlighted with an almond background color.  To disable the collection of DTS summary metrics for such a filter, select the particular filter from within the drop-down list box of filters and then click on the "DTS" button located to the right of the "Remove" button.  The collection of DTS summary metrics will then immediately be disabled and the background color will change to white.  To enable the collection of DTS summary metrics for a filter (whose background color is white, which indicates that the collection of DTS summary metrics is not enabled for the filter), select the particular filter from within the drop-down list box of filters and then click on the "DTS" button; the collection of DTS summary metrics will then immediately be enabled for the filter and its background color will change to almond.  The "DTS" button can be used to toggle between DTS summary metrics collection enabled and disabled for a particular filter.

Please note that when the collection of DTS summary metrics is enabled (or disabled) for a filter that is included within the currently active/loaded Filter Selection, the Filter Selection must be reactivated/loaded in order for the DTS summary metrics enable/disable to take effect.

Also note that:

The options to configure the user-specified data transfer sizes within a Filter Selection and to enable/disable the collection of DTS summary metrics for processes are not supported by the hIOmon Disk I/O Ranger Display application; however, other hIOmon clients (e.g. the hIOmon Presentation Client, the hIOmon WMI Browser, etc.) that are included within the hIOmon I/O Performance Monitor software package do provide the ability to configure the Filter Selection user-specified data transfer sizes and to enable/disable the collection of DTS summary metrics for specific processes.

Please note again that the Add, Remove, or DTS request is performed immediately upon the selected Filter Selection when you click upon the respective button.

  • Filter Selections:  This drop-down list box contains the names of all of the Filter Selections currently available.  The currently loaded/active Filter Selection is identified by its name in red text.   The currently selected Filter Selection is highlighted with a green background.  The Filter Selection that is the default Filter Selection is identified with a gray background; the hIOmon Manager software component loads the "default" Filter Selection (if any) automatically each time the system is started.  An almond background color is used for a Filter Selection that is both the default and currently selected Filter Selection. 

    Load:  To load/activate a specific Filter Selection, first select the respective Filter Selection within the drop-down list box, then click on the "Load" button.  The selected Filter Selection will then be immediately activated.  Please note that all of the summary metrics will subsequently be reset to zeroes as a result of loading/activating the Filter Selection; in addition, a new Observation Period will begin.

    The list of names for those monitored items for which there are Performance Threshold Range Metrics available for display will also change as a result of loading/activating the Filter Selection.  That is, those monitored items whose metrics were collected for the prior activated Filter Selection will subsequently be removed from this list of names so that only those monitored items for which there are Performance Threshold Range Metrics available for display based upon the currently loaded Filter Selection will be included within the list.  Please see the "Metrics for monitored:" description above for how to refresh the list of names of monitored items for which there are Performance Threshold Range Metrics available for display.

    Also please note that the system may need to be rebooted if the Filter Selection to be loaded/activated contains filters that specify a physical volume or a physical device to which the hIOmon I/O Monitor is not currently attached.  If a system reboot is required, the hIOmon Disk I/O Ranger Display application will display a message saying that a system reboot is required.  The loading/activation of the specified Filter Selection and the monitoring of the physical volume/device will not be successful until the restart/reboot is performed. 

    Delete:  To explicitly delete a specific Filter Selection, first select the respective Filter Selection withinthe drop-down list box, then click on the "Delete" button.  The selected Filter Selection will then be immediately deleted and removed from list of currently available/present Filter Selections shown within the drop-down list box.  Please note that new Filter Selections can be added by using the "New" button described below.

    Default:  To assign a specific Filter Selection as the "default" Filter Selection, first select the respective Filter Selection within the drop-down list box, then click on the "Default" button.  The selected Filter Selection will then be immediately assigned as the new "default" Filter Selection.

  • New Filter Selection name:  This text box enables you to enter the name of the new Filter Selection that is to be created.

    To create a new Filter Selection, first click on the "Add" button associated with the "Monitored device/file:" options, after which a text input box will be displayed (instead of the drop-down box listing the filters currently included within the selected Filter Selection).  Enter a "filter" (i.e., the specific name of a device or file) that is to be included within the Filter Selection to be created; see the "Add" button above for a description of valid filter names. 

    Then enter the name of the new Filter Selection within this "New Filter Selection name:" text input box, and then finally click on the "New" button.  The Filter Selection (that includes the specified filter and requests that both read and write I/O operations be monitored) will then be immediately created and added to the list of Filter Selections currently shown within the Filter Selections drop-down box.  In addition, this newly created Filter Selection will become the currently selected Filter Selection, and the drop-down list box of filters will appear for this Filter Selection (this drop-down list box will include the filter that you specified as part of creating the new Filter Selection). 

    You can subsequently add additional filters to this new Filter Selection by using the "Add" button described above.

    Please note that a new Filter Selection must subsequently be loaded/activated in order for monitoring to be performed in accordance with this new Filter Selection.  That is, until this new Filter Selection is loaded/activated, the monitoring of I/O operations by the hIOmon I/O Monitor will continue to be performed based upon the currently loaded/activated Filter Selection.

  • Max Allowed File Count.  This input text field enables you to specify the maximum number of files for which the hIOmon I/O Monitor can concurrently maintain I/O operation performance metrics.  This configurable parameter basically lets you control the maximum number of files that the hIOmon I/O Monitor is allowed to concurrently monitor.

    Note that the hIOmon I/O Monitor will record a System Event Log entry in the event that the monitoring of an additional file (or directory) would exceed the maximum allowed by this configurable parameter.  An error message will also be displayed within the Settings Display if the hIOmon Disk I/O Ranger Display application detects that the maximum allowed number has been reached. 

    The value entered for the new maximum allowed number of files to be monitored concurrently must be a number greater than zero.  Please note that the "OK" button must subsequently be clicked for this new value to take effect.

    Note that the new maximum value will be put into effect asynchronously by the hIOmon I/O Monitor such that it might take several minutes to actually take effect.

  • Export metrics to file:  This option enables you to export/save Performance Threshold Range Metrics to a file; the particular metrics that you select are written to the specified export file each time the "Main Display" is refreshed.

    The text input box enables you to enter the name of the export file to which the metrics will be written.  Simply enter the file name for the export file; the hIOmon Disk I/O Ranger Display application will automatically append a file extension of ".csv" (for the "Comma-Separated-Values" format of the export file) and the file will reside within the same folder/directory from which the hIOmon Disk I/O Ranger Display application was started.

    Select metrics to include:  Located to the right of the text box (that contains the file name of the export file) is a drop-down list box that shows the names of the various Performance Threshold Range Metric types that can be included within the export file.

    Select a particular Performance Threshold Range Metric to have it included within the export file; those specific Performance Threshold Range Metrics that are to be included within the export file are highlighted with a green background.

    The hIOmon Disk I/O Ranger Display application determines that a specific Performance Threshold Range Metric is to be selected (i.e., included within the export file) or unselected (i.e., not included within export file) when there is a change of the selected item within the drop-down list box.

    For example, say that you first click upon the "Date" item within the drop-down list box (so consequently its background becomes green, which indicates that this item will be included within the metrics written to the export file).

    If you then click upon the "Reads" item within the drop-down box, then the background color of this item will change to green, again an indication that this particular item is to be included within the metrics written to the export file.  If you next click upon the "Reads" item again, nothing will change.  However, if you then click upon another item (i.e., other than the "Reads" selection item) with the drop-down list box, for instance, the "Read Xfer", then the "Read Xfer" item will become highlighted with a green background and the corresponding total amount of data (in bytes) transferred by the read I/O operations will also be included within the export file.

    Note that if you then go back and click upon an already selected item (e.g., the "Date" item), this selected item will consequently become "unselected" (i.e., it will not be included within the export file) and its background will return to white (rather than green).

    There are two special items within the drop-down list box:  SelectALL and SelectDisplayedRCtypes. 

    The SelectALL item allows you to select all of the Performance Threshold Range Metrics (i.e., all of the Performance Threshold Range Metrics within the drop-down list box) simultaneously.  Conversely, if the SelectALL item is clicked when it has been selected (i.e., it has a green background), then all of the Performance Threshold Range Metrics within the drop-down list box will immediately become "unselected" (will return to a white background) and so will not be included within the export file.

    The SelectDisplayedRCtypes item allows you to select (for inclusion within the export file) all of the Performance Threshold Range Metrics that are associated with the particular Range Count metrics which have been chosen to be shown with the Main Display.  For example, if the Read Range Counts IOPS and MBs checkboxes are checked for display within the Main Display, then clicking upon the "SelectDisplayedRCtypes" item will result in all of the respective Read IOPS and MBs Range Count metrics being selected for inclusion within the export file (and so will be highlighted with a green background).

    The " Date" selection item represents the current date/time when the metrics were written to the export file.

    The "Name" selection item represents the name of the file, device, or process to which the exported Performance Threshold Range Metrics pertain.

    The "Reads", "Writes", and "Reads/Writes" selection items represent the total number of read I/O operations, write I/O operations, and the combined read and write I/O operations respectively.

    Similarly, the "Read Xfer", "Write Xfer", and "Read/Write Xfer" selection items represent the associated total amount of data transferred (in bytes) by the read I/O operations, write I/O operations, and combined read and write I/O operations respectively.

    The remaining selection items correspond to the various Performance Threshold Range Metrics that can be displayed within the Main Display as described above.

    Also note that the selection items that have either an "IOP", "Xfer", and "RAN" appended to the Performance Threshold Range Metric name represent the extended display options as described above.

    For example, in the case of the "Read IOPS 100-499 IOP" selection item, the exported metric is the total number of Read I/O operations that were observed within the corresponding "Read IOPS 100-499" range.  Similarly the "Write MBs 1<10 Xfer" selection item, for instance, represents the export metric that reflects the actual total number of data bytes transferred by Write I/O operations that were observed within the corresponding "Write MBs 1<10" range.         

    Please note the following:

    Start  The Start button allows you to enable/activate the exporting of the selected Performance Threshold Range Metrics to the specified export file.  Please note that only one export file can be active at the same time.

    The current values of the Performance Threshold Range Metrics that were selected to be included within the active export file will be written to the activated export file with each periodic refresh of the Main Display.  The selected Performance Threshold Range Metric items will be displayed in red text when the export file is enabled for exporting. 

    The "Start" button will change to the "Stop" button immediately after the specified export file has been successfully enabled for exporting.  Click on the "Stop" button to disable further exporting to the export file; the "Stop" button will change back to the "Start" button after exporting to the export file has been successfully disabled.  Exporting to the export file will continue to be stopped until the "Start" button is again clicked.

    The "Delete" button allows you to delete the specified export file (as indicated by the file name entered into the text box that contains the file name of the export file).  A currently started/activated export file must first be stopped before deleting the export file. 

  • OK Button.  Click on the "OK" button to immediately activate the configuration changes described above (e.g., the "Device/File/Process Names" and "Seconds between refreshes" configuration options).  Please note that if you click on the "OK" button without making any configuration changes, then the "Settings" display window will simply close and the operation of the hIOmon Disk I/O Ranger Display application will continue without any change.

    Also please note that the configuration changes are persistent.  That is, the configuration options will be saved so that they will automatically be used the next time that you start/invoke the hIOmon Disk I/O Ranger Display application.

  • Cancel Button.  Click on the "Cancel" button to close the "Settings" display without activating/saving any of the changes that you have made to the configuration option input fields; that is, any such entered changes that have not yet been performed will be ignored.

  • Error Messages

    The following error messages can be displayed by the hIOmon Disk I/O Ranger Display application:

    This can also occur if the summary I/O operation performance metrics for the monitored item have been offloaded to the hIOmon Manager service and there has been no subsequent monitored I/O operation activity to the monitored item.  Please note that in this case, summary I/O operation performance metrics will again be available for display upon the subsequent resumption of I/O operation activity to/by the monitored item.

    When the hIOmon Manager has detected that the expiration date has been reached, it will write an entry (Event ID 499, Source hIOmonGr) to the Application Event Log noting that the trial use of the hIOmon software has expired; the hIOmon Manager will then terminate its processing.

    Copyright © 2011-2013  hyperI/O LLC.  All Rights Reserved.