1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
=================
Vitrage Use Cases
=================
Add Nova Instance
-----------------
.. image:: ./images/add_nova_instance_flow.png
:width: 100%
:align: center
#. Nova datasource Driver queries all Nova instances, or gets a message bus
notification about a new Nova instance
#. Nova datasource Driver sends corresponding events to the Entity Queue
#. The Entity Processor polls the Entity Queue and gets the new Nova Instance
event
#. The Entity Processor passes the event to the Nova Instance Transformer,
which returns a Vertex with the instance data, with an edge to the host
Vertex in the graph
#. The Entity Processor adds the new vertex and edge to the Graph
.. image:: ./images/add_nova_instance_graph.png
:width: 100%
:align: center
Add Aodh Alarm
--------------
.. image:: ./images/add_aodh_alarm_flow.png
:width: 100%
:align: center
#. Aodh Driver queries all Aodh alarms
#. Aodh Driver sends corresponding events to the Entity Queue
#. The Entity Processor polls the Entity Queue and gets the Aodh Alarm event,
for example threshold alarm on Instance-1 CPU
#. The Entity Processor passes the event to the Aodh Alarm Transformer, which
returns a Vertex with the alarm data, with an edge to the instance Vertex
#. The Entity Processor adds the new vertex and edge to the Graph
.. image:: ./images/add_aodh_alarm_graph.png
:width: 100%
:align: center
Nagios Alarm Causes Deduced Alarm
---------------------------------
.. image:: ./images/nagios_causes_deduced_flow.png
:width: 100%
:align: center
5. (steps 1-4) Nagios datasource driver pushes a nagios alarm on a switch to
the Entity Queue, which is converted by Nagios Transformer to a vertex and
inserted to the Graph
6. The Evaluator is notified about a new Vertex (Nagios switch alarm) that was
added to the graph
7. The Evaluator performs its calculations and deduces that alarms should be
triggered on every instance on every host attached to this switch
8. The Evaluator pushes alarms to the Entity Queue
9. The graph is updated with these new alarms
10. The graph writes to the message bus that new alarms were created
11. Aodh Notifier creates new alarm definitions in Aodh, and sets their states
to "alarm"
.. image:: ./images/nagios_causes_deduced_graph.png
:width: 100%
:align: center
Create RCA Insights
-------------------
.. image:: ./images/rca_flow.png
:width: 100%
:align: center
#. The Evaluator is notified of a new alarm *Alarm-X*.
#. The Evaluator evaluates the templates and the Graph, and decides that there
is a root cause relation between *Alarm-X* and *Alarm-Y*. It adds a "causes"
edge to the Graph
.. image:: ./images/rca_graph.png
:width: 100%
:align: center
Note that in future versions the graph with RCA information may become more
complex, for example:
.. image:: ./images/complex_rca_graph.png
:width: 100%
:align: center
|
