vApp. Top (Bottom) N Contained Objects or Instances

Veeam.Virt.Extensions.VMware.Performance.Reports.TopBottomByVApp.LR (LinkedReport)

This report aggregates historical performance data for child vApps, resource pools and virtual machines in selected vApps. The report shows top or bottom objects for a specific performance counter across a time range.

Knowledge Base article:

Summary

Description:

The vApp. Top (Bottom) N Contained Objects or Instances report is a linked report that is based on the Veeam Performance Top (Bottom) N Report from the Veeam Extended Generic Report Library.

The report features a predefined list of VM guest, resource pool and vApp performance counters. The object picker control for the report scope has a predefined filter which limits selection to Objects of the VMware Virtual Application class and Groups that include objects of the VMware Virtual Application class.

Parameters:

Date/time Selection: defines the time period to analyze in the report.

Algorithm: defines whether top or bottom performing objects and/or performance counter instances will be displayed in the report.

Count: defines the number of top or bottom objects and/or performance counter instances that will be included in the report. The value can range between 1 and 200.

Group by: defines how data will be grouped in the report (by Object, Counter Instance or Object and Counter Instance).

Scope: defines a list of Groups or Objects to analyze in the report. The Add Group option returns a Group and all objects that a group contains (with all performance counter instances). The Add Object option returns only the selected object.

Counter: defines a collection rule for a performance counter to analyze in the report.

Sample Usage:

Report on top 10 virtual machines that have the highest CPU usage for the selected vApps during this week.

Instructions:

Open the vApp. Top (Bottom) N Contained Objects or Instances report.
From the From list, choose 'This Week > Monday'. From the To list, choose 'This Week > Friday'.

From the Algorithm list, choose 'Top'.
In the Count field, type '10'.

From the Group by list, choose 'Object'.
In the Scope section, click Add Group. Click Search and select the necessary vApps. Click Add and click OK.
From the Counter list, select 'VMGuest-cpu\cpuUsedPct (VMGUEST.Collect.cpuUsedPct)'.
Click Run to view the report.

Report Output:

The report will show 10 VMs with the greatest CPU usage level. The chart will display the following details for every VM: average CPU usage and the minimum-to-maximum CPU usage range for the selected period. The table will display additional details for every VM: VM name, sample count, minimum, maximum and average CPU usage values, and standard deviation.

Note: If several objects have the same ranking function value, the report will include more objects than you have set in the Count field. For example, the 'bottom 10' report will show 11 objects if two objects 'share' the same position (have the same value).

You can click VM names in the output table to drill down to the Veeam Performance Details Report.

Element properties:

Base	Veeam.Report.Library.GenericPerformanceTopBottom.report
Target	Veeam.Virt.Extensions.VMware.VMVAPP
Accessibility	Public
Visible	True

Source Code:

<LinkedReport ID="Veeam.Virt.Extensions.VMware.Performance.Reports.TopBottomByVApp.LR" Accessibility="Public" Base="VeeamReportLibrary!Veeam.Report.Library.GenericPerformanceTopBottom.report" Visible="true" Target="VeeamVirtExtensionsVMwareLibrary!Veeam.Virt.Extensions.VMware.VMVAPP">

  <Dependencies>

    <ReportParameterControl>MicrosoftSystemCenterDataWarehouseReportLibrary!Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.ComboBox</ReportParameterControl>

    <ReportParameterControl>MicrosoftSystemCenterDataWarehouseReportLibrary!Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.MonitoringObjectXmlPicker</ReportParameterControl>

    <ReportParameterControl>MicrosoftSystemCenterDataWarehouseReportLibrary!Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.NumericUpDown</ReportParameterControl>

    <ReportParameterControl>MicrosoftSystemCenterDataWarehouseReportLibrary!Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.RelativeDateTimePicker</ReportParameterControl>

  </Dependencies>

  <ParameterBlock xmlns="http://schemas.microsoft.com/mom/reporting/2007/ReportParameterSettings" columns="2">

    <Controls>

      <Control type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.RelativeDateTimePicker" rowSpan="1">

        <ReportParameters>

          <ReportParameter name="TZ" binding="TimeZone">

            <Prompt>Veeam.Report.Library!Veeam.Report.Library.ParameterPrompt.Timezone</Prompt>

          </ReportParameter>

          <ReportParameter name="TZName" binding="TimeZoneName"/>

          <ReportParameter name="DSBaseType" binding="StartDate_BaseType"/>

          <ReportParameter name="DSBaseValue" binding="StartDate_BaseValue">

            <Prompt>Veeam.Report.Library!Veeam.Report.Library.ParameterPrompt.From</Prompt>

          </ReportParameter>

          <ReportParameter name="DSOffsetType" binding="StartDate_OffsetType"/>

          <ReportParameter name="DSOffsetValue" binding="StartDate_OffsetValue"/>

          <ReportParameter name="DFBaseType" binding="EndDate_BaseType"/>

          <ReportParameter name="DFBaseValue" binding="EndDate_BaseValue">

            <Prompt>Veeam.Report.Library!Veeam.Report.Library.ParameterPrompt.To</Prompt>

          </ReportParameter>

          <ReportParameter name="DFOffsetType" binding="EndDate_OffsetType"/>

          <ReportParameter name="DFOffsetValue" binding="EndDate_OffsetValue"/>

        </ReportParameters>

      </Control>

      <Control type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.MonitoringObjectXmlPicker" rowSpan="2">

        <ReportParameters>

          <ReportParameter name="Objects">

            <Prompt>Veeam.Report.Library!Veeam.Report.Library.ParameterPrompt.Scope</Prompt>

          </ReportParameter>

          <ReportParameter name="ManagementGroup" binding="GroupList"/>

        </ReportParameters>

        <Properties>

          <Property name="TypeFilter">

            <Value>Veeam.Virt.Extensions.VMware.VMVAPP</Value>

          </Property>

        </Properties>

      </Control>

      <Control type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.ComboBox">

        <ReportParameters>

          <ReportParameter name="Algorithm">

            <Prompt>Veeam.Report.Library!Veeam.Report.Library.ParameterPrompt.Algorithm</Prompt>

          </ReportParameter>

        </ReportParameters>

      </Control>

      <Control type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.NumericUpDown">

        <ReportParameters>

          <ReportParameter name="TopCount">

            <Prompt>Veeam.Report.Library!Veeam.Report.Library.ParameterPrompt.Count</Prompt>

          </ReportParameter>

        </ReportParameters>

        <Properties>

          <Property name="Minimum">

            <Value>1</Value>

          </Property>

          <Property name="Maximum">

            <Value>200</Value>

          </Property>

        </Properties>

      </Control>

      <Control type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.ComboBox" rowSpan="2">

        <ReportParameters>

          <ReportParameter name="LinkedRuleId">

            <Prompt>Veeam.Report.Library!Veeam.Report.Library.ParameterPrompt.Counter</Prompt>

          </ReportParameter>

        </ReportParameters>

      </Control>

      <Control type="Microsoft.SystemCenter.DataWarehouse.Report.ParameterControl.ComboBox">

        <ReportParameters>

          <ReportParameter name="GroupBy">

            <Prompt>Veeam.Report.Library!Veeam.Report.Library.ParameterPrompt.Groupby</Prompt>

          </ReportParameter>

        </ReportParameters>

      </Control>

    </Controls>

  </ParameterBlock>

  <Parameters>

    <Parameter Name="Report_SystemName">

      <Value>Veeam.Virt.Extensions.VMware.Performance.Reports.TopBottomByVApp.LR</Value>

    </Parameter>

    <Parameter Name="ReportMode">

      <Value>1</Value>

    </Parameter>

    <Parameter Name="RuleId">

      <Value>00000000-0000-0000-0000-000000000000</Value>

    </Parameter>

    <Parameter Name="SortFunction">

      <Value>Avg</Value>

    </Parameter>

    <Parameter Name="InstanceList">

      <Value>---ALL---</Value>

    </Parameter>

    <Parameter Name="LicCheckParameter">

      <Value>True</Value>

    </Parameter>

  </Parameters>

</LinkedReport>