VM CPU Status (PI_VCI)
- Organization of this page
Function
This record stores performance data on a virtual CPU being used by 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 a virtual machine. The CPU usage can be divided into CPU usage and CPU insufficiency. The figure below shows an example of data that can be collected in this record.
|
|
![[Figure]](GRAPHICS/ZU050004.GIF)
- Note:
-
-
Information cannot be collected if an attempt to connect to the monitored physical server fails.
-
For Hyper-V, if there are multiple virtual machines with the same virtual machine name, PFM - RM for Virtual Machine might not be able to collect the correct information.
-
For Hyper-V, any special character contained in the virtual machine name is converted to a different character and then stored in the VM Name field. The conversion rules are as follows:
Before conversion
After conversion
/ and \
-
# and *
_
(
[
)
]
-
Default values and values that can be changed
|
Item |
Default value |
Can it be changed? |
|---|---|---|
|
Collection Interval |
300 |
Yes |
|
Collection Offset |
0 |
Yes |
|
Log |
No |
Yes |
|
LOGIF |
Blank |
Yes |
ODBC key field
PI_VCI_VM_ID
PI_VCI_CPU_ID
Lifetime
None
Record size
-
Fixed portion: 937 bytes
-
Variable portion: 930 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 VCI. |
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 |
-- |
|
CPU ID (CPU_ID) |
ID of the virtual CPU. |
COPY |
FIXED |
string (32) |
No |
No |
-- |
|
VM Host Name (VM_HOST_NAME) |
Host name of the virtual machine. |
COPY |
FIXED |
string(257) |
No |
-- |
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[ |
COPY |
FIXED |
string (32) |
No |
Blank |
-- |
|
Used (USED)#2 |
Amount of used virtual CPU resources. CPU resources that could run a virtual machine on a virtual CPU. [Units: MHz] |
HILO |
ADD |
double |
No |
VMware: 0 Hyper-V: 0 KVM: 0 |
-- |
|
Insufficient (INSUFFICIENT) |
Amount of virtual CPU insufficiency. CPU resources that could not run a virtual machine on a virtual CPU. [Units: MHz] |
HILO |
ADD |
double |
No |
VMware: 0 |
Hyper-V KVM |
|
Request (REQUEST) |
Amount of virtual CPU requests. Resources required to run virtual machines. (This is the total of the amount of allocated CPUs added to the amount of unallocated CPUs.) [Units: MHz] |
HILO |
ADD |
double |
No |
VMware: 0 |
Hyper-V KVM |
|
Used % (USED_PERCENT)#2 |
Usage rate of virtual CPUs. Percentage of CPU resources that are allocated to a virtual CPU. [Units: %] Expression: "Used" field / "Clocks" field of "PD_HCI" record There is no need to set the PI_HCI record to the collection setting (Log=Y). |
HILO |
AVG |
double |
No |
VMware: 0 Hyper-V: 0 KVM: 0 |
-- |
|
Insufficient % (INSUFFICIENT_PERCENT) |
Insufficiency rate of virtual CPUs. Percentage of CPU resources that are unallocated to a virtual CPU. [Units: %] Expression: "Insufficient" field / "Clocks" field of "PI_HCI" record There is no need to set the PI_HCI record to the collection setting (Log=Y). |
HILO |
AVG |
double |
No |
VMware: 0 |
Hyper-V KVM |
|
Request % (REQUEST_PERCENT) |
Request rate of virtual CPUs. Percentage of CPU resources for which virtual CPUs are requested. [Units: %] Expression: "Request" field / "Clocks" field of "PD_HCI" record There is no need to set the PI_HCI record to the collection setting (Log=Y). |
HILO |
AVG |
double |
No |
VMware: 0 |
Hyper-V KVM |
|
Used Per Request (USED_PER_REQUEST) |
Usage ratio of virtual CPUs. Percentage of the CPU resources, required to run a virtual machine, that are CPU resources 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) |
Insufficiency rate for virtual CPUs. Percentage of the CPU resources, required to run a virtual machine, that are CPU resources that could not run a virtual machine. [Units: %] Expression: "Insufficient" field / "Request" field |
HILO |
AVG |
double |
No |
VMware: 0 |
Hyper-V KVM |
- #1
-
The value used in [
![[Figure]](GRAPHICS/ZUENG003.GIF)
hh:mm] varies depending on the time zone of the monitored host. For example, if the monitored virtual environment is operating according
to JST, +09:00 is displayed. If the monitored virtual environment is operating according to UTC, Z is displayed.
- #2
-
For Hyper-V or KVM, this field requires performance data to be collected at least twice.