4.13 HostDiskIO

Use this Knowledge Script to monitor disk reads/writes for a host. This script raises an event if the amount of reads/writes in megabytes per second exceeds the threshold you set. This script monitors and collects data for the following performance metrics:

  • Disk read rate - Rate at which data is read from each LUN (logical unit number) on the host

  • Disk write rate - Rate at which data is written to each LUN (logical unit number) on the host

  • Total disk I/O

This script generates a pair of data streams for each disk that is configured on a host.

NOTE:

  • When a host goes into maintenance mode all VirtualCenter_Host* Knowledge Scripts, except for the VirtualCenter_HostConnected Knowledge Script, suppress events and data.

  • In rare situations, queries to the ESX host might fail with timeouts because the ESX host stops responding. This issue affects all VirtualCenter_Host* Knowledge Scripts. You can work around this issue by restarting the management service on the ESX host.

4.13.1 Resource Object

vSphere ESX or ESXi host

4.13.2 Default Schedule

By default, this script runs every 15 minutes.

4.13.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

Event Notification

Raise event when total disk IO exceeds the threshold?

Select Yes to raise an event when total disk IO exceeds the threshold you set. The default is unselected.

Event severity when total disk IO exceeds threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which total disk IO exceeds the threshold. The default is 15.

Raise event when disk reads exceed the threshold?

Select Yes to raise an event if the amount of disk reads exceeds the threshold you set. The default is Yes.

Event severity when disk reads exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the amount of disk reads exceeds the threshold. The default is 15.

Raise event when disk writes exceed the threshold?

Select Yes to raise an event if the amount of disk writes exceeds the threshold you set. The default is Yes.

Event severity when disk writes exceed threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the amount of disk writes exceeds the threshold. The default is 15.

Raise event when disk IO metrics are not available

Select Yes to raise an event if the disk IO metrics are not available. The default is Yes.

Event severity when disk IO metrics are not available

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the disk IO metrics are not available. The default is 15.

Event severity when AppManager failed to get metrics

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager failed to retrieve metrics from vCenter. The default is 15.

Event severity when AppManager failed to log in

Set the event severity level, from 1 to 40, to indicate the importance of an event in which AppManager failed to log in to vCenter. The default is 5.

Event severity when HostDiskIO job fails unexpectedly

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the HostDiskIO job fails unexpectedly. The default is 5.

Data Collection

Collect data for total disk IO?

Select Yes to collect data for charts and reports. When enabled, data collection returns the amount of total disk IO. The default is unselected.

Collect data for disk reads?

Select Yes to collect data for charts and reports. When enabled, data collection returns the amount of disk reads. The default is unselected.

Collect data for individual disk reads?

Select Yes to collect data for charts and reports. When enabled, data collection returns the amount of individual disk reads. The default is unselected.

Collect data for disk writes?

Select Yes to collect data for charts and reports. When enabled, data collection returns the amount of disk writes in megabytes per second. The default is unselected.

Collect data for individual disk writes?

Select Yes to collect data for charts and reports. When enabled, data collection returns the amount of individual disk writes in megabytes per second. The default is unselected.

Monitoring

Maximum threshold for total disk IO (MBytes/sec)

Specify the maximum amount of total disk IO that can occur before an event is raised. The default is 20 megabytes per second.

Maximum threshold for disk reads (MBytes/sec)

Specify the maximum amount of disk reads that can occur before an event is raised. The default is 2 megabytes per second.

Maximum threshold for disk writes (MBytes/sec)

Specify the maximum amount of disk writes that can occur before an event is raised. The default is 2 megabytes per second.