From 9b46fbf79c27b3824d361f65a6ab339ddbfd75d0 Mon Sep 17 00:00:00 2001 From: Miruna Paun Date: Wed, 15 Nov 2017 18:27:49 +0100 Subject: Updated the Zabbix Config and added Ceph Storage Issue USERDOCAP-260, COSNOSCR-576 Signed-off-by: Miruna Paun --- .../doc/high_availability.xml | 205 +++++++++++++-------- .../doc/images/Zabbix_Action.svg | 3 + .../doc/images/Zabbix_ActionOperations.png | Bin 0 -> 26507 bytes .../doc/images/Zabbix_ActionOperations.svg | 3 + .../doc/images/Zabbix_Home.svg | 3 + .../doc/images/Zabbix_MediaNotifications.PNG | Bin 0 -> 8927 bytes .../doc/images/Zabbix_MediaNotifications.svg | 3 + .../doc/images/Zabbix_MediaType.svg | 3 + .../doc/images/Zabbix_User.svg | 3 + .../doc/known_bugs_and_limitations.xml | 15 +- 10 files changed, 154 insertions(+), 84 deletions(-) create mode 100644 book-enea-nfv-core-installation-guide/doc/images/Zabbix_Action.svg create mode 100644 book-enea-nfv-core-installation-guide/doc/images/Zabbix_ActionOperations.png create mode 100644 book-enea-nfv-core-installation-guide/doc/images/Zabbix_ActionOperations.svg create mode 100644 book-enea-nfv-core-installation-guide/doc/images/Zabbix_Home.svg create mode 100644 book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaNotifications.PNG create mode 100644 book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaNotifications.svg create mode 100644 book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaType.svg create mode 100644 book-enea-nfv-core-installation-guide/doc/images/Zabbix_User.svg diff --git a/book-enea-nfv-core-installation-guide/doc/high_availability.xml b/book-enea-nfv-core-installation-guide/doc/high_availability.xml index 5854e6c..41d107b 100644 --- a/book-enea-nfv-core-installation-guide/doc/high_availability.xml +++ b/book-enea-nfv-core-installation-guide/doc/high_availability.xml @@ -294,33 +294,45 @@
Zabbix Configuration for Push Notifications - Vitrage supports Zabbix datasource by means of regularly polling - the Zabbix agents, which need to be configured in advance. The Vitrage - plugin developed internally by Enea can automatically configure Zabbix - so that everything works as expected. Polling however, is not fast - enough for a telco use-case, so it is necessary to configure push - notifications for Zabbix . This requires manual configuration on one of - the controller nodes, since Zabbix uses a centralized database which - makes the configuration available on all the other nodes. + Vitrage supports Zabbix datasource by regularly polling the Zabbix + agents, which need to be configured in advance. + + The Vitrage plugin developed internally by Enea can automatically + configure Zabbix so that everything works as expected. Polling however, + is not fast enough for a telco use-case, so it is necessary to configure + push notifications for Zabbix . This requires manual configuration on + one of the controller nodes, which will be used by the centralized + database making the configuration available on all the other + nodes. The Zabbix configuration dashboard is available at the same IP address where OpenStack can be reached, e.g. http://10.0.6.42/zabbix. - - + + + + + + To forward Zabbix events to Vitrage, a new media script needs to - be created and associated with a user. Follow the steps below as a - Zabbix Admin user: + be created and associated with a Zabbix Admin user. + + To create the + zabbix_vitrage.py - Create a new media type [Admininstration Media Types > - Create Media Type] + Create a new media type by selecting the Media + Types tab under the Admininstration, + tab and choosing Create Media Type. + + Now fill each parameter field with the values given below, + before clicking add: @@ -335,67 +347,105 @@ Script name: zabbix_vitrage.py + + + + + + + + + + - Modify the Media for the Admin user [Administration - Users] - - Click on the Admin user, go to the Media tab and click - Add. + Go to the User tab by clicking on the + Administration and next to the field + Groups, click Add. In this + screen: - Type: Vitrage Notifications + Check the Zabbix Administrators checkbox - Send to: - rabbit://rabbit_user:rabbit_pass@127.0.0.1:5672/ - --- Vitrage message bus url (you need to search for - this in /etc/vitrage/vitrage.conf or - /etc/nova/nova.conf transport_url) It's also vital - that the url contains the ending "/". + Click Select - When active: 1-7, 00:00-24:00 + Click Update + + + + + + + + + + + + + + + Next select the Media tab and and click + Add to create and modify a new media type. A + popup menu will appear for New Media, fill each + field with the values below: + - Use if severity: (all) + Type: Vitrage Notifications - Status: Enabled + Send to: e.g. + rabbit://rabbit_user:rabbit_pass@127.0.0.1:5672/ --- + Vitrage message bus url. + + You need to search for this in + /etc/vitrage/vitrage.conf or in /etc/nova/nova.conf + transport_url. It is vital that the url contains the + ending " / ". - Click Update. + When active: 1-7, 00:00-24:00 - - - Go to User tab and next to Groups list click - Add. - - Check Zabbix Administrators checkbox + Use if severity: (all) - Click Select. + Status: Enabled - Click Update. + Click Update + + + + + + + + + + - Configure Action [Configuration > Actions > Create - Action > Action] + To configure an action, select Actions + under the Configuration tab. Then, under the + Action tab, fill in the parameter fields with the + values below and click Add @@ -419,66 +469,69 @@ expression={TRIGGER.EXPRESSION} value={TRIGGER.VALUE} priority={TRIGGER.NSEVERITY} lastchange={EVENT.DATE} {EVENT.TIME} - - - To send events add under the Conditions - tab: "Maintenance status not in "maintenance"" and remove - Trigger value = PROBLEM. - + + + + - - Click Operations tab: + + + + + + - - Under Action operatsion click New - + + To send events, in the Conditions tab shown + above, make sure Maintenance status not in + "maintenance" added and remove Trigger value = + PROBLEM, before saving your changes. + + + + In the Operations tab, configure the users you wish to send + to: + - In the Operations details section select + In Operations Details, set: - Send to Users: Admin + Operation Type: Send message + + + + Send to Users: add Admin Send only to: Vitrage Notifications - - - Click Add in the Operarion details section + + + + + + + + + - Finally outside Operations details section click - Add + Click Add both in the screen and in the return + screen. - - - - - - - - - - - - - - - - - - Using these instructions, Zabbix will call the zabbix_vitrage.py script, made readily available by the Fuel Vitrage Plugin, to pass the arguments described in step 3. The diff --git a/book-enea-nfv-core-installation-guide/doc/images/Zabbix_Action.svg b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_Action.svg new file mode 100644 index 0000000..f67abd9 --- /dev/null +++ b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_Action.svg @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/book-enea-nfv-core-installation-guide/doc/images/Zabbix_ActionOperations.png b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_ActionOperations.png new file mode 100644 index 0000000..d333db9 Binary files /dev/null and b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_ActionOperations.png differ diff --git a/book-enea-nfv-core-installation-guide/doc/images/Zabbix_ActionOperations.svg b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_ActionOperations.svg new file mode 100644 index 0000000..a59c4b7 --- /dev/null +++ b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_ActionOperations.svg @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/book-enea-nfv-core-installation-guide/doc/images/Zabbix_Home.svg b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_Home.svg new file mode 100644 index 0000000..1d7fb1e --- /dev/null +++ b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_Home.svg @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaNotifications.PNG b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaNotifications.PNG new file mode 100644 index 0000000..6cc524f Binary files /dev/null and b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaNotifications.PNG differ diff --git a/book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaNotifications.svg b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaNotifications.svg new file mode 100644 index 0000000..b75d8ea --- /dev/null +++ b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaNotifications.svg @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaType.svg b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaType.svg new file mode 100644 index 0000000..aa73ad7 --- /dev/null +++ b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_MediaType.svg @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/book-enea-nfv-core-installation-guide/doc/images/Zabbix_User.svg b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_User.svg new file mode 100644 index 0000000..3d6b122 --- /dev/null +++ b/book-enea-nfv-core-installation-guide/doc/images/Zabbix_User.svg @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml b/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml index 77d9264..ff2485f 100644 --- a/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml +++ b/book-enea-nfv-core-release-info/doc/known_bugs_and_limitations.xml @@ -284,15 +284,15 @@ - Virtual instances are not affected by removing a node from Ceph - Storage Cluster + Virtual instances are not affected by removing a node from the + Ceph Storage Cluster Description and Impact: - Engineering wanted to validate the survival of the storage - systems when a single disk is removed without causing data loss. + Engineering wanted to validate the survival of storage + systems when a single disk is removed, without causing data loss. Without physical access to the test setup, this test is not feasible. @@ -303,10 +303,9 @@ The chosen approach was to validate what happens to the - Ceph cluster when network connectivity is lost for the Storage - interface of one of the nodes. The observed behavior: no - impact on a running instance using Ceph for volume - storage. + Ceph cluster, when network connectivity is lost for the + Storage interface of one of the nodes. No impact was observed + when a running instance using Ceph for volume storage. -- cgit v1.2.3-54-g00ecf