Veeam VMware: vAPP CPU Usage Analysis

Veeam.Virt.Extensions.VMware.VMVAPP.Monitor.cpuUsedPct (UnitMonitor)

Knowledge Base article:

Summary

This vAPP has breached the threshold for CPU percent usage.

This is a 'Top N' monitor - the top virtual machines for CPU usage in this vAPP will be listed in the alert description.

Configuration

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

Name	Default Value	Description
Threshold1	90	Specifies a threshold for the vApp CPU usage. If the CPU usage value exceeds the threshold, the monitor will change its state to 'Warning'.
Threshold2	95	Specifies a threshold for the vApp CPU usage. If the CPU usage value exceeds the threshold, the monitor will change its state to 'Error'.
Num Samples	1	Specifies the number of datapoints whose average value should exceed the CPU usage threshold for the monitor to fire an alert.
TopN	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

One or more virtual machines within the vAPP have demanded CPU which has pushed the total pool usage over the threshold. This is calculated as the total CPU usage of all VMs in the vAPP, divided by the Limit of the vAPP, and expressed as a percentage.

Resolutions

Check for unexpected high CPU demands from VMs in the vAPP. If the VM resource demand is normal, then consider changing the Limit on the vAPP, or re-distributing VMs to other vAPPs or even other clusters.

Ops Mgr 2012 and 2016 customers can use the in-context dashboards, available in the Navigation section of the Tasks pane, to drill down into historical performance data and current alerts. These dashboards will show relevant metrics for this object and for contained objects, and further dashboards will become available by selecting within the dashboard. Drill-down from dashboard to dashboard to arrive at the detailed metrics that can assist in finding root-cause.

In particular the vAPP CPU Analysis dashboard will show historical data for the usage of this vAPP, and in-context data for all the VMs which are part of the vAPP. Review the resource usage and drill-down into Alert details and VM-specific dashboards to understand the resource demands of the VMs.

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 analyze the relationships of this object to other components.

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:

Target

Veeam.Virt.Extensions.VMware.VMVAPP

Parent Monitor

System.Health.PerformanceState

Category

PerformanceHealth

Enabled

True

Alert Generate

True

Alert Severity

MatchMonitorHealth

Alert Priority

Normal

Alert Auto Resolve

True

Monitor Type

Veeam.Virt.Extensions.VMware.TopNPerformance.ResourcePool.MonitorType

Remotable

True

Accessibility

Public

Alert Message

Veeam VMware: vAPP CPU Usage Analysis

The vAPP {0} has breached a usage threshold by using {1} \% CPU.
Total CPU usage for the vAPP is {2} MHz from a limit of {3} MHz.

{4}

RunAs

Default

Source Code:

<UnitMonitor ID="Veeam.Virt.Extensions.VMware.VMVAPP.Monitor.cpuUsedPct" Accessibility="Public" Enabled="onEssentialMonitoring" Target="VeeamVEVMwareLib!Veeam.Virt.Extensions.VMware.VMVAPP" ParentMonitorID="SystemHealth!System.Health.PerformanceState" Remotable="true" Priority="Normal" TypeID="Veeam.Virt.Extensions.VMware.TopNPerformance.ResourcePool.MonitorType" ConfirmDelivery="true">

  <Category>PerformanceHealth</Category>

  <AlertSettings AlertMessage="Veeam.Virt.Extensions.VMware.VMVAPP.Monitor.cpuUsedPct_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='CpuUsedPct']$</AlertParameter2>

      <AlertParameter3>$Data/Context/DataItem/Property[@Name='CpuUsageMhz']$</AlertParameter3>

      <AlertParameter4>$Target/Property[Type="VeeamVEVMwareLib!Veeam.Virt.Extensions.VMware.VMVAPP"]/cpuLimit$</AlertParameter4>

      <AlertParameter5>$Data/Context/DataItem/Property[@Name='RelatedInstances']$</AlertParameter5>

    </AlertParameters>

  </AlertSettings>

  <OperationalStates>

    <OperationalState ID="UnderThreshold1" MonitorTypeStateID="UnderThreshold1" HealthState="Success"/>

    <OperationalState ID="OverThreshold1UnderThreshold2" MonitorTypeStateID="OverThreshold1UnderThreshold2" HealthState="Warning"/>

    <OperationalState ID="OverThreshold2" MonitorTypeStateID="OverThreshold2" HealthState="Error"/>

  </OperationalStates>

  <Configuration>

    <ObjectName>VMVApp-cpu</ObjectName>

    <CounterName>cpuUsedPct</CounterName>

    <Value>$Data/Property[@Name='cpuUsedPct']$</Value>

    <Threshold1>90</Threshold1>

    <Threshold2>95</Threshold2>

    <FilterExpression>

      <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.VMVAPP"]/id$</Value>

        </ValueExpression>

      </SimpleExpression>

    </FilterExpression>

    <NumSamples>1</NumSamples>

    <TopN>5</TopN>

    <ResPoolID>$Target/Property[Type="VeeamVEVMwareLib!Veeam.Virt.Extensions.VMware.VMVAPP"]/id$</ResPoolID>

    <Type>CPU</Type>

    <TargetType>vapp</TargetType>

  </Configuration>

</UnitMonitor>