API extension for fpinging instances

Registered by Alexej Ababilov

It may be interesting for a cloud user or administrator to perform a simple instance monitoring. A ping could be an acceptable solution: it is fast and it quite reliable.

Proposed API calls.

GET /os-fping?[all_tenants=1]&[include=uuid[,uuid...][&exclude=...]

Performs fping for all VM in the current project and returns results. If `all_tenants` is requested, returns data for all projects.
`include` and `exclude` are parameters specifying VM masks. Consider that VM list is `VM_all`, then if `include` is set, the result will be `VM_all * VM_include`. if `include` is set, the result will be `VM_all - VM_exclude`. `exclude` is ignored if `include` is specified.

Response: {“servers": [
{“id”: “038ab3ef-88d8-4be4-9587-ec37e59722e3”, “project_id”: “112”, “alive”: true}
]}

GET /os-fping/<vm-uuid>
Performs a check for single instance.

Response: {“server”: {
{“id”: “038ab3ef-88d8-4be4-9587-ec37e59722e3”, “project_id”: “112”, “alive”: true}
}

This API can be useful for a daemon that periodically polls VMs and sends notification for interested users.

Future plan: store `monitored` flag for VMs. It affects `GET /os-fping` call. VMs with this flag are always considered as `excluded` if `exclude` parameter is not specified.
This flag can be changed with the following call.

PUT /os-fping/vms/<vm-id>
Request body: {“monitored”: true}
Response: {“vm”: {
{“id”: “038ab3ef-88d8-4be4-9587-ec37e59722e3”, “project_id”: “112”, “monitored”: true, “alive”: true}
}

Blueprint information

Status:
Complete
Approver:
None
Priority:
Undefined
Drafter:
Alexej Ababilov
Direction:
Needs approval
Assignee:
Alexej Ababilov
Definition:
Obsolete
Series goal:
None
Implementation:
Unknown
Milestone target:
None
Completed by
John Garbutt

Related branches

Sprints

Whiteboard

Not sure this is an appropriate extension for core. Discussion on the review. --Vish

Gerrit topic: https://review.openstack.org/#q,topic:bp/fping-instances-ext,n,z

Addressed by: https://review.openstack.org/12133
    API extension for fpinging instancesNot sure this is an appropriate extension for core. Discussion on the review. --Vish

Gerrit topic: https://review.openstack.org/#q,topic:bp/fping-instances-ext,n,z

Addressed by: https://review.openstack.org/12133
    API extension for fpinging instances

This blueprint is not complete after a good year or so, marking as Obsolete to tidy up the Nova backlog. --johnthetubaguy (20th April 2014)

(?)

Work Items

This blueprint contains Public information 
Everyone can see this information.

Subscribers

No subscribers.