VM Status (PI_VI)
- Organization of this page
Function
This record stores performance data on a virtual machine over a unit of time. This record is a multi-instance record.
In this record, you can collect performance data such as CPU usage by the virtual machine, CPU insufficiency, and CPU allocation. The figure below shows an example of data that can be collected in this record.
- Note:
-
Information cannot be collected if an attempt to connect to the monitored physical server fails.
Default values and values that can be changed
Item |
Default value |
Can it be changed? |
---|---|---|
Collection Interval |
300 |
Yes |
Collection Offset |
0 |
Yes |
Log |
Yes |
Yes |
LOGIF |
Blank |
Yes |
ODBC key field
PI_VI_VM_ID
Lifetime
None
Record size
-
Fixed portion: 937 bytes
-
Variable portion: 1,146 bytes
Fields
PFM - View name (PFM - Manager name) |
Explanation |
Summary |
Grouping |
Format |
Delta |
When not collected |
Unsup-ported |
---|---|---|---|---|---|---|---|
Record Type (INPUT_RECORD_TYPE) |
The record name. This is always VI. |
COPY |
COPY |
char (8) |
No |
-- |
-- |
Record Time (RECORD_TIME) |
The time when the record was created. |
COPY |
COPY |
time_t |
No |
-- |
-- |
Interval (INTERVAL) |
Interval during which the information is collected. [Units: seconds] |
COPY |
FIXED |
ulong |
No |
-- |
-- |
VA DeviceID (VADEVICEID) |
The device ID of a monitored host. |
COPY |
COPY |
string (256) |
No |
-- |
-- |
VM ID (VM_ID) |
ID of the virtual machine. For Hyper-V, the root partition is set to Root. |
COPY |
FIXED |
string (64) |
No |
No |
-- |
Clocks (CLOCKS)#1 |
Clock frequency of the CPU resources. The value that is the total of the clock frequencies of the physical CPUs allocated to the virtual machine. [Units: MHz] |
COPY |
ADD |
double |
No |
VMware: 0 Hyper-V: 0 KVM: 0 |
-- |
Count (COUNT) |
Number of physical CPU cores in the CPU resources. The number of cores of the physical CPUs allocated to the virtual machine. |
COPY |
ADD |
long |
No |
VMware: 0 Hyper-V: 0 KVM: 0 |
-- |
VM Host Name (VM_HOST_NAME) |
Host name of the virtual machine. |
COPY |
FIXED |
string(257) |
No |
Blank |
Hyper-V KVM |
VM Name (VM_NAME) |
Name of the virtual machine. |
COPY |
FIXED |
string (257) |
No |
Blank |
-- |
Sampling Time (SAMPLING_TIME) |
Sampling time. The time when the performance information is collected on the host machine. Displayed in the following format: yyyy-mm-ddThh:mm[hh:mm]#2 |
COPY |
FIXED |
string (32) |
No |
Blank |
-- |
Used (USED)#3 |
CPU usage amount. CPU resources that could run a virtual machine on a physical CPU. [Units: MHz] |
HILO |
ADD |
double |
No |
VMware: 0 Hyper-V: 0 KVM: 0 |
-- |
Insufficient (INSUFFICIENT) |
Amount of CPU insufficiency. CPU resources that could not run a virtual machine on a physical CPU. [Units: MHz] |
HILO |
ADD |
double |
No |
VMware: 0 |
Hyper-V KVM |
Request (REQUEST) |
Amount of CPU requests. The amount of CPU resources required to run a virtual machine. (This is the total allocated resources added to the total unallocated resources.) [Units: MHz] |
HILO |
ADD |
double |
No |
VMware: 0 |
Hyper-V KVM |
Host Used % (HOST_USED_PERCENT) |
Usage rate of host CPUs. Percentage of total physical CPU resources that were executed on a physical CPU. [Units: %] Expression: "Used" field / "Clocks" field of PI record |
HILO |
AVG |
double |
No |
VMware: 0 KVM: 0 |
Hyper-V |
Used % (USED_PERCENT)#1,#3 |
CPU usage rate. Percentage of CPU resources that could run a virtual machine on a physical CPU. [Units: %] Expression: "Used" field / "Clocks" field |
HILO |
AVG |
double |
No |
VMware: 0 Hyper-V: 0 KVM: 0 |
-- |
Insufficient % (INSUFFICIENT_PERCENT)#1 |
CPU insufficiency rate. Percentage of CPU resources that could not run a virtual machine on a physical CPU. [Units: %] Expression: "Insufficient" field / "Clocks" field |
HILO |
AVG |
double |
No |
VMware: 0 |
Hyper-V KVM |
Request % (REQUEST_PERCENT)#1 |
CPU request rate. Percentage of CPU resources required to run a virtual machine. (This is the total of the CPU allocation rate added to the CPU unallocation rate.) [Units: %] Expression: "Request" field / "Clocks" field |
HILO |
AVG |
double |
No |
VMware: 0 |
Hyper-V KVM |
Used Per Request (USED_PER_REQUEST) |
% of allocatable CPU resources (= amount of CPU usage/amount of CPU requests). Percentage of the CPU resources required to run a virtual machine, that could run a virtual machine. [Units: %] Expression: "Used" field / "Request" field |
HILO |
AVG |
double |
No |
VMware: 0 |
Hyper-V KVM |
Insufficient Per Request (INSUFFICIENT_PER_REQUEST) |
Rate of unallocated CPUs (= amount of CPU insufficiency/amount of CPU requests). Percentage of the CPU resources required to run a virtual machine, that could not run a virtual machine. [Units: %] Expression: "Insufficient" field / "Request" field |
HILO |
AVG |
double |
No |
VMware: 0 |
Hyper-V KVM |
Affinity (AFFINITY) |
Physical CPU that can be moved. The Affinity setting specifies that a physical CPU can be allocated to an individual virtual machine. (Ex: If a virtual machine can be allocated to physical CPU 1 and 2, the value of this field is 1,2.) |
COPY |
FIXED |
string (32) |
No |
Blank |
Hyper-V |
Share (SHARE) |
CPU allocation ratio. A value used to request the CPU resources to be allocated to virtual machines. If two or more virtual machines require a large amount of CPU resources at the same time, the CPU resources are allocated according to this ratio. For Hyper-V, the root partition information cannot be obtained. |
COPY |
AVG |
double |
No |
VMware: 0 Hyper-V: 0 |
KVM |
Max (MAX) |
Maximum value for CPU allocation. The maximum value for CPUs allocatable to a virtual machine. [Units: MHz] -1: No limit. For Hyper-V, the root partition information cannot be obtained. |
COPY |
ADD |
double |
No |
VMware: 0 Hyper-V: 0 KVM: 0 |
-- |
Min (MIN) |
Minimum value for CPU allocation. The minimum value for CPUs allocatable to a virtual machine. [Units: MHz] For Hyper-V, the root partition information cannot be obtained. |
COPY |
ADD |
double |
No |
0 |
KVM |
Expectation (EXPECTATION) |
Balance value for CPU allocation. If two or more virtual machines require a large amount of resources at the same time, this value estimates what CPU resources can be expected to be available for the virtual machines. [Units: MHz] |
HILO |
ADD |
double |
No |
VMware: 0 |
Hyper-V KVM |
Max % (MAX_PERCENT) |
Maximum % for CPU allocation. Percentage of CPU resources that is the maximum allocatable to a virtual machine. [Units: %] Expression: "Max" field / "Clocks" field For Hyper-V, the root partition information cannot be obtained. |
HILO |
AVG |
double |
No |
VMware: 0 Hyper-V: 0 |
KVM |
Min % (MIN_PERCENT) |
Minimum % for CPU allocation. The minimum percentage of CPU resources that are allocatable to a virtual machine. [Units: %] Expression: "Min" field / "Clocks" field For Hyper-V, the root partition information cannot be obtained. |
HILO |
AVG |
double |
No |
0 |
KVM |
Expectation % (EXPECTATION_PERCENT) |
Balance point rate for CPU allocation. Percentage of CPU resources that can be expected to be used for virtual machines. [Units: %] Expression: "Share" field / total of "Share" field |
HILO |
AVG |
double |
No |
VMware: 0 |
Hyper-V KVM |