A.121 getStatList

Lists statistic types for an object.

Syntax

getStatList 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 statistics, that are stored within Oracle VM Manager, for an object.

Note that statistics are only stored for the length of time specified for the value of the statistics holdTime, as described in Section A.169, “setStatsConfig”. The default holdTime is 60 minutes. Every 60 minutes, an archive manager runs to trim the statistics to the value specified for the holdTime. Therefore, just prior to cleanup it is possible that statistics are available for the holdTime value in addition to 60 minutes. For example, if the holdTime is specified as the default 60 minutes, then it is possible that statistics of up to 120 minutes old may be returned if the command is run at exactly the same time that the archive manager runs.

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 either 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. This option applies only to objects associated with a server. `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 in the time frame when the statistics were requested.
`startTime=value`	The start date and time from which to list the average statistic. The format to use is `"MM-dd-yyyy HH:mm:ss"`. 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:ss"`. This is an optional parameter.

Examples

Example A.155 Listing statistics for an Oracle VM Server

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