Documentation
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:
- At the top of the Alerts panel, click the + add button
- From the pull-down list, select Create alarm
- Enter the alarm details
- In Abiquo 3.8, enter a unique alarm name
- 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. |
| Description | Describe the alarm |
| Virtual machine | Virtual machine name, which by default is the virtual machine template name. Display only |
| Metric | Enable 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:
|
Formula | Operator that the platform will use for evaluation of the alarm, for example, greater than. Values can be:
|
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:
- In the virtual appliance, open the Control tab and select the alert
- In the lower Alerts panel, open the Alarms tab
- 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:
- Configure virtual machine monitoring:
- In the virtual machine configuration on the Metrics tab
- Select the Retrieve metrics checkbox to retrieve all metrics
- Optional: Select some metrics to display. Displaying the alarm metrics may be helpful, but it is not required
- Click Save
- In the virtual machine configuration on the Metrics tab
- 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
- Open the virtual appliance Control tab
- Click the + add button
- From the drop-down list, select Create alert
- Enter the alert details and click Save
Field | Description |
|---|---|
Name | Name of the alert. The name can contain up to 128 characters |
| Description | Describe the alert |
| Muted | Select 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.
Overview
Content Tools
