# Data Object - VirtualMachineQuickStats(vim.vm.Summary.QuickStats)

Property of
  VirtualMachineSummary
Extends
  DynamicData
See also
  ManagedEntityStatus, VirtualMachineQuickStatsMemoryTierStats
Since
  2.0

## Data Object Description

A set of statistics that are typically updated with near real-time regularity. This data object type does not support notification, for scalability reasons. Therefore, changes in QuickStats do not generate property collector updates. To monitor statistics values, use the statistics and alarms modules instead.

Properties

Name | Type | Description
--- | --- | ---
activeMemory* | xsd:int | The amount of memory that was recently touched by the VM, in MB. Since vSphere API 7.0.3.0
balloonedMemory* | xsd:int | The size of the balloon driver in the VM, in MB. The host will inflate the balloon driver to reclaim physical memory from the VM. This is a sign that there is memory pressure on the host. Since vSphere API 4.0
compressedMemory* | xsd:long | The amount of compressed memory currently consumed by VM, in Kb. Since vSphere API 4.1
consumedOverheadMemory* | xsd:int | The amount of consumed overhead memory, in MB, for this VM. Since vSphere API 4.0
distributedCpuEntitlement* | xsd:int | This is the amount of CPU resource, in MHz, that this VM is entitled to, as calculated by DRS. Valid only for a VM managed by DRS.
distributedMemoryEntitlement* | xsd:int | This is the amount of memory, in MB, that this VM is entitled to, as calculated by DRS. Valid only for a VM managed by DRS.
ftLatencyStatus* | ManagedEntityStatus | The latency status of the fault tolerance VM. ftLatencyStatus is determined by the value of ftSecondaryLatency. ftLatencyStatus is: green, if ftSecondaryLatency is less than or equal to 2 seconds; yellow, if ftSecondaryLatency is greater than 2 seconds, and less than or equal to 6 seconds; red, if ftSecondaryLatency is greater than 6 seconds; gray, if ftSecondaryLatency is unknown. Since vSphere API 4.0
ftLogBandwidth* | xsd:int | The network bandwidth used for logging between the primary and secondary fault tolerance VMs. The unit is kilobytes per second. Since vSphere API 4.0
ftSecondaryLatency* | xsd:int | The amount of time in wallclock that the VCPU of the secondary fault tolerance VM is behind the VCPU of the primary VM. The unit is millisecond. Since vSphere API 4.0
grantedMemory* | xsd:int | Amount of host physical memory that is mapped for a virtual machine, in MB. The number can be between 0 and the configured memory size of the virtual machine. Valid while the virtual machine is running. Since vSphere API 7.0
guestHeartbeatStatus | ManagedEntityStatus | Guest operating system heartbeat metric. See GuestHeartbeatStatus for a description.
guestMemoryUsage* | xsd:int | Guest memory utilization statistics, in MB. This is also known as active guest memory. The number can be between 0 and the configured memory size of the virtual machine. Valid while the virtual machine is running.
hostMemoryUsage* | xsd:int | Host memory utilization statistics, in MB. This is also known as consumed host memory. This is between 0 and the configured resource limit. Valid while the virtual machine is running. This includes the overhead memory of the VM.
memoryTierStats* | VirtualMachineQuickStatsMemoryTierStats[] | Stats for each physical memory tier. A physical memory tier consists of one or more logical memory tiers of the same HostMemoryTierType. For example, the logical tiers can be tier0 (DRAM), tier1 (DRAM), and tier2 (PMEM), while the physical tiers are just DRAM and PMEM. Since vSphere API 7.0.3.0
overallCpuDemand* | xsd:int | Basic CPU performance statistics, in MHz. Valid while the virtual machine is running. Since vSphere API 4.0
overallCpuReadiness* | xsd:int | Percentage of time that the virtual machine was ready, but could not get scheduled to run on the physical CPU. Valid while the virtual machine is running. Since vSphere API 7.0
overallCpuUsage* | xsd:int | Basic CPU performance statistics, in MHz. Valid while the virtual machine is running.
privateMemory* | xsd:int | The portion of memory, in MB, that is granted to this VM from non-shared host memory. Since vSphere API 4.0
sharedMemory* | xsd:int | The portion of memory, in MB, that is granted to this VM from host memory that is shared between VMs. Since vSphere API 4.0
ssdSwappedMemory* | xsd:long | The amount of memory swapped to fast disk device such as SSD, in KB. Since vSphere API 5.0
staticCpuEntitlement* | xsd:int | The static CPU resource entitlement for a virtual machine. This value is calculated based on this virtual machine's resource reservations, shares and limit, and doesn't take into account current usage. This is the worst case CPU allocation for this virtual machine, that is, the amount of CPU resource this virtual machine would receive if all virtual machines running in the cluster went to maximum consumption. Units are MHz. Since vSphere API 4.0
staticMemoryEntitlement* | xsd:int | The static memory resource entitlement for a virtual machine. This value is calculated based on this virtual machine's resource reservations, shares and limit, and doesn't take into account current usage. This is the worst case memory allocation for this virtual machine, that is, the amount of memory this virtual machine would receive if all virtual machines running in the cluster went to maximum consumption. Units are MB. Since vSphere API 4.0
swappedMemory* | xsd:int | The portion of memory, in MB, that is granted to this VM from the host's swap space. This is a sign that there is memory pressure on the host. Since vSphere API 4.0
uptimeSeconds* | xsd:int | The system uptime of the VM in seconds. Since vSphere API 4.1
Properties inherited from DynamicData
None

*Need not be set
Show WSDL type definition
<complexType xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="VirtualMachineQuickStats"> <complexContent> <extension base="vim25:DynamicData"> <sequence> <element name="overallCpuUsage" type="xsd:int" minOccurs="0"/> <element name="overallCpuDemand" type="xsd:int" minOccurs="0"/> <element name="overallCpuReadiness" type="xsd:int" minOccurs="0"/> <element name="guestMemoryUsage" type="xsd:int" minOccurs="0"/> <element name="hostMemoryUsage" type="xsd:int" minOccurs="0"/> <element name="guestHeartbeatStatus" type="vim25:ManagedEntityStatus"/> <element name="distributedCpuEntitlement" type="xsd:int" minOccurs="0"/> <element name="distributedMemoryEntitlement" type="xsd:int" minOccurs="0"/> <element name="staticCpuEntitlement" type="xsd:int" minOccurs="0"/> <element name="staticMemoryEntitlement" type="xsd:int" minOccurs="0"/> <element name="grantedMemory" type="xsd:int" minOccurs="0"/> <element name="privateMemory" type="xsd:int" minOccurs="0"/> <element name="sharedMemory" type="xsd:int" minOccurs="0"/> <element name="swappedMemory" type="xsd:int" minOccurs="0"/> <element name="balloonedMemory" type="xsd:int" minOccurs="0"/> <element name="consumedOverheadMemory" type="xsd:int" minOccurs="0"/> <element name="ftLogBandwidth" type="xsd:int" minOccurs="0"/> <element name="ftSecondaryLatency" type="xsd:int" minOccurs="0"/> <element name="ftLatencyStatus" type="vim25:ManagedEntityStatus" minOccurs="0"/> <element name="compressedMemory" type="xsd:long" minOccurs="0"/> <element name="uptimeSeconds" type="xsd:int" minOccurs="0"/> <element name="ssdSwappedMemory" type="xsd:long" minOccurs="0"/> <element name="activeMemory" type="xsd:int" minOccurs="0"/> <element name="memoryTierStats" type="vim25:VirtualMachineQuickStatsMemoryTierStats" minOccurs="0" maxOccurs="unbounded"/> </sequence> </extension> </complexContent> </complexType>