Veeam VMware: Datastore Cluster Free Space Analysis

Veeam.Virt.Extensions.VMware.VMDSCLUSTER.Monitor.FreeSpace (UnitMonitor)

Knowledge Base article:

Summary

This monitor tracks threshold breaches for the following metrics:

Warning and Error thresholds are available for both metrics. Alert severity is calculated as the worst state of any metric.

This is a 'Top N' monitor - the top datastores for Free GB will be listed in the alert description.

Configuration

The monitor is enabled by default. You can override the following parameters:

Name

Default Value

Description

usedPctThresholdWarn

90

Specifies a threshold for the datastore cluster space usage. If the space usage value exceeds the threshold, the monitor will change its state to 'Warning'.

usedPctThresholdCritical

95

Specifies a threshold for the datastore cluster space usage. If the space usage value exceeds the threshold, the monitor will change its state to 'Error'.

FreeGBThresholdWarn

50

Specifies a threshold for the datastore cluster free space. If the free space value drops below the threshold, the monitor will change its state to 'Warning'.

FreeGBThresholdCritical

10

Specifies a threshold for the datastore cluster free space. If the free space value drops below the threshold, the monitor will change its state to 'Error'.

Instance Count

5

Defines the number of Top N child objects to display in the alert.

Note: If you have configured several overrides of the same type, select the Enforced check box for an override that should have priority over all other overrides.

Causes

Threshold breach(es) for these metrics indicate that the datastore cluster is overall low on free space.

Resolutions

Availability of the VMFS datastore is critical for all operations related to virtual machines.

Below are the VMware-recommended minimal limits (per-datastore); this monitor can be overridden to accommodate your specific requirements.

If the datastore usage has breached these thresholds, then immediate action should be taken to free space, or disk corruption issues can occur.

Use the Alerts View to see all current open issues for this object. Use the Events View to review any error and warning events for this object. Open a Performance View to see the performance metrics for this object and all contained objects. Open a Diagram View to analyse the relationships of this object to other components.

Potential Issues

There follows a list of problems that can affect virtual machines when the datastore is full/approaching full:

If a VMFS datastore is full, the following remedial actions can be taken:

External

See the Help Center for more information including reference lists of all Rules and Monitors and full set of User Guides for the Veeam MP for VMware.

See the VMware Online Documentation for more information on VMware vSphere, in particular:

Element properties:

TargetVeeam.Virt.Extensions.VMware.VMDSCLUSTER
Parent MonitorSystem.Health.AvailabilityState
CategoryAvailabilityHealth
EnabledTrue
Alert GenerateTrue
Alert SeverityMatchMonitorHealth
Alert PriorityNormal
Alert Auto ResolveTrue
Monitor TypeVeeam.Virt.Extensions.VMware.AdvancedPerformance.DSClusterFreeSpace.3State2MetricMonitorType
RemotableTrue
AccessibilityPublic
Alert Message
Veeam VMware: Datastore Cluster Free Space Analysis
Datastore Cluster {0} has breached the free space threshold.

Datastore Cluster is currently overall {1}\% used, with {2} GB space remaining.

Free space for the Bottom {3} member Datastores in this Cluster -
Datastore Name - Free Space GB
{4}
RunAsDefault

Source Code:

<UnitMonitor ID="Veeam.Virt.Extensions.VMware.VMDSCLUSTER.Monitor.FreeSpace" Accessibility="Public" Enabled="onEssentialMonitoring" Target="VeeamVEVMwareLib!Veeam.Virt.Extensions.VMware.VMDSCLUSTER" ParentMonitorID="SystemHealth!System.Health.AvailabilityState" Remotable="true" Priority="Normal" TypeID="Veeam.Virt.Extensions.VMware.AdvancedPerformance.DSClusterFreeSpace.3State2MetricMonitorType" ConfirmDelivery="true">
<Category>AvailabilityHealth</Category>
<AlertSettings AlertMessage="Veeam.Virt.Extensions.VMware.VMDSCLUSTER.Monitor.FreeSpace_AlertMessageResourceID">
<AlertOnState>Warning</AlertOnState>
<AutoResolve>true</AutoResolve>
<AlertPriority>Normal</AlertPriority>
<AlertSeverity>MatchMonitorHealth</AlertSeverity>
<AlertParameters>
<AlertParameter1>$Target/Property[Type="System!System.Entity"]/DisplayName$</AlertParameter1>
<AlertParameter2>$Data/Context/DataItem/Property[@Name='Custom1']$</AlertParameter2>
<AlertParameter3>$Data/Context/DataItem/Property[@Name='RollupValue']$</AlertParameter3>
<AlertParameter4>$Data/Context/DataItem/Property[@Name='InstanceCount']$</AlertParameter4>
<AlertParameter5>$Data/Context/DataItem/Property[@Name='RelatedInstances']$</AlertParameter5>
</AlertParameters>
</AlertSettings>
<OperationalStates>
<OperationalState ID="Red" MonitorTypeStateID="Red" HealthState="Error"/>
<OperationalState ID="Yellow" MonitorTypeStateID="Yellow" HealthState="Warning"/>
<OperationalState ID="Green" MonitorTypeStateID="Green" HealthState="Success"/>
</OperationalStates>
<Configuration>
<usedPctThresholdWarn>90</usedPctThresholdWarn>
<usedPctThresholdCritical>95</usedPctThresholdCritical>
<FreeGBThresholdWarn>50</FreeGBThresholdWarn>
<FreeGBThresholdCritical>10</FreeGBThresholdCritical>
<FilterExpression>
<And>
<Expression>
<SimpleExpression>
<ValueExpression>
<XPathQuery Type="String">Property[@Name='entityId']</XPathQuery>
</ValueExpression>
<Operator>Equal</Operator>
<ValueExpression>
<Value Type="String">$Target/Property[Type="VeeamVEVMwareLib!Veeam.Virt.Extensions.VMware.VMDSCLUSTER"]/id$</Value>
</ValueExpression>
</SimpleExpression>
</Expression>
<Expression>
<SimpleExpression>
<ValueExpression>
<Value Type="String">$Target/Property[Type="VeeamVEVMwareLib!Veeam.Virt.Extensions.VMware.VMDSCLUSTER"]/capacity$</Value>
</ValueExpression>
<Operator>NotEqual</Operator>
<ValueExpression>
<Value Type="String">0</Value>
</ValueExpression>
</SimpleExpression>
</Expression>
</And>
</FilterExpression>
<InstanceCount>5</InstanceCount>
<DSClusterID>$Target/Property[Type="VeeamVEVMwareLib!Veeam.Virt.Extensions.VMware.VMDSCLUSTER"]/id$</DSClusterID>
</Configuration>
</UnitMonitor>