How to Configure Additional VM Metrics in vCloud Director

vCloud Director already for some time (since version 5.6) provides to tenants basic set of VM metrics. Until vCloud Director 9.0 they had to be retrieved with vCloud API, however now the users can easily access the metrics from the new HTML5 UI.

vCloud Director 9.0 besides adding the metric UI also simplifies the metric database backend configuration (no KairosDB needed anymore) and also provides the option to service provider to configure additional VM metrics.

Here follows the step by step description of the last point. I assume that Cassandra cluster – the VM metric database is already set up.

  • First you need to find the metric names VC Performance Manager uses. This PowerCLI script exports all VM metric names.
  • Now we will create text file (e.g. metrics.groovy) with the new metrics.

configuration {

The metrics in the file must not overlap with the already existing default metrics. Additional options about frequency, interval averages, etc. can be provided as well. See docs for the details.

  • On a vCloud Director cell with the cell-management-tool we will import the new metrics:
    $VCLOUD_HOME/bin/cell-management-tool configure-metrics –metrics-config /tmp/metrics.groovy 
  • Still on the cell we need to update Cassandra schema, again with the cell-management-tool (provide the correct nodes addresses, DB authentication details, port and metrics time to live in days):
    $VCLOUD_HOME/bin/cell-management-tool cassandra –configure –cluster-nodes –username cassandra –password cassandra –port 9042 –ttl 31 –update-schema
  • Restart all cells

That is all. After while we can monitor the new metrics with the UI or API.

The metric definition is stored in vCloud Director table metric_configuration.


9 thoughts on “How to Configure Additional VM Metrics in vCloud Director

  1. Tomas, there is no changes from version 8.2 of vCloud Director in requirements for Cassandra nodes and cluster? Tech support cannot give consultation about planning cassandra cluster and it is sizing.

    Formula doesn’t change for current releases vCloud ?

    Estimate I/O requirements based on expected number of VMs, and size the Cassandra cluster and its storage properly.
    n – Expected number of VMs
    m – Number of metrics per VM (currently 8)
    t – Retention (days)
    r – Replication factor
    Write I/O per second = n × m × r / 10
    Storage = n × m × t × r × 114 KB

  2. After successeded migration between cassandra database and vcloud director,cassandra data base did not appear any data

    When using cassandra query language to retrieve data from cassandra appears is there is no data and also did not appear any graph in vcloud director tenant portal, so i want to know how to solve this issue.

    By the way a month ago i saw graphs in tenant portal.

  3. Tomas hello again, is possible to uncofigure cassandra ? Whys that ? Cause I am using TenantApp to provide my customers metrics….and cassandra started fo being a pain….

  4. Hello Tomas,
    Thank you for your all informative blogs. I am using vCloud and when i configure net.usage.average all default and the newly added network metrics become down and no data is retrieved in charts. What is the problem? Note: all default metrics work before adding the additional network metric.

    thanks in advance.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.