vitrage-specs/specs/ocata/collectd-datasource.rst

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/