vitrage/doc/source/contributor/nova-notifier.rst
Ifat Afek b27a29fde3 Some documentation changes
- Added missing documentation of Nova notifier
- Moved osprofiler doc under contributor folder
- Marked the static-physical datasource as obsolete
- Removed a link to Aodh notifier (the document was deleted, as it was just a POC)

Depends-On: Ifcde995130486c859e6a9ce23e47a89910187732
Change-Id: Ib2b7880d65d4c6edd7cfd1f831da9da7af5e114c
2017-07-30 11:58:32 +00:00

48 lines
1.2 KiB
ReStructuredText

=====================
Vitrage Nova Notifier
=====================
Overview
--------
The main purpose of Vitrage is to provide insights about the state of the
system on problems that are not directly monitored. An example of such
a problem is a switch failure that causes a Nova host to become unreachable,
while Nova is not aware of this problem.
The Nova notifier tries to solve this use case, by calling Nova force-down API
to notify Nova that the host is down.
Configuration
-------------
In order to support this use case, the user should perform the following:
1. Activate the nova notifier. In /etc/vitrage/vitrage.conf:
.. code:: yaml
[DEFAULT]
notifiers = nova
2. Determine, in the Vitrage templates, what condition(s) indicates that the
host is down. For example:
.. code:: yaml
scenarios:
- scenario:
condition: host_down_alarm_on_host
actions:
action:
action_type : mark_down
action_target:
target: host
For more information about the mark-down action, see the Vitrage templates
documentation: templates_
.. _templates: https://docs.openstack.org/vitrage/latest/contributor/vitrage-template-format.html