vCD Active MQ Test

The message bus in the vCloud Director cell is used for inter-cell communication, based on ActiveMQ (the message broker) and JMS (which defines the message format).

This test reports the health of the message bus connection and helps the administrator to figure out the number of vCloud Director cells that are currently reachable and not reachable in a vCloud Director infrastructure.

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 the vCloud Director Cell being monitored.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The host for which the test is being configured.

Port

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.

JNDIName

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

Is active MQ healthy?

Indicates whether/not the message bus connection to peer cell from this vCloud Director cell is healthy.

In the case of the global descriptor, the overall health of the message bus connection to the vCloud Director cell is taken into consideration.

 

This measure reports the value Yes if the message bus connection is healthy and the value No if otherwise.

The numeric values that correspond to the above-mentioned measure values are as follows:

Measure Value Numeric Value
Yes 1
No 0

Note:

By default, this measure reports the above-mentioned Measure Values while indicating the health of the message bus connection. However, the graph of this measure will be represented using the corresponding numeric equivalents only.

Reachable cells

Indicates the number of vCloud Director cells that are currently reachable in the vCloud Director infrastructure.

Number

This measure is applicable only for the global descriptor.

Unreachable cells

Indicates the number of vCloud Director cells that are currently not reachable in the vCloud Director infrastructure.

Number

This measure is applicable only for the global descriptor.