diff --git a/specs/zabbix-monitoring-extreme-networks-plugin-spec.rst b/specs/zabbix-monitoring-extreme-networks-plugin-spec.rst new file mode 100644 index 0000000..2d67c51 --- /dev/null +++ b/specs/zabbix-monitoring-extreme-networks-plugin-spec.rst @@ -0,0 +1,142 @@ +.. + This work is licensed under the Apache License, Version 2.0. + + http://www.apache.org/licenses/LICENSE-2.0 + +================================================================ +Extreme Networks hardware monitoring extension for Zabbix plugin +================================================================ + +Extreme Networks hardware monitoring extension plugin expands Zabbix plugin +functionality by adding monitoring of incoming SNMP traps sent from Extreme +Networks hardware via management network to management VIP address. +It configures snmptt to parse and pass Extreme Networks specific traps to +Zabbix. It also configures Zabbix by adding Template with appropriate items +and triggers and by creating Hosts for each Extreme Networks hardware. + +Problem description +=================== + +Currently, Zabbix plugin for Fuel has no support for receiving and analyzing +Extreme Networks specific SNMP traps. Extreme Networks hardware monitoring +extension for Zabbix plugin aims to provide a support for it. + +Proposed change +=============== + +Implement a Fuel plugin that will configure snmptt and Zabbix for +receiving and parsing Extreme Networks specific SNMP traps. + +Alternatives +------------ + +It might have been implemented as part of Zabbix plugin for Fuel but we decided +to make it as a separate plugin for several reasons: + +* This isn't something that all operators may want to deploy. +* Any new additional functionality makes the project's testing more difficult, + which is an additional risk for the Zabbix plugin for Fuel release. + +Data model impact +----------------- + +None + +REST API impact +--------------- + +None + +Upgrade impact +-------------- + +None + +Security impact +--------------- + +None + +Notifications impact +-------------------- + +None + +Other end user impact +--------------------- + +None + +Performance Impact +------------------ + +None + +Other deployer impact +--------------------- + +None + +Developer impact +---------------- + +None + +Implementation +============== + +The plugin configures snmptt by adding Extreme Networks specific SNMP traps +definitions. It also configures Zabbix by doing following actions: + +* imports an Extreme Networks monitoring template to Zabbix +* creates Host for each Extreme Networks hardware which will be sending + SNMP traps +* links Extreme Networks monitoring template to created Hosts + +The plugin has two tasks: + +* The first task configures Zabbix. +* The second task configures snmptt on Controller nodes. + +Assignee(s) +----------- + +| Dmitry Klenov (PM) +| Piotr Misiak (developer) +| Szymon Bańka (developer) +| Alexander Zatserklyany (QA engineer) + +Work Items +---------- + +* Implement the Fuel plugin. +* Implement the Puppet manifests. +* Testing. +* Write the documentation. + +Dependencies +============ + +* Fuel 6.1 +* Zabbix plugin for Fuel 1.0.0 +* SNMP trap daemon for Zabbix plugin 1.0.0 + +Testing +======= + +* Prepare a test plan. +* Test the plugin by deploying environments with all Fuel deployment modes. + +Documentation Impact +==================== + +* User Guide (which features the plugin provides, how to use them in the + deployed OpenStack environment). +* Test Plan. +* Test Report. + +References +========== + +* `Zabbix Documentation - SNMP traps + `_