VIM Property Collector Test

This test measures the processing ability of the VIM Inventory Event Manager by indicating the number of object updates that could not be processed by the event manager. In addition, the test monitors the PropertyCollector and reports how frequently objects were updated and were ready for processing by the collector.

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

Total invocations

Indicates the total number of object updates that were received for processing by the VIM Inventory Event Manager during the last measurement period.

Number

 

Failed object updates

Indicates the total number of object updates that failed to be processed in the VIM Inventory Event Manager during the last measurement period.

Number

A consistent increase in the value of this measure is a cause for concern. You may consider fine-tuning the Inventory Event Manager to handle future load.

Total check for updates calls

Indicates the total number of times the PropertyCollector invoked the CheckForUpdates method during the last measurement period.

Number

PropertyCollector is the managed object type that clients use to retrieve a set of properties from one or more managed objects. Clients can also use the PropertyCollector to determine when any of the properties have changed. The change detection mechanism supports both polling and notification to detect property changes.

  • Polling is supported with the CheckForUpdates method.
  • Notification is supported with the WaitForUpdates method.

The CheckForUpdates method checks whether updates are awaiting processing. A high value for the Total check for updates calls measure indicates that this method was called very frequently.

The WaitForUpdates method waits until updates are available before it completes. A very low value for the Total wait for updates calls measure could indicate that each invocation of the WaitForUpdates method took too long to complete owing to very few object updates.

Total wait for updates calls

Indicates the total number of times the PropertyCollector invoked the WaitForUpdates method during the last measurement period.

Number