VM Status - OpenStack Test

This test continuously the target OpenStack KVM hypervisor and reports the count of virtual machines (VMs) that are in different states. This test enables administrators to instantly determine how many VMs are currently running on the target hypervisor and how many VMs are deleted/stopped/paused/suspended. In addition, the test also reveals the count of VMs that encountered unrecoverable errors. Using the metrics reported by this test, administrators can promptly identify the reason for inaccessibility of the VMs whenever users complain of the same.

Target of the test : An OpenStack KVM

Agent deploying the test : A remote agent

Outputs of the test : One set of results for the target hypervisor.

Configurable parameters for the test
Parameter	Description
Test period	How often should the test be executed.
Host	The host for which the test is to be configured.
Port	The port number at which the specified Host listens to.
Project Name	To enable this test to access the target hypervisor and pull out the performance metrics, you should specify the name of the project that is mapped to the target hypervisor in this text box. To know how to find out the project name from the OpenStack console, refer to Obtaining Project Name and Domain Details from OpenStack Console.
Domain Name and Domain ID	Specify the name and ID of the domain to which the specified project belongs to against the Domain Name and Domain ID parameters. To know how to find out the domain name and domain ID from the OpenStack console, refer to Obtaining Project Name and Domain Details from OpenStack Console.
User Name, Password and Confirm Password	To enable this test to pull out the performance metrics, you should configure the test with credentials of a user who is assigned with 'reader' role to access the above-mentioned project. Specify the credentials of such a user in the User Name and Password text boxes. Then, confirm the password by retyping it in the Confirm Password text box.
Identity Version	Specify the version of the Identity service API that is being used in the OpenStack environment. By default, this parameter is configured with the latest version of the API i.e. v3.
SSL	By default, the target controller is not SSL-enabled. This indicates that by default, the eG agent communicates with the target controller using HTTP. Accordingly, the SSL flag is set to No by default. If you configure the target controller to use SSL, then make sure that the SSL flag is set to Yes, so that the eG agent communicates with the target controller using HTTPS.
Detailed Diagnosis	To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option. The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled: The eG manager license should allow the detailed diagnosis capability Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
No state VMs	Indicates the number of virtual machines (VMs) that are currently holding the status ‘NoState’.	Number	Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'NoState' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Running VMs	Indicates the number of VMs that are currently running on the target hypervisor.	Number	A high value is desired for this measure. Used the detailed diagnosis of this measure to know the name and status of each VM that is currently running, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Paused power state VMs	Indicates the number of VMs that are currently in the paused power state.	Number	Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'Paused' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Shutdown VMs	Indicates the number of VMs that are currently in shutdown state.	Number	Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'Shutdown' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Crashed VMs	Indicates the number of VMs that currently crashed.	Number	Ideally, the value of this measure should be 0. Used the detailed diagnosis of this measure to know the name and status of each VM that crashed, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Suspended power state VMs	Indicates the number of VMs that are currently in the suspended power state.	Number	Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'suspended' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Active VMs	Indicates the number of VMs that are currently running normally on the target hypervisor.	Number	A high value is desired for this measure. Used the detailed diagnosis of this measure to know the name and status of each VM that is active, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Building VMs	Indicates the number of VMs that are currently in the BUILDING state.	Number	Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'BUILDING' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Deleted VMs	Indicates the number of VMs that are deleted.	Number	Used the detailed diagnosis of this measure to know the name and status of each VM that is deleted, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Error VMs	Indicates the number of VMs that encountered unrecoverable error.	Number	Ideally, the value of this measure should be 0. Used the detailed diagnosis of this measure to know the name and status of each VM that encountered errors, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Paused VMs	Indicates the number of VMs that are currently paused with a specific image.	Number	Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'Paused' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Rescued VMs	Indicates the number of VMs that are currently running with the rescue image.	Number	Used the detailed diagnosis of this measure to know the name and status of each VM that is currently running with rescue image, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Resized VMs	Indicates the number of VMs that are currently in the RESIZED state.	Number	If a VM is in the RESIZED state, then it indicates that the VM is stopped on the source node but running on the destination node. The VM images exist at both source and destination locations with different sizes. The user is expected to confirm the resize or revert it. Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'RESIZED' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Shelved VMs	Indicates the number of VMs that are currently in the SHELVED state.	Number	Shelved VMs can be in one of two possible states: shelved and shelved_offloaded. If a VM is in the shelved state, then it indicates that the VM is still present on the target hypervisor but is in inactive state. When the VM is moved to in shelved_offloaded state, it indicates that the VM has been removed from the hypervisor and the resources allocated to the VM are released. Used the detailed diagnosis of these measures to know the name and status of each VM that is in 'SHELVED_OFFLOAD' and 'SHELVED' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Shelved offload VMs	Indicates the number of VMs that are currently in the SHELVED_OFFLOAD state.	Number
Soft deleted VMs	Indicates the number of VMs that are currently in the SOFT_DELETED state.	Number	A VM is moved to the SOFT_DELETED state, when the VM is no longer running on the hypervisor but the image of the VM remains on the disk so that the VM can be configured again. Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'SOFT_DELETED' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Stopped VMs	Indicates the number of VMs that are currently in the STOPPED state.	Number	The STOPPED state is reported when the VM is stopped working completely but the image of the VM is still available on the disk. Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'STOPPED' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.
Suspended VMs	Indicates the number of VMs that are currently in the SUSPENDED state.	Number	The state of VM is reported as SUSPENDED when the VM is suspended with the specified image, with a valid memory snapshot. Used the detailed diagnosis of this measure to know the name and status of each VM that is in 'SUSPENDED' state, IP addresses and host name of each VM, name of the availability zone, key name, date at which the VM was created, ID of each VM, ID of the project, flavor ID, and image ID.