VM Status Test

Whenever users complaint of inaccessibility of their desktops, administrators need to promptly determine the reason for the same - is it because the desktops are not running currently? is it because they are not even registered? or is it because they have been moved to another VirtualBox? The VM Status test provides administrators with this information. This test tracks the status and movement of each desktop on the target VirtualBox, reports the number and names of desktops in various states, and also captures the migration of desktops to other VirtualBoxes.

Target of the test : An Oracle VirtualBox

Agent deploying the test : A remote agent

Outputs of the test : One set of results for the Oracle VirtualBox being monitored.

Configurable parameters for the test
Parameter Description

Test period

How often should the test be executed


The host for which the test is to be configured.


The port number at which the specified Host listens to.

Oracle Hypervisor

Specify the name of the user who has the right to access the VirtualBox via SSH.

Oracle Hypervisor Password

Provide the password of the oracle hypervisor user.

Confirm Password

Confirm the password by retyping it here.


This test executes certain privileged VDA (Virtual Desktop Access) commands to pull out the desired metrics from the VirtualBox. To enable the test to run these commands, you first need to install a sudo package on the VirtualBox host. The procedure for installing this package is detailed in Pre-requisites for Auto-Discovering VMs and Obtaining their Outside View. Once the package is installed, you need to specify the full path to the install directory of the sudo package in the Sudocmd text box.

Report By User

While monitoring a VirtualBox, the Report By User flag is set to Yes by default, indicating that by default, the guest operating systems on the VirtualBox are identified using the login of the user who is accessing the guest OS. In other words, this test will, by default, report measures for every username_on_virtualmachinename. If this flag is set to No, then the guests will be identified using the host name of the guest OS. In this case, the test will report measures for every virtualmachinename.

Report Powered OS

This flag becomes relevant only if the Report By User flag is set to ‘Yes’.

If the report powered os flag is set to Yes (which is the default setting), then this test will report measures for even those VMs that do not have any users logged in currently. Such guests will be identified by their virtualmachine name and not by the username_on_virtualmachinename. On the other hand, if the Report Powered OS flag is set to No, then this test will not report measures for those VMs to which no users are logged in currently.

DD Frequency

Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, by default, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you so desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD Frequency.

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

Registered guests

Indicates the number of registered desktops on the Oracle VirtualBox.



Running guests

Indicates the number of desktops currently running on the Oracle VirtualBox.



Not running guests

Indicates the number of desktops currently not running on the Oracle VirtualBox.



Added guests

Indicates the number of desktops newly added on the Oracle VirtualBox.


The detailed diagnosis of these measures, if enabled, lists the virtual machines that were migrated to or from (as the case may be) the VirtualBox.

Removed guests

Indicates the number of desktops newly removed from the Oracle VirtualBox.