x/fuel-plugin-lma-infrastructure-alerting
Code Issues Proposed changes
RETIRED, The LMA Infrastructure Alerting plugin installs necessary tools to provide the alerting functionality of the LMA toolchain
44 Commits 1 Branch 25 Tags 6.4 MiB
dfcba73681
Go to file
Swann Croiset dfcba73681 Update tox environments 
- add build_plugin env
- fix the bundler working directory

Change-Id: Id586c0e0fb66319693e50eca3f9a2025623ae835
2015-09-23 11:31:11 +02:00
deployment_scripts/puppet Update tox environments 2015-09-23 11:31:11 +02:00
doc Add documentation placeholder 2015-09-18 17:48:56 +02:00
repositories Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
specs Initial spec for the plugin 2015-07-09 16:59:23 +02:00
.gitignore Update tests 2015-09-10 11:58:42 +02:00
.gitreview Added .gitreview 2015-06-29 10:01:23 +00:00
build_plugin-requirements.txt Update tox environments 2015-09-23 11:31:11 +02:00
deployment_tasks.yaml Add tools task 2015-09-08 11:23:45 +02:00
docs-requirements.txt Update tox environments 2015-09-23 11:31:11 +02:00
environment_config.yaml Define new role infrastructure_alerting 2015-09-08 11:23:41 +02:00
LICENSE Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
metadata.yaml Use plugin version 3 2015-09-04 12:11:26 +02:00
node_roles.yaml Define new role infrastructure_alerting 2015-09-08 11:23:41 +02:00
pre_build_hook Add support for CentOS 6.5 2015-08-27 09:34:05 +02:00
README.md Update README with custom role informations 2015-09-21 15:25:27 +02:00
tasks.yaml Define new role infrastructure_alerting 2015-09-08 11:23:41 +02:00
test-requirements.txt Add documentation placeholder 2015-09-18 17:48:56 +02:00
tox.ini Update tox environments 2015-09-23 11:31:11 +02:00
volumes.yaml Dedicate a Logical Volume for Nagios 2015-09-11 15:55:34 +02:00

README.md

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/stackforge/fuel-plugin-lma-collector)
    * [InfluxDB-Grafana Plugin](https://github.com/stackforge/fuel-plugin-influxdb-grafana)
    * [Elasticsearch-Kibana Plugin](https://github.com/stackforge/fuel-plugin-elasticsearch-kibana)

Requirements

Requirement Version/Comment
Mirantis OpenStack compatility 6.1 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

To install the LMA Infrastructure Alerting plugin, follow these steps:

  1. Download the plugin from the Fuel Plugins Catalog.

  2. 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>:

  3. Install the plugin using the fuel command line:

    fuel plugins --install lma_infrastructure_alerting-0.8-0.8.0-0.noarch.rpm

  4. Verify that the plugin is installed correctly:

    fuel plugins

Please refer to the Fuel Plugins wiki if you want to build the plugin by yourself, version 2.0.0 (or higher) of the Fuel Plugin Builder is required.

User Guide

LMA-Infrastructure-Alerting plugin configuration

  1. Create a new environment with the Fuel UI wizard.

  2. Click on the Settings tab of the Fuel web UI.

  3. 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.

  4. 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