A.117 getLatestStatForList

Lists the latest value of a statistic type for objects.

Syntax

getLatestStatForList objType= { Server | Vm | FileSystem } ids=value statType= { CPU_UTILIZATION | CPU_COUNT | MEMORY_USED | FREE_MEMORY | MEMORY_UTILIZATION | FILE_SYSTEM_SPACE_FREE | FILE_SYSTEM_SPACE_UTILIZATION | FILE_SYSTEM_SPACE_TOTAL }

Description

This command lists the latest value of a statistic type for objects.

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.
`ids=value`	A comma separated list of the IDs of the objects for which statistics should be listed. This must contain be the IDs of Server, Vm or FileSystem objects.
`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.

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.

ids=value

A comma separated list of the IDs of the objects for which statistics should be listed. This must contain be the IDs of Server, Vm or FileSystem objects.

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.

Examples

Example A.151 Listing latest statistics for Oracle VM Servers

OVM> getLatestStatForList objType=Server \
  ids=00:e0:81:4d:41:05:00:e0:81:4d:40:de:00:e0:81:4d,00:e0:81:4d:5f:2f:00:e0:81:4d:29:ee:00:e0:81:4d \
  statType=CPU_UTILIZATION