summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJenkins <jenkins@review.openstack.org>2015-06-18 10:34:14 +0000
committerGerrit Code Review <review@openstack.org>2015-06-18 10:34:15 +0000
commit4beccd45667dbd845c34c77d584f869891363d93 (patch)
tree7cbe19b845bb9a27255d66352ffce715cf916af5
parentf97c545a13ef68fd6e4ae466bb6c59651f967033 (diff)
parente64943ce2d381571baef1acd6dad32d7d0d7155d (diff)
Merge "add spec file"
-rw-r--r--spec/zabbix-monitoring-emc-plugin-spec.rst140
1 files changed, 140 insertions, 0 deletions
diff --git a/spec/zabbix-monitoring-emc-plugin-spec.rst b/spec/zabbix-monitoring-emc-plugin-spec.rst
new file mode 100644
index 0000000..9f480ee
--- /dev/null
+++ b/spec/zabbix-monitoring-emc-plugin-spec.rst
@@ -0,0 +1,140 @@
1..
2 This work is licensed under the Apache License, Version 2.0.
3
4 http://www.apache.org/licenses/LICENSE-2.0
5
6===================================================
7EMC hardware monitoring extension for Zabbix plugin
8===================================================
9
10EMC hardware monitoring extension plugin expands Zabbix plugin functionality by
11adding monitoring of incoming SNMP traps sent from EMC VNX arrays via management
12network to management VIP address. It configures snmptt to parse and pass EMC
13VNX specific traps to Zabbix. It also configures Zabbix by adding Template with
14appropriate items and triggers and by creating Hosts for each EMC VNX array.
15
16Problem description
17===================
18
19Currently, Zabbix plugin for Fuel has no support for receiving and analyzing
20EMC VNX specific SNMP traps. EMC hardware monitoring extension for Zabbix plugin
21aims to provide a support for it.
22
23Proposed change
24===============
25
26Implement a Fuel plugin that will configure snmptt and Zabbix for
27receiving and parsing EMC VNX specific SNMP traps.
28
29Alternatives
30------------
31
32It might have been implemented as part of Zabbix plugin for Fuel but we decided
33to make it as a separate plugin for several reasons:
34
35* This isn't something that all operators may want to deploy.
36* Any new additional functionality makes the project's testing more difficult,
37 which is an additional risk for the Zabbix plugin for Fuel release.
38
39Data model impact
40-----------------
41
42None
43
44REST API impact
45---------------
46
47None
48
49Upgrade impact
50--------------
51
52None
53
54Security impact
55---------------
56
57None
58
59Notifications impact
60--------------------
61
62None
63
64Other end user impact
65---------------------
66
67None
68
69Performance Impact
70------------------
71
72None
73
74Other deployer impact
75---------------------
76
77None
78
79Developer impact
80----------------
81
82None
83
84Implementation
85==============
86
87The plugin configures snmptt by adding EMC VNX specific SNMP traps definitions.
88It also configures Zabbix by doing following actions:
89
90* imports an EMC VNX monitoring template to Zabbix
91* creates Host for each EMC VNX array which will be sending SNMP traps
92* links EMC VNX monitoring template to created Hosts
93
94The plugin has two tasks:
95
96* The first task configures Zabbix.
97* The second task configures snmptt on Controller nodes.
98
99Assignee(s)
100-----------
101
102| Dmitry Klenov <dklenov@mirantis.com> (PM)
103| Piotr Misiak <pmisiak@mirantis.com> (developer)
104| Szymon Bańka <sbanka@mirantis.com> (developer)
105| Alexander Zatserklyany <azatserklyany@mirantis.com> (QA engineer)
106
107Work Items
108----------
109
110* Implement the Fuel plugin.
111* Implement the Puppet manifests.
112* Testing.
113* Write the documentation.
114
115Dependencies
116============
117
118* Fuel 6.1
119* Zabbix plugin for Fuel 1.0.0
120* SNMP trap daemon for Zabbix plugin 1.0.0
121
122Testing
123=======
124
125* Prepare a test plan.
126* Test the plugin by deploying environments with all Fuel deployment modes.
127
128Documentation Impact
129====================
130
131* User Guide (which features the plugin provides, how to use them in the
132 deployed OpenStack environment).
133* Test Plan.
134* Test Report.
135
136References
137==========
138
139* `Zabbix Documentation - SNMP traps
140 <https://www.zabbix.com/documentation/2.4/manual/config/items/itemtypes/snmptrap>`_