Job Management Partner 1/Performance Management - Agent Option for Virtual Machine Description, User's Guide and Reference

VM Status (PI_VI)

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.

Figure 5-12 Example of collected data

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 60 Yes

Collection Offset 0 Yes

Log Yes Yes

LOGIF Blank Yes

Item	Default value	Can it be changed?
Collection Interval	60	Yes
Collection Offset	0	Yes
Log	Yes	Yes
LOGIF	Blank	Yes

ODBC key field

PI_VI_VM_ID

Lifetime

None

Record size

Fixed portion: 681 bytes

Variable portion: 889 bytes

Fields

PFM - View name
(PFM - Manager name) Explanation Summary Format Delta When not collected Unsup-ported

Record Type (INPUT_RECORD_TYPE) The record name. This is always VI. COPY char (8) No -- --

Record Time (RECORD_TIME) The time when the record was created. COPY time_t No -- --

Interval (INTERVAL) Interval during which the information is collected.
[Units: seconds] COPY ulong No -- --

VM ID (VM_ID) ID of the virtual machine.
For Hyper-V, the root partition is set to Root. COPY string (64) No No --

Clocks (CLOCKS) 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 double No VMware: 0
Hyper-V: 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 long No VMware: 0
Hyper-V: 0 --

VM Name (VM_NAME) Name of the virtual machine. COPY 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]^# COPY string (32) No Blank --

Used (USED) CPU usage amount.
CPU resources that could run a virtual machine on a physical CPU.
[Units: MHz] HILO double No VMware: 0
Hyper-V: 0 --

Insufficient (INSUFFICIENT) Amount of CPU insufficiency.
CPU resources that could not run a virtual machine on a physical CPU.
[Units: MHz] HILO double No VMware: 0 Hyper-V

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 double No VMware: 0 Hyper-V

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 double No VMware: 0 Hyper-V

Used % (USED_PERCENT) CPU usage rate.
Percentage of CPU resources that could run a virtual machine on a physical CPU.
[Units: %]
Expression: "Used" field / "Clocks" field HILO double No VMware: 0
Hyper-V: 0 --

Insufficient % (INSUFFICIENT_PERCENT) 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 double No VMware: 0 Hyper-V

Request % (REQUEST_PERCENT) 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 double No VMware: 0 Hyper-V

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 double No VMware: 0 Hyper-V

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 double No VMware: 0 Hyper-V

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 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 double No VMware: 0
Hyper-V: 0 --

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 double No VMware: 0
Hyper-V: 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 double No 0 --

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 double No VMware: 0 Hyper-V

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 double No VMware: 0
Hyper-V: 0 --

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 double No 0 --

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 double No VMware: 0 Hyper-V

#

The value used in [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.

PFM - View name (PFM - Manager name)	Explanation	Summary	Format	Delta	When not collected	Unsup-ported
Record Type (INPUT_RECORD_TYPE)	The record name. This is always VI.	COPY	char (8)	No	--	--
Record Time (RECORD_TIME)	The time when the record was created.	COPY	time_t	No	--	--
Interval (INTERVAL)	Interval during which the information is collected. [Units: seconds]	COPY	ulong	No	--	--
VM ID (VM_ID)	ID of the virtual machine. For Hyper-V, the root partition is set to Root.	COPY	string (64)	No	No	--
Clocks (CLOCKS)	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	double	No	VMware: 0 Hyper-V: 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	long	No	VMware: 0 Hyper-V: 0	--
VM Name (VM_NAME)	Name of the virtual machine.	COPY	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]^#	COPY	string (32)	No	Blank	--
Used (USED)	CPU usage amount. CPU resources that could run a virtual machine on a physical CPU. [Units: MHz]	HILO	double	No	VMware: 0 Hyper-V: 0	--
Insufficient (INSUFFICIENT)	Amount of CPU insufficiency. CPU resources that could not run a virtual machine on a physical CPU. [Units: MHz]	HILO	double	No	VMware: 0	Hyper-V
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	double	No	VMware: 0	Hyper-V
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	double	No	VMware: 0	Hyper-V
Used % (USED_PERCENT)	CPU usage rate. Percentage of CPU resources that could run a virtual machine on a physical CPU. [Units: %] Expression: "Used" field / "Clocks" field	HILO	double	No	VMware: 0 Hyper-V: 0	--
Insufficient % (INSUFFICIENT_PERCENT)	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	double	No	VMware: 0	Hyper-V
Request % (REQUEST_PERCENT)	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	double	No	VMware: 0	Hyper-V
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	double	No	VMware: 0	Hyper-V
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	double	No	VMware: 0	Hyper-V
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	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	double	No	VMware: 0 Hyper-V: 0	--
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	double	No	VMware: 0 Hyper-V: 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	double	No	0	--
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	double	No	VMware: 0	Hyper-V
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	double	No	VMware: 0 Hyper-V: 0	--
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	double	No	0	--
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	double	No	VMware: 0	Hyper-V

[Contents][Back][Next]

[Trademarks]