Use the configure-metrics command of the cell management tool to connect the cell to the optional metrics database.

vCloud Director can collect metrics that provide current and historic information about virtual machine performance and resource consumption. Data for historic metrics is stored in a KairosDB database backed by Apache Cassandra. See the vCloud Director Installation and Upgrade Guide for more information about using these optional database software packages to store and retrieve performance metrics

To create a connection from KairosDB to a vCloud Director, use a command line with the following form:

cell-management-tool configure-metrics options

Table 1. Cell Management Tool Options and Arguments, configure-metrics Subcommand




--help (-h)


Provides a summary of available commands in this category.


Host name or IP address of KairosDB host

If you have multiple installations of KairosDB, you must supply the load-balancer address here.


KairosDB port to use.

By default, KairosDB listens on port 8080.

Configuring a Metrics Database Connection

This example configures system to use a KairosDB instance hosted at IP address at the default port. The address can be either the address of a single machine running a single instance of KairosDB, or the address of a load balancer that distributes requests to multiple installations of KairosDB.

[root@cell1 /opt/vmware/vcloud-director/bin]# ./cell-management-tool configure-metrics --repository-host --repository-port 8080