4.31 VmDiskUsage

Use this Knowledge Script to monitor logical disk usage for a virtual machine. This script raises an event when the disk usage exceeds the threshold you set.

This Knowledge Script cannot monitor the logical disk usage for a virtual machine when the virtual machine’s disk is a mounted drive.

NOTE:

  • If the parent host of the monitored virtual machine is in maintenance mode, this Knowledge Script will not generate events.

  • Using this script and other VirtualCenter_Vm* scripts to monitor a large number of virtual machines at the same time might cause the jobs to fail. If the jobs fail on a regular basis, consider running the VirtualCenter_Vm* scripts on fewer virtual machines.

4.31.1 Resource Object

vSphere virtual machine

4.31.2 Default Schedule

By default, this script runs every 15 minutes.

4.31.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

General Settings

Job Failure Notification

Raise event when disk metrics are not available?

Select Yes to raise an event when disk metrics are not available. The default is unselected.

Event severity when disk metrics are not available

Set the event severity level, from 1 to 40, to indicate the importance of an event in which disk 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 get metrics. 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. The default is 5.

Event severity when VMDiskUsage job fails unexpectedly

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

Additional Settings

Event Details

Event detail format

Select either HTML Table or Plain Text as the format for event detail. The default is HTML Table.

Monitor Logical Disk Usage

Event Notification

Raise event if logical disk free space falls below the threshold

Select Yes to raise an event when logical disk free space falls below the threshold you set. The default is Yes.

Unit type

Select whether to measure the amount of logical disk free space in Percent, MBytes, or GBytes. The default is MBytes.

Threshold -- Minimum logical disk free space available

Specify the minimum amount of logical disk free space that can be available before an event is raised. The default is 500 MBytes.

Event severity when logical disk free space falls below the threshold

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

Raise event if logical disk space usage exceeds the threshold

Select Yes to raise an event when logical disk space usage exceeds the threshold you set. The default is Yes.

Unit type

Select whether to measure the amount of disk space usage in Percent, MBytes, or GBytes. The default is Percent.

Threshold -- Maximum logical disk space usage

Specify the amount of logical disk space usage that can occur before an event is raised. The default is 80 percent.

Event severity when logical disk space usage exceeds the threshold

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

Data Collection

Collect data for logical disk free space?

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

Collect data for logical disk space usage?

Select Yes to collect data about logical disk space usage for charts and reports. The default is unselected.