x
/
fuel-plugin-zabbix-monitoring-emc
Code Issues Proposed changes
fuel-plugin-zabbix-monitori.../doc/content/guide.rst

4.2 KiB
Raw Blame History

User Guide

Environment configuration

  1. Create an environment. For more information about environment creation, see Mirantis OpenStack User Guide <http://docs.mirantis.com/openstack/fuel /fuel-6.1/user-guide.html#create-a-new-openstack-environment>.

  2. Enable and configure Zabbix plugin for Fuel. For instructions, see Zabbix Plugin Guide in the Fuel Plugins Catalog <https://www.mirantis.com /products/openstack-drivers-and-plugins/fuel-plugins/>.

  3. Enable and configure SNMP trap daemon for Zabbix plugin. For instructions, see Zabbix Plugin Guide in the Fuel Plugins Catalog <https://www.mirantis .com/products/openstack-drivers-and-plugins/fuel-plugins/>.

  4. Open Settings tab of the Fuel web UI and scroll the page down. Select the plugin checkbox and optionally fill in EMC hardware to monitor parameter:

    image

    When you add your hardware to the EMC hardware to monitor comma separated list, then the plugin will automatically configure monitoring for these hardware in Zabbix by doing following actions:

    • create a Host with provided Name and IP address
    • link the EMC monitoring template to the Host

    If you leave the parameter empty, you will have to add your hardware to Zabbix manually.

  5. Adjust other environment settings to your requirements and deploy the environment. For more information, see Mirantis OpenStack User Guide <http://docs.mirantis.com/openstack/fuel /fuel-6.1/user-guide.html#create-a-new-openstack-environment>.

User Guide

To test if everything is configured properly, follow these steps:

  1. Generate an example SNMP trap by running the following command from any node:

    [root@node-46 ~]# snmptrap -v 1 -c <SNMP_community> <management_VIP_address> '.1.3.6.1.4.1.1981' <host_ip_address> 6 6 '10' .1.3.6.1.4.1.1981 s "null" .1.3.6.1.4.1.1981 s "null" .1.3.6.1.4.1.1981 s "a37"

    where:

    <SNMP_ community>

    It is set in the SNMP trap daemon for Zabbix plugin Settings in Fuel UI:

    image

    <management_VIP_address>

    If you don’t know the address, run the following command on any node:

    [root@node-46 ~]# grep management_vip /etc/astute.yaml

    You should get the required VIP in the output:

    management_vip: 192.168.0.1

    <host_IP_address>

    IP address of EMC hardware filled in EMC hardware to monitor parameter

  2. After several seconds of running the snmptrap command you should see a new event in the Last 20 issues section of the Zabbix Dashboard (for information on how to login to Zabbix Web Interface see Zabbix Plugin Guide in the Fuel Plugins Catalog <https://www.mirantis.com/products/ openstack-drivers-and-plugins/fuel-plugins/>):

    image

    When you click on a date in the Last change column of one of the issues, you will see the Events page with list of events with the same type:

    image

    To see a full description of the event, you have to click on event’s description and choose History, then you will see a History page with a full event description:

    image

  3. After clicking Configuration tab and selecting Hosts option, you will see a list of hosts with linked monitoring templates. There should be one host for every hardware listed in the EMC hardware to monitor plugin parameter:

    image

Hardware setup

You have to configure your hardware to enable SNMP traps sending. To do this, refer to your hardware’s manual. Generally, you have to set these two parameters on your hardware:

  1. SNMP manager - set to management VIP address of your environment

    If you don’t know the address, run the following command on any node:

    [root@node-46 ~]# grep management_vip /etc/astute.yaml

    You should get the required VIP in the output:

    management_vip: 192.168.0.1

  2. SNMP community - set the same value as in the SNMP community parameter from the SNMP trap daemon for Zabbix plugin settings:

    image