A.116 getLatestStat

Lists the latest value of a statistic type for an object.

Syntax

getLatestStat 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 | FILE_SYSTEM_TOTAL_FILES_SIZE }

Description

This command lists the latest value of a statistic type for an object. Statistics are held for a limited amount of time and there may be no statistics of the particular type that occurred.

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` \| `FILE_SYSTEM_TOTAL_FILES_SIZE` }	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. `FILE_SYSTEM_SPACE_TOTAL`: The total size of the file system, in GiB. `FILE_SYSTEM_TOTAL_FILES_SIZE`: The total of all the maximum sizes of all virtual disks on the file system, in GiB. The `FILE_SYSTEM_SPACE_FREE`, `FILE_SYSTEM_SPACE_UTILIZATION`, `FILE_SYSTEM_SPACE_TOTAL`, and `FILE_SYSTEM_TOTAL_FILES_SIZE` 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.

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 | FILE_SYSTEM_TOTAL_FILES_SIZE }

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.
FILE_SYSTEM_SPACE_TOTAL: The total size of the file system, in GiB.
FILE_SYSTEM_TOTAL_FILES_SIZE: The total of all the maximum sizes of all virtual disks on the file system, in GiB.

The FILE_SYSTEM_SPACE_FREE, FILE_SYSTEM_SPACE_UTILIZATION, FILE_SYSTEM_SPACE_TOTAL, and FILE_SYSTEM_TOTAL_FILES_SIZE 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.150 Listing latest statistics for an Oracle VM Server

OVM> getLatestStat objType=Server objId=00:e0:81:4d:41:05:00:e0:81:4d:40:de:00:e0:81:4d \
  statType=MEMORY_USED