Merge "add blueprint for collectd datasource"

specs/ocata/collectd-datasource.rst

@@ -0,0 +1,87 @@
+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/