Abiquo Documentation Cookies Policy

Our Documentation website uses cookies to improve your experience. Please visit our Cookie Policy page for more information about cookies and how we use them.


Skip to end of metadata
Go to start of metadata

Introduction to Monitoring and Metrics

Abiquo 3.2 supports monitoring and metrics of virtual machine on ESX and KVM hypervisors, and in AWS public cloud regions.

The feature enables you to obtain a rapid and convenient overview of virtual machine performance through the Abiquo cloud console. 

Abiquo supports:

  • Built-in metrics provided by each hypervisor or public cloud plugin and fetched periodically by the monitor manager
  • Custom metrics that can be created and populated through the Abiquo API. After you create a metric, you can push the metric’s datapoints to KairosDB using the Abiquo API
The Abiquo VSM remote service connects to the monitoring and metrics systems. Behind the scenes it uses KairosDB (together with Cassandra) to process the information.
The following diagram shows a basic monitoring and metrics configuration. 


Configure Monitoring and Metrics

Install Cassandra and KairosDB following the instructions in Configure VM Monitoring and Metrics Prerequisites

The following table describes the configuration required to use monitoring on the following platforms.

Hypervisor or Public CloudMonitoring Support
AWS EC2Available by default with no extra configuration required
ESX or ESXiHypervisors must be connected to vCenter and NTP must be synchronized across Abiquo Servers and vCenter
KVMNTP must be synchronized across Abiquo servers and KVM

Configure NTP

You MUST configure and synchronize NTP across all Abiquo servers and all hypervisors before you enable metrics.

Monitoring and Metrics Properties

The administrator should configure the monitoring properties before enabling monitoring.

Metering properties

The properties should be configured on the Abiquo Server and Remote Services servers.


Abiquo uses these two Abiquo Configuration Properties to connect to KairosDB:

  • abiquo.kairosdb.host
  • abiquo.kairosdb.port

See Abiquo Configuration Properties#kairosdb

KVM Properties

There are changes to AIM for Abiquo 3.2. The compatible AIM version is AIM 2.4.2

The following new properties have been added to a new [stats] section to manage statistics for metrics and monitoring:

  • collectFreqSeconds = 60

  • refreshFreqSeconds = 30

  • database = /var/lib/abiquo-aim.db

See AIM - Abiquo Infrastructure Management

Monitoring Privileges

There are three new Abiquo Privileges to control access to monitoring:

  • Access virtual machine metrics
  • Manage virtual machine metrics
  • Allow user to push own VM metrics

By default, on upgrades, these privileges are assigned to the cloud admin, enterprise admin, and user roles.

Virtual Machine Monitoring

The Abiquo UI displays the monitoring information and it is also available through the API.

The push custom metrics functionality is only available through the API.

Enable Monitoring

For each virtual machine, users with the Manage virtual machine metrics privilege can enable metrics fetching. Then they can select a set of metrics for monitoring from the list of metrics supported by the hypervisor or public cloud region.

To enable metrics fetching, work with a virtual machine that is:

  • undeployed
  • powered off

Edit the virtual machine and select the Monitoring tab.

Mark the checkbox to Fetch metrics.

Select the options and metrics you wish to enable. These will be different for each hypervisor and public cloud region.

Click Save.

Monitoring and Metrics in Virtual Machine View

To display the monitoring data, click the monitoring symbol on the virtual machine icon.

Click the refresh button  to update the display.

Monitoring and Metrics in Virtual Appliance View

The monitoring data is also shown on the Monitoring page of the Virtual Appliance view.

The Monitoring page does not update automatically. It only updates when you open the view or open a new virtual appliance.

To request page updates, mark the Refresh data each checkbox at the top of the page and enter or select a value from the selector. Note that the actual refresh interval depends on hypervisor or public cloud support for updates at the selected interval.

And you can always update the display of a metric by clicking the refresh button for that metric.

To filter the display of the metrics panels, select the filter icon in the top right-hand corner of the Monitoring page.

Metric Options in Virtual Appliance View

To display only some of the metrics, click the filter button  then select the checkboxes for the metrics to display.

To update the display of a metric, click the refresh button 

To configure the display of a specific metric, select the metric's filter button . The metric display configuration popup will open.

Select the granularity of the display, the type of statistic applied, and the last X hours to be displayed, counted backward from the current time.

To display the value of a line in the monitoring graph at a specific point, mouse over the line.

To mark a specific point on the line for future reference, click on the line.

Push custom metrics

See VirtualMachineMetricsResource

  • No labels