vitrage-specs/specs/ocata/collectd-datasource.rst
Eyal 86b30451d8 add blueprint for collectd datasource
Change-Id: I402a808af9b15b190a3e6654cab45d434a475dc2
2017-01-11 08:17:43 +00:00

88 lines
1.7 KiB
ReStructuredText

This work is licensed under a Creative Commons Attribution 3.0 Unported
License.
http://creativecommons.org/licenses/by/3.0/legalcode
====================
Collectd Data Source
====================
https://blueprints.launchpad.net/vitrage/+spec/collectd-datasource
This blueprint describes the datasource that will receive notifications from
collectd.
Problem description
===================
Vitrage should be able to accept a collectd notification.
Proposed change
===============
The Collectd datasource will receive notifications in the following format:
::
{
"host": "compute-1",
"plugin": "ovs_events",
"plugin_instance": "br-ex",
"type": "gauge",
"type_instance": "link_status",
"message": "link state of "br-ex" interface has been changed to "WARNING,"",
"severity": "WARNING",
"time": 1482409029.062524,
"id": "46c7eba7753efb0e6f6a8de24c949c52"
}
Upon receiving such a notification, the Collectd datasource will create a
corresponding alarm in Vitrage. When receiving an ok
notification, the alarm will be deleted.
In addition, a new evaluator template will be added in order to:
- Create deduced alarms on the VMs running on the host
- Modify the states of the host and the VMs to ERROR
Alternatives
------------
None
Data model impact
-----------------
None
REST API impact
---------------
None
Implementation
==============
Assignee(s)
-----------
Primary assignee:
eyal bar ilan
Work Items
----------
- Implement the Collectd datasource
- Write a template for creating deduced alarms on the VMs and calling Nova
mark host down
Testing
=======
The changes will be tested by unit tests
References
==========
- https://collectd.org/