4.12 HostDataStoreUsage

Use this Knowledge Script to monitor the datastore usage of all datastores connected to a host. This script raises an event when the percentage of available datastore free space falls below the threshold or when the percentage of used datastore free space exceeds the threshold.

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 or ESXi host might fail with timeouts because the ESX or ESXi 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 or ESXi host.

4.12.1 Resource Object

vSphere ESX or ESXi host

4.12.2 Default Schedule

By default, this script runs every three hours.

4.12.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

Event Notification

Raise event when available free space falls below the threshold?

Select Yes to raise an event if the amount of datastore free space falls below the threshold you set. The default is Yes.

Event severity when available free space falls below the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the amount of available free space falls below the threshold. The default is 15.

Raise event when the percentage of used Datastore exceeds the threshold

Select Yes to raise an event if the percentage of used datastore exceeds the threshold you set. The default is Yes.

Event severity when percentage of used Datastore exceeds the threshold

Set the event severity level, from 1 to 40, to indicate the importance of an event in which the percentage of used datastore exceeds the threshold. The default is 15.

Raise event when datastore metrics are not available?

Select Yes to raise an event if datastore metrics are not available. The default is unselected.

Event severity when datastore metrics are not available

Set the event severity level, from 1 to 40, to indicate the importance of an event in which datastore 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 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 HostDataStoreUsage job fails unexpectedly

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

Data Collection

Collect data for free space?

Select Yes to collect data about available datastore free space for charts and reports. The default is unselected.

Collect data for percentage used?

Select Yes to collect data about the percentage of used datastore for charts and reports. The default is unselected.

Monitoring

Minimum threshold for available datastore free space (MB)

Specify the minimum amount of datastore free space that must be available to prevent an event from being raised. The default is 500 megabytes.

Maximum threshold for datastore percentage used (%)

Specify the maximum amount of datastore that can be used before an event is raised. The default is 90%.