VCD Global User Sessions Test

An Organization is the fundamental vCloud Director grouping that contains users, the vApps that they create, and the resources the vApps use. It is a top-level container in a cloud that contains one or more Organization Virtual Data Centers (Org vDCs) and Catalog entities. It owns all the virtual resources for a cloud instance and can have many Org vDCs.

This test reports the number of user sessions that are currently active on each organization configured on the vCloud Director cell.

Target of the test : A vCloud Director Cell

Agent deploying the test : An internal/remote agent

Outputs of the test : One set of results for each organization configured on the vCloud Director Cell 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 being configured.


Specify the port at which the specified host listens in the Port text box. By default, this is NULL.

JMX Remote Port

Here, specify the port at which the JMX listens for requests from remote hosts. Ensure that you specify the same port that you configured in the vmware-vcd-cell file in the /opt/vmware/vcloud-director/binfolder of the vCloud Director.


The JNDIName is a lookup name for connecting to the JMX connector. By default, this is jmxrmi. If you have registered the JMX connector in the RMI registry using a different lookup name, then you can change this default value to reflect the same.

User, Password, and Confirm Password

By default, JMX requires no authentication or security (SSL). This is why, by default, the User and Password parameters are set to none. If JMX requires authentication only (but no security), then ensure that the User and Password parameters are configured with the credentials of a user with read-write access to JMX. To know how to create this user, refer to Pre-requisites for Monitoring vCloud Director. Confirm the password by retyping it in the Confirm Password text box.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Active sessions

Indicates the total number of sessions that are currently active on this organization.


A high value of this measure indicates that too many users are currently active on the organization. A rapid increase in the value of this measure is a cause of concern. If this value increases, the availability of the resources to the user sessions would gradually decrease and the time taken for accessing the resources would increase manifold leading to the performance slowdown of the cloud.