Open Stack

We are excited to announce the release of:

vitrage 1.5.0: The OpenStack RCA Service

This release is part of the ocata stable release series.

The source is available from:

    http://git.openstack.org/cgit/openstack/vitrage

Download the package from:

    https://tarballs.openstack.org/vitrage/

For more details, please see below.

1.5.0
^^^^^

The main focus of Vitrage in the Ocata version was to enhance the
integration with external projects, to support more use cases, and to
give more value to the user.


New Features
************

* A new "Collectd Datasource" was added, to handle notifications
  coming from collectd. collectd is a fast system statistics
  collection daemon, with plugins that collect different metrics. We
  tested the DPDK plugin, that can trigger alarms such as interface
  failure or noisy neighbors.

* A new "Doctor Datasource" was added in order to support the OPNFV
  Doctor Inspector requirements. This datasource handles notifications
  sent from the Doctor monitor. If a "compute.host.down" notification
  arrives, the Doctor datasource will create an alarm on the host in
  Vitrage, call nova force-down API and create deduced alarms on the
  relevant instances and applications.

* The Vitrage "Static Datasource" is meant to define in a yaml file
  cloud resources that cannot be retrieved dynamically. Switches are a
  good example, as currently no OpenStack project provides information
  about them. In Newton, only switches could be defined in the static
  yaml files. In Ocata the file definition was enhanced, so the user
  can define practically everything. The new schema is subset of the
  Vitrage evaluator templates schema, to make it easier to use and
  maintain.

* The "Aodh Datasource" is used to collect alarms from Aodh and pass
  them to Vitrage, so Vitrage can correlate them with other alarms in
  the system. In Ocata we added support for receiving immediate
  notifications on alarm state changes from Aodh. This allows Vitrage
  to act immediately in case Aodh detects a problem and there is a
  need to trigger new alarms (e.g. on an application) or modify the
  states of resources.


Deprecation Notes
*****************

* The "static_physical" file format is deprecated. Please use the
  new "static" file format instead.

Changes in vitrage 1.4.0..1.5.0
-------------------------------

fd27b65 Added prelude to the Ocata release notes
10006a9 not condition
add310b Added Ocata release notes
4d7f675 no more mocks
fdb88a5 fix mapping to create an alarm on a resource other then host
c14ee5c Updated from global requirements
312617d Allow interchangeable graph class for the entity graph. Graph driver class is a configurable entry point using stevedore, can be changed in entry_points.txt and vitrage.conf. NetworkX graph - classes encapsulation, can now easily be replaced
7a2938d change the way I create a alarm id
544533c more tempests changes
a052423 Code refactoring - EntityGraph class functionality moved to a processor utils
6076a7c Rename `config_id` to `static_id`


Diffstat (except docs and test files)
-------------------------------------

devstack/gate_hook.sh                              |   3 +
devstack/plugin.sh                                 |   3 -
etc/vitrage/alarms.sample.json                     |  64 ---
.../datasources_values/network.interface.yaml      |  22 ++
etc/vitrage/graph.sample.json                      | 434 ---------------------
etc/vitrage/rca.sample.json                        |  65 ---
etc/vitrage/vitrage.conf.sample                    |   3 -
.../collectd-datasource-a730f06aff840c8f.yaml      |   6 +
.../notes/doctor-datasource-59ee5b2afb677ab4.yaml  |   8 +
.../notes/ocata-prelude-9b64d68bc898f7ec.yaml      |   5 +
...ic-datasource-refactoring-2cc7569fafbe65c6.yaml |  12 +
...upport-aodh-notifications-cc495f3bc137099d.yaml |   8 +
releasenotes/source/conf.py                        |   1 +
releasenotes/source/index.rst                      |  13 +-
requirements.txt                                   |   2 +-
setup.cfg                                          |   3 +
test-requirements.txt                              |   2 +-
vitrage/api/__init__.py                            |   3 -
vitrage/api/controllers/rest.py                    |  21 -
vitrage/api/controllers/v1/alarm.py                |   5 +-
vitrage/api/controllers/v1/rca.py                  |   5 +-
vitrage/api/controllers/v1/topology.py             |   5 +-
vitrage/api_handler/apis/rca.py                    |   3 +-
vitrage/api_handler/apis/template.py               |   2 +-
vitrage/api_handler/apis/topology.py               |   3 +-
vitrage/cmd/graph.py                               |   4 +-
vitrage/common/utils.py                            |  15 +
.../collectd/collectd_vitrage/vitrageplugin.py     |  45 ++-
vitrage/datasources/collectd/driver.py             |   8 +-
vitrage/datasources/collectd/properties.py         |   3 +
vitrage/datasources/collectd/transformer.py        |   8 +
vitrage/datasources/launcher.py                    |   1 +
vitrage/datasources/nova/zone/transformer.py       |   3 +-
vitrage/datasources/static/__init__.py             |   2 +-
vitrage/datasources/static/driver.py               |  16 +-
vitrage/datasources/static/transformer.py          |   4 +-
vitrage/entity_graph/__init__.py                   |  14 +
vitrage/entity_graph/processor/entity_graph.py     |  99 -----
vitrage/entity_graph/processor/processor.py        |  32 +-
vitrage/entity_graph/processor/processor_utils.py  |  58 +++
vitrage/evaluator/scenario_evaluator.py            |   9 +-
vitrage/graph/algo_driver/__init__.py              |  16 +-
vitrage/graph/algo_driver/networkx_algorithm.py    |  22 +-
vitrage/graph/driver/__init__.py                   |  13 -
vitrage/graph/driver/graph.py                      |  52 ++-
vitrage/graph/driver/networkx_graph.py             |  52 +--
vitrage/graph/driver/notifier.py                   |   4 +-
.../driver/driver_static_snapshot_dynamic.json     |   2 +-
.../static_datasources/switch_to_host.yaml         |  16 +-
.../unit/datasources/static/test_static_driver.py  |  10 +-
.../entity_graph/processor/test_entity_graph.py    |  88 ++---
.../unit/entity_graph/processor/test_processor.py  |   3 +-
71 files changed, 539 insertions(+), 1048 deletions(-)


Requirements updates
--------------------

diff --git a/requirements.txt b/requirements.txt
index 17d1f51..2e276d7 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -13 +13 @@ python-neutronclient>=5.1.0 # Apache-2.0
-python-novaclient!=2.33.0,>=2.29.0 # Apache-2.0
+python-novaclient!=7.0.0,>=6.0.0 # Apache-2.0
diff --git a/test-requirements.txt b/test-requirements.txt
index bcb362e..02fea7f 100644
--- a/test-requirements.txt
+++ b/test-requirements.txt
@@ -13 +13 @@ python-neutronclient>=5.1.0 # Apache-2.0
-python-novaclient!=2.33.0,>=2.29.0 # Apache-2.0
+python-novaclient!=7.0.0,>=6.0.0 # Apache-2.0