A.108 getAverageStat

Lists the average value of a statistic type for an object during a time range.

Syntax

getAverageStat objType= { Server | Vm | FileSystem } objId=value statType= { CPU_UTILIZATION | CPU_COUNT | MEMORY_USED | FREE_MEMORY | MEMORY_UTILIZATION | FILE_SYSTEM_SPACE_FREE | FILE_SYSTEM_SPACE_UTILIZATION | FILE_SYSTEM_SPACE_TOTAL } startTime=value [ endTime=value ]

Description

This command lists the average statistic for an object during a time range. Statistics are held for a limited amount of time and there may be no statistics of the particular type that occurred during all or part of the specified time range.

Options

The following table shows the available options for this command.

Option	Description
`objType=` { `Server` \| `Vm` \| `FileSystem` }	The object type for which to list the average statistic. The `value` of `objType` may be `Server`, `Vm`, or `FileSystem`. The value for `objType` is case insensitive.
`objId=value`	The name or ID of the object for which statistics should be listed. This must be the ID of a Server, Vm, or FileSystem object.
`statType=` { `CPU_UTILIZATION` \| `CPU_COUNT` \| `MEMORY_USED` \| `FREE_MEMORY` \| `MEMORY_UTILIZATION` \| `FILE_SYSTEM_SPACE_FREE` \| `FILE_SYSTEM_SPACE_UTILIZATION` \| `FILE_SYSTEM_SPACE_TOTAL` }	The type of statistic to list: `CPU_UTILIZATION`: The percentage of the total CPU power being used by the object `CPU_COUNT`: The number of CPUs. `MEMORY_USED`: The amount of memory, in MBs, used by the object. `FREE_MEMORY`: The amount of memory, in MBs, available on the server. `MEMORY_UTILIZATION`: The percentage of the total memory being used by the object. `FILE_SYSTEM_SPACE_FREE`: The amount of file system space, in GiB, that is not currently used. `FILE_SYSTEM_SPACE_UTILIZATION`: The percentage of the total file system space currently in use. `FILE_SYSTEM_SPACE_TOTAL`: The total size of the file system, in GiB. The `FILE_SYSTEM_SPACE_FREE`, `FILE_SYSTEM_SPACE_UTILIZATION`, `FILE_SYSTEM_SPACE_TOTAL` parameters are supported for the FileSystem object type only. The `CPU_COUNT` parameter is not supported by the Server object type. An error is returned when an incompatible object type and parameter are requested. A value of `0` may be returned for any parameter if there are no statistics available for the object on Oracle VM Manager
`startTime=value`	The start date and time from which to list the average statistic. The format to use is `"MM-dd-yyyy HH:mm"`. The value must not be later than the current time or after the value of `endTime`.
`endTime=value`	The end date and time from which to list the average statistic. The format to use is `"MM-dd-yyyy HH:mm"`. This is an optional parameter.

Examples

Example A.136 Listing average statistics for an Oracle VM Server

OVM> getAverageStat objType=Server objId=00:e0:81:4d:41:05:00:e0:81:4d:40:de:00:e0:81:4d \
  statType=CPU_UTILIZATION startTime="08-20-2014 00:00"