- Created by MS, last modified on Mar 19, 2018
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 2 Next »
VM monitoring and metrics via API tutorial
This tutorial will show you the basics of working with VM monitoring and metrics via API.
To work through this tutorial, you will need:
- A VM that is not deployed (or powered off)
- This tutorial uses an example VM that is not deployed
- A monitoring server and a user with the privileges to Manage virtual machine metrics (USERS_ENABLE_DISABLE_VM_METRICS)
- ??? User with privileges to work with VMs and Manage virtual machine backup configuration (VAPP_MANAGE_BACKUP) because backups previously used metadata
Get the VM and the link to enable monitoring
To get started, use a query to retrieve all of your VMs from the cloud and select the desired VM. Here we are filtering the VMs using the "has" parameter to select one using part of the name, which is an easy way to find a VM that you have located in the UI.
curl -X GET https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualmachines?has=ABQ_4fd49a02 \ -H "Accept: application/vnd.abiquo.virtualmachines+json; version=4.2" \ -u user:password --verbose | pjson
Success status code: 200
Response:
{ "links": [ { "rel": "first", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualmachines?limit=25&has=ABQ_4fd49a02&by=name&asc=true" }, { "rel": "last", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualmachines?startwith=0&limit=25&has=ABQ_4fd49a02&by=name&asc=true" } ], "collection": [ { "id": 12, "uuid": "4fd49a02-033a-4e0a-b27b-a295f6f858a4", "name": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "label": "yVM (9)", "description": "A virtual machine", "cpu": 1, "ram": 48, "vdrpEnabled": false, "vdrpPort": 0, "idState": 1, "state": "NOT_ALLOCATED", "idType": 0, "type": "MANAGED", "highDisponibility": 0, "password": "h0gfuBUu", "metadata": null, "monitored": false, "protected": false, "variables": {}, "creationTimestamp": 1520595596000, "backuppolicies": [], "generateGuestInitialPassword": false, "natrules": [], "links": [ { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "edit", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "Abiquo", "rel": "enterprise", "type": "application/vnd.abiquo.enterprise+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/admin/enterprises/1" }, { "title": "Cloud Administrator", "rel": "user", "type": "application/vnd.abiquo.user+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/admin/enterprises/1/users/1" }, { "title": "MJ_backup", "rel": "virtualdatacenter", "type": "application/vnd.abiquo.virtualdatacenter+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2" }, { "title": "vapp_mj_backup", "rel": "virtualappliance", "type": "application/vnd.abiquo.virtualappliance+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3" }, { "title": "metadata", "rel": "metadata", "type": "application/vnd.abiquo.metadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metadata" }, { "title": "vlan network configurations", "rel": "configurations", "type": "application/vnd.abiquo.virtualmachinenetworkconfigurations+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/network/configurations" }, { "title": "nics", "rel": "nics", "type": "application/vnd.abiquo.nics+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/network/nics" }, { "title": "disks", "rel": "harddisks", "type": "application/vnd.abiquo.harddisks+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/storage/disks" }, { "title": "NOT_ALLOCATED", "rel": "state", "type": "application/vnd.abiquo.virtualmachinestate+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/state" }, { "title": "virtual machine undeploy", "rel": "undeploy", "type": "application/vnd.abiquo.acceptedrequest+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/action/undeploy" }, { "title": "virtual machine deploy", "rel": "deploy", "type": "application/vnd.abiquo.acceptedrequest+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/action/deploy" }, { "title": "virtual machine reset", "rel": "reset", "type": "application/vnd.abiquo.acceptedrequest+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/action/reset" }, { "title": "virtual machine snapshot", "rel": "instance", "type": "application/vnd.abiquo.acceptedrequest+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/action/instance" }, { "title": "remote access", "rel": "rdpaccess", "type": "application/vnd.abiquo.virtualmachineconsole+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/config/rdpaccess" }, { "title": "tasks", "rel": "tasks", "type": "application/vnd.abiquo.tasks+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/tasks" }, { "title": "firewalls", "rel": "firewalls", "type": "application/vnd.abiquo.links+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/firewalls" }, { "title": "load balancers", "rel": "loadbalancers", "type": "application/vnd.abiquo.loadbalancers+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/loadbalancers" }, { "title": "request on demand backup", "rel": "requestbackup", "type": "application/vnd.abiquo.ondemandbackup+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/backup/action/request" }, { "title": "request a restore of a backup", "rel": "requestrestore", "type": "application/vnd.abiquo.restore+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/backup/action/restore" }, { "title": "volumes", "rel": "volumes", "type": "application/vnd.abiquo.volumes+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/storage/volumes" }, { "diskControllerType": "IDE", "diskLabel": "Hard disk 1", "length": "64", "title": "8629d108-9b47-4014-8256-eebf5ff25ec0", "rel": "disk0", "type": "application/vnd.abiquo.harddisk+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/disks/18" }, { "title": "protect", "rel": "protect", "type": "text/plain", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/action/protect" }, { "title": "unprotect", "rel": "unprotect", "type": "text/plain", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/action/unprotect" }, { "title": "metricsmetadata", "rel": "metricsmetadata", "type": "application/vnd.abiquo.metricsmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics" }, { "title": "enablemonitoring", "rel": "enablemonitoring", "type": "", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/enablemonitoring" }, { "title": "collectd", "rel": "collectd", "type": "application/json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/collectd" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/alarms" }, { "title": "actionplans", "rel": "actionplans", "type": "application/vnd.abiquo.virtualmachineactionplans+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/actionplans" }, { "title": "actionplansflat", "rel": "actionplansflat", "type": "application/vnd.abiquo.virtualmachineactionplansflat+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/actionplans" }, { "title": "clone", "rel": "clone", "type": "application/vnd.abiquo.virtualmachinecloneoptions+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/action/clone" }, { "title": "KVM", "rel": "hypervisortype", "type": "application/vnd.abiquo.hypervisortype+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/config/hypervisortypes/KVM" }, { "title": "yVM", "rel": "virtualmachinetemplate", "type": "application/vnd.abiquo.virtualmachinetemplate+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/admin/enterprises/1/datacenterrepositories/1/virtualmachinetemplates/3" }, { "title": "Others", "rel": "category", "type": "application/vnd.abiquo.category+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/config/categories/1" } ] } ], "totalSize": 1, "duplicatedvms": [] }
From the VM data object, we will now focus on the monitoring and metrics attributes and links.
First note that the "monitored" attribute has a value of "false", which means that the platform will not fetch metrics for the VM. Also note that the VM metadata does not have a "monitoring-metrics" object.
"metadata": null, "monitored": false
Also from the VM data object, note the link to access metrics, which is as follows.
{ "title": "metricsmetadata", "rel": "metricsmetadata", "type": "application/vnd.abiquo.metricsmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics" },
Later on, we will also need the VM metadata link to store the names of the specific metrics to retrieve.
{ "title": "metadata", "rel": "metadata", "type": "application/vnd.abiquo.metadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metadata" },
The link to enable monitoring and metrics fetch is the one with the "rel" value of "enablemonitoring".
{ "title": "enablemonitoring", "rel": "enablemonitoring", "type": "", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/enablemonitoring" },
Obtain the metrics available for the VM
First to obtain all the information about the metrics available for the VM, perform a GET request to metricsmetadata link.
curl -X GET https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics \ -H "Accept: application/vnd.abiquo.metricsmetadata+json; version=4.2" \ -u user:password --verbose | pjson
The request returns a lot of information including links that you can use to access the data for retrieved metrics when the VM is deployed.
{ "links": [ { "title": "metricsmetadata", "rel": "self", "type": "application/vnd.abiquo.metricsmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "collection": [ { "links": [ { "title": "disk_rd_requests_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_requests_total" }, { "title": "disk_rd_requests_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_requests_total" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_requests_total/alarms" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "disk_rd_requests_total", "description": "total read requests of the block devices", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "cpu_usage", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/cpu_usage" }, { "title": "cpu_usage", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/cpu_usage" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/cpu_usage/alarms" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "cpu_usage", "description": "cpu usage charged to user instructions", "unit": "percentage", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "vcpu_number", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/vcpu_number" }, { "title": "vcpu_number", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/vcpu_number" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/vcpu_number/alarms" } ], "name": "vcpu_number", "description": "number of vcpus", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/cpu_time/alarms" }, { "title": "cpu_time", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/cpu_time" }, { "title": "cpu_time", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/cpu_time" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "cpu_time", "description": "cpu time charged to user instructions", "unit": "nanoseconds", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_requests_total/alarms" }, { "title": "disk_wr_requests_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_requests_total" }, { "title": "disk_wr_requests_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_requests_total" } ], "name": "disk_wr_requests_total", "description": "total write requests of the block devices", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "vcpu_time", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/vcpu_time" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/vcpu_time/alarms" }, { "title": "vcpu_time", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/vcpu_time" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "vcpu_time", "description": "vcpu time (cpu_time excluding hypervisor time)", "unit": "nanoseconds", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_bytes_total/alarms" }, { "title": "if_rx_bytes_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_bytes_total" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "if_rx_bytes_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_bytes_total" } ], "name": "if_rx_bytes_total", "description": "total number of received bytes of the network interfaces", "unit": "bytes", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_rx_drops_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_drops_total" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "if_rx_drops_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_drops_total" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_drops_total/alarms" } ], "name": "if_rx_drops_total", "description": "total drops on receive of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "vcpu_usage", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/vcpu_usage" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/vcpu_usage/alarms" }, { "title": "vcpu_usage", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/vcpu_usage" } ], "name": "vcpu_usage", "description": "vcpu usage (cpu_time excluding hypervisor time)", "unit": "percentage", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_tx_packets", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_packets" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_packets/alarms" }, { "title": "if_tx_packets", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_packets" } ], "name": "if_tx_packets", "description": "transmitted packets of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_packets_total/alarms" }, { "title": "if_tx_packets_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_packets_total" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "if_tx_packets_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_packets_total" } ], "name": "if_tx_packets_total", "description": "total transmitted packets of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "disk_wr_bytes_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_bytes_total" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_bytes_total/alarms" }, { "title": "disk_wr_bytes_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_bytes_total" } ], "name": "disk_wr_bytes_total", "description": "total number of write bytes of the block devices", "unit": "bytes", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "disk_wr_requests", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_requests" }, { "title": "disk_wr_requests", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_requests" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_requests/alarms" } ], "name": "disk_wr_requests", "description": "write requests of the block devices", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "disk_rd_requests", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_requests" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_requests/alarms" }, { "title": "disk_rd_requests", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_requests" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "disk_rd_requests", "description": "read requests of the block devices", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_rx_packets", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_packets" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_packets/alarms" }, { "title": "if_rx_packets", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_packets" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "if_rx_packets", "description": "received packets of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_bytes/alarms" }, { "title": "if_tx_bytes", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_bytes" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "if_tx_bytes", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_bytes" } ], "name": "if_tx_bytes", "description": "number of transmitted bytes of the network interfaces", "unit": "bytes", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_drops/alarms" }, { "title": "if_tx_drops", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_drops" }, { "title": "if_tx_drops", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_drops" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "if_tx_drops", "description": "drops on transmit of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "used_mem", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/used_mem" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/used_mem/alarms" }, { "title": "used_mem", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/used_mem" } ], "name": "used_mem", "description": "the memory used by the domain", "unit": "KBytes", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_errors_total/alarms" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "if_rx_errors_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_errors_total" }, { "title": "if_rx_errors_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_errors_total" } ], "name": "if_rx_errors_total", "description": "total errors on receive of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_tx_bytes_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_bytes_total" }, { "title": "if_tx_bytes_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_bytes_total" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_bytes_total/alarms" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "if_tx_bytes_total", "description": "total number of transmitted bytes of the network interfaces", "unit": "bytes", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_tx_errors_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_errors_total" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_errors_total/alarms" }, { "title": "if_tx_errors_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_errors_total" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "if_tx_errors_total", "description": "total errors on transmit of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_drops/alarms" }, { "title": "if_rx_drops", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_drops" }, { "title": "if_rx_drops", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_drops" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "if_rx_drops", "description": "drops on receive of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_rx_errors", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_errors" }, { "title": "if_rx_errors", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_errors" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_errors/alarms" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "if_rx_errors", "description": "errors on receive of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_bytes/alarms" }, { "title": "disk_wr_bytes", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_bytes" }, { "title": "disk_wr_bytes", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_wr_bytes" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "disk_wr_bytes", "description": "number of write bytes of the block devices", "unit": "bytes", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_tx_drops_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_drops_total" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "if_tx_drops_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_drops_total" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_drops_total/alarms" } ], "name": "if_tx_drops_total", "description": "total drops on transmit of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_bytes_total/alarms" }, { "title": "disk_rd_bytes_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_bytes_total" }, { "title": "disk_rd_bytes_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_bytes_total" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "disk_rd_bytes_total", "description": "total number of read bytes of the block devices", "unit": "bytes", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_bytes/alarms" }, { "title": "disk_rd_bytes", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_bytes" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "disk_rd_bytes", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/disk_rd_bytes" } ], "name": "disk_rd_bytes", "description": "number of read bytes of the block devices", "unit": "bytes", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_rx_packets_total", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_packets_total" }, { "title": "if_rx_packets_total", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_packets_total" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_packets_total/alarms" } ], "name": "if_rx_packets_total", "description": "total received packets of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_tx_errors", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_errors" }, { "title": "if_tx_errors", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_errors" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_tx_errors/alarms" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" } ], "name": "if_tx_errors", "description": "errors on transmit of the network interfaces", "unit": "", "namespace": "virtualmachine", "dimensions": {} }, { "links": [ { "title": "if_rx_bytes", "rel": "metric", "type": "application/vnd.abiquo.metric+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_bytes" }, { "title": "ABQ_4fd49a02-033a-4e0a-b27b-a295f6f858a4", "rel": "virtualmachine", "type": "application/vnd.abiquo.virtualmachine+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12" }, { "title": "alarms", "rel": "alarms", "type": "application/vnd.abiquo.alarms+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_bytes/alarms" }, { "title": "if_rx_bytes", "rel": "self", "type": "application/vnd.abiquo.metricmetadata+json", "href": "https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metrics/if_rx_bytes" } ], "name": "if_rx_bytes", "description": "number of received bytes of the network interfaces", "unit": "bytes", "namespace": "virtualmachine", "dimensions": {} } ] }
To start with, we will use the name attributes of metrics to fetch specific metrics for the VM, in this example, the "vcpu_time" and "used_mem".
Enable monitoring and fetch metrics
When you enable monitoring in the UI, you edit the VM and go to the Monitoring and Metrics tab, select "Fetch metrics" and select the metrics to retrieve.
In the API, we will do this in two steps. First send a POST request to the link with the "rel" value of "enablemonitoring".
curl -X POST https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/enablemonitoring \ -H 'Accept:text/json,application/json' \ -u user:password --verbose
For the example VM, which is undeployed, the successful request returns a status code of 204 with no content.
However, the platform will not retrieve any metrics yet.
Prepare a metadata object
To retrieve specific metrics, add the metric names to the VM metadata.
Writing to metadata overwrites all existing metadata, so always start with a GET request to retrieve the existing metadata to use as the base object for adding metadata.
curl -X GET https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metadata \ -H 'Accept:application/vnd.abiquo.metadata+json; version=4.2' \ -u user:password --verbose
In this example, the metadata was null but it could contain user data, a startup script, Chef integration data, and so on.
Here we replaced the null metadata value with a "monitoring-metrics" attribute, with a list two metric names from the metricsmetadata request above.
{ "links": [], "metadata": { "monitoring-metrics": [ { "name": "vcpu_time" }, { "name": "used_mem" } ] } }
Update VM metadata
To update the VM metadata, perform a PUT request to the VM metadata link.
curl -X PUT https://mjsabiquo.bcn.abiquo.com:443/api/cloud/virtualdatacenters/2/virtualappliances/3/virtualmachines/12/metadata \ -H 'Accept:application/vnd.abiquo.metadata+json; version=4.2' \ -H 'Content-Type:application/vnd.abiquo.metadata+json; version=4.2' \ -d @requestpayload.json \ -u user:password --verbose
In this case, the requestpayload.json file should contain the JSON object from the previous step.
{ "links": [], "metadata": { "monitoring-metrics": [ { "name": "cpu_time" }, { "name": "used_mem" } ] } }
If the request is successful, it will return a status code of 200 and the updated metadata object.
{ "links": [], "metadata": { "monitoring-metrics": [ { "name": "cpu_time" }, { "name": "used_mem" } ] } }
Now when you access the VM in the UI, you should see the metrics symbol on the VM icon. If you deploy the VM and wait a little while, the platform should display the requested metrics.
- No labels