Documentation

Skip to end of metadata
Go to start of metadata

Introduction

The Abiquo virtual machine monitoring system displays virtual machine metrics and the user can configure alerts to notify if certain conditions are met within virtual appliances.

View virtual machine metrics on the Monitoring tab

If your virtual datacenter supports virtual machine monitoring, you can enable it for your virtual machines. See VM monitoring and metrics

After you have enabled monitoring for a virtual machine, on the Monitoring tab, you can configure the metrics view at a virtual appliance level.

To configure the refresh interval, select the Refresh data every checkbox and enter a number of minutes.

Then choose the metrics you wish to display and filter by metric statistics.

 

Display virtual machine alarms and alerts

To view alerts and their associated alarms, open the Control tab in the Virtual machines pane. To display the details of an alert in the lower Alerts panel, select an alert in the Alerts list at the top. To display alarms associated with an alert, select the tabs of the lower Alerts panel.

 

Manage alarms for alerts

  

To manage monitoring alarms and alarms and alerts for the virtual appliance, ideally you should have at least the Access alerts section, Manage alerts and Manage alarms privileges. From the virtual appliances screen, you can manage alarms for alerts, but you can only create alarms that are not assigned to alerts and assign them to alerts. You cannot edit or delete alarms that are not attached to alerts.

Create an alarm

To create an alarm for any virtual machine in the virtual appliance:

  1. At the top of the Alerts panel, click the + add button 
  2. From the pull-down list, select Create alarm
  3. Enter the alarm details
    1. In Abiquo 3.8, enter a unique alarm name
  4. Click Save

Field

Description

Name

Name of the alarm. The name can contain up to 128 characters. You can create more than one alarm with the same name, but only if the alarms are for different metrics. However, in Abiquo 3.8.0, you will need to be able to identify the alarms by name when creating an alert.

DescriptionDescribe the alarm
Virtual machineVirtual machine name, which by default is the virtual machine template name. Display only
MetricEnable fetch metrics on the monitoring tab to retrieve metrics for evaluation of the alarm. When you enable the retrieval of metrics, Abiquo will retrieve all metrics, even if you do not select them for display on the monitoring tab. For your alarm, select one of the metrics available for the virtual machine. In Abiquo 3.8.1+, you do not need to display a metric to use it with an alarm, but it may be helpful to do so.

Period

Elapsed time during which the platform will evaluate the alarm based on the statistic and the threshold. The minimum value is 60 seconds

Evaluation periods

Number of periods during which the platform will evaluate the alarm.

Statistic

Statistic that the platform will use for evaluating the alarm:

  • average
  • maximum
  • minimum
  • sum
  • count
  • dev

Formula

Operator that the platform will use for evaluation of the alarm, for example, greater than. Values can be:

  • notequal
  • greaterthan
  • greaterthanorequalto
  • lessthan
  • lessthanorequalto
  • trendup
  • trenddown

Threshold

Value that the platform will evaluate the alarm against, if appropriate

You can also select an alert and use the + add button on the lower alarms panel.

  • The platform will not automatically add alarms you create to a selected alert. However, you can easily edit an alert and add the new alarm
  • The only way to view or edit an alarm that is not added to an alert is through the virtual machine configuration at the Alarms tab, which requires the privilege to Access alarms section in virtual machines
Modify or delete an alarm associated with an alert

To modify or delete an alarm associated with an alert:

  1. In the virtual appliance, open the Control tab and select the alert
  2. In the lower Alerts panel, open the Alarms tab
  3. Select the alarm
  • To modify the alarm, click the pencil edit button, make your changes, and click Save
  • To delete the alarm, click the delete button, and confirm
    • The platform will delete it from all alerts that it is associated with
  • The only way to delete an alarm that is not added to an alert is through the virtual machine configuration at the Alarms tab, which requires the privilege to Access alarms section in virtual machines

Create alerts for virtual machines

Before you create an alert, remember to:

  1. Configure virtual machine monitoring:
    1. In the virtual machine configuration on the Metrics tab
      1. Select the Retrieve metrics checkbox to retrieve all metrics
      2. Optional: Select some metrics to display. Displaying the alarm metrics may be helpful, but it is not required
      3. Click Save
  2. Create alarms:
    • Edit the virtual machine configuration on the Alarms tab, OR
    • On the Virtual appliances Control tab, in the Alerts pane click the + add button and from the drop-down list, select Create alarm

To create an alert for a virtual appliance

  1. Open the virtual appliance Control tab
  2. Click the + add button
  3. From the drop-down list, select Create alert
  4. Enter the alert details and click Save

 

 

Field

Description

Name

Name of the alert. The name can contain up to 128 characters

DescriptionDescribe the alert
MutedSelect this checkbox to disable notifications for this alert

 

 

 

 

 

On the Alarms tab, assign alarms to the alert. If all alarms are activated, the alert will notify the users registered on the Actions tab.

 

On the Actions tab, enter the email address(es) to notify if the alarms are activated.

 

Click Save.