Change-Id: I4754f813f057bab97e931805ff8a1eab4c0ab396
6.5 KiB
Logging, Monitoring and Alerting (LMA) Infrastructure Alerting Plugin for Fuel
Overview
The LMA Infrastructure Alerting
plugin is composed of several services
running on a node (base-os role). It provides the alerting functionality for
the OpenStack Infrastructure inside the LMA toolchain.
The LMA toolchain is currently composed of these Fuel plugins:
* [LMA collector Plugin](https://github.com/openstack/fuel-plugin-lma-collector)
* [InfluxDB-Grafana Plugin](https://github.com/openstack/fuel-plugin-influxdb-grafana)
* [Elasticsearch-Kibana Plugin](https://github.com/openstack/fuel-plugin-elasticsearch-kibana)
Requirements
Requirement | Version/Comment |
---|---|
Mirantis OpenStack compatility | 7.0 or higher |
LMA Collector Fuel plugin | 0.8 or higher |
InfluxDB-Grafana Fuel plugin (optional) | 0.8 or higher |
Recommendations
None.
Limitations
Adding and removing node to/from an environment won't reconfigure the Nagios server. This limitation is due to the missing ability of Fuel Plugin Framework to apply plugin tasks (puppet apply) when these operations occur.
Installation Guide
LMA Infrastructure Alerting Plugin install from the RPM file
To install the LMA Infrastructure Alerting Plugin from the RPM file of the plugin, follow these steps:
-
Download the plugin from the Fuel Plugins Catalog.
-
Copy the plugin file to the Fuel Master node. Follow the Quick start guide if you don't have a running Fuel Master node yet.
scp lma_infrastructure_alerting-0.8-0.8.0-0.noarch.rpm root@<the Fuel Master node IP address>:
-
Install the plugin using the
fuel
command line:fuel plugins --install lma_infrastructure_alerting-0.8-0.8.0-0.noarch.rpm
-
Verify that the plugin is installed correctly:
fuel plugins
LMA Infrastructure Alerting Plugin install from source
To install the LMA Infrastructure Alerting Plugin from source, you first need to prepare an environement to build the RPM file of the plugin. The recommended approach is to build the RPM file directly onto the Fuel Master node so that you won't have to copy that file later.
Prepare an environment for building the plugin on the Fuel Master Node
-
- Install the standard Linux development tools:
# yum install createrepo rpm rpm-build dpkg-devel
-
- Install the Fuel Plugin Builder. To do that, you should first get pip:
# easy_install pip
-
- Then install the Fuel Plugin Builder (the
fpb
command line) with `pip:
# pip install fuel-plugin-builder
- Then install the Fuel Plugin Builder (the
Note: You may also have to build the Fuel Plugin Builder if the package version of the
plugin is higher than package version supported by the Fuel Plugin Builder you get from pypi
.
In this case, please refer to the section "Preparing an environment for plugin development"
of the Fuel Plugins wiki if you
need further instructions about how to build the Fuel Plugin Builder.
-
- Clone the LMA Infrastructure Alerting Plugin git repository:
# git clone git@github.com:openstack/fuel-plugin-lma-infrastructure-alerting.git
-
- Check that the plugin is valid:
# fpb --check ./fuel-plugin-lma-infrastructure-alerting
-
- And finally, build the plugin:
# fpb --build ./fuel-plugin-lma-infrastructure-alerting
-
- Now you have created an RPM file that you can install using the steps described above:
# ls ./fuel-plugin-lma-infrastructure-alerting/lma_infrastructure_alerting-0.8-0.8.0-1.noarch.rpm ./fuel-plugin-lma-infrastructure-alerting/lma_infrastructure_alerting-0.8-0.8.0-1.noarch.rpm
User Guide
LMA-Infrastructure-Alerting plugin configuration
-
Create a new environment with the Fuel UI wizard.
-
Click on the Settings tab of the Fuel web UI.
-
Scroll down the page, enable the "LMA Infrastructure Alerting Server plugin" and fill-in the required fields.
- The password to access Nagios web interface.
- The recipient email address
- The sender email address
- The SMTP server IP and port
- Fill-in autentication parameters if enabled.
-
Add one node with the "Infrastructure Alerting" role.
Disks partitioning
The plugin uses:
- 20% of the first disk for the operating system by honoring the range of 15GB minimum and 50GB maximum.
- 20GB for Nagios data and logs (/var/nagios).
- 10GB for /var/log.
It is recommended to review the partitioning done by Fuel before the deployment and adapt it to your requirements.
Testing
Nagios
Once installed, you can check that Nagios is working by pointing your browser to this URL:
http://<HOST>:8001
Where HOST
is the IP address or the name of the node that runs the server.
You should be able to login using the username nagiosadmin and password entered for the configuration of the plugin.
Known issues
None.
Release Notes
0.8.0
- Initial release of the plugin. This is a beta version.
Development
The OpenStack Development Mailing List is the preferred way to communicate,
emails should be sent to openstack-dev@lists.openstack.org
with the subject
prefixed by [fuel][plugins][lma]
.
Reporting Bugs
Bugs should be filled on the Launchpad fuel-plugins project (not GitHub) with the tag lma
.
Contributing
If you would like to contribute to the development of this Fuel plugin you must follow the OpenStack development workflow.
Patch reviews take place on the OpenStack gerrit system.
Contributors
- Swann Croiset scroiset@mirantis.com
- Simon Pasquier spasquier@mirantis.com
- Guillaume Thouvenin gthouvenin@mirantis.com