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
2 Commits 1 Branch 25 Tags 6.4 MiB
Go to file
Swann Croiset ca1dd3bd3f Bootstrap the plugin structure 
implements blueprint lma-infra-alerting-plugin

Change-Id: I8b13a3c7d296dfbb91f6834604d91c6361eb7a77
 		2015-07-09 17:02:54 +02:00
deployment_scripts/puppet/modules Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
repositories Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
.gitignore Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
.gitreview Added .gitreview 2015-06-29 10:01:23 +00:00
LICENSE Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
README.md Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
environment_config.yaml Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
metadata.yaml Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
pre_build_hook Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
tasks.yaml Bootstrap the plugin structure 2015-07-09 17:02:54 +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 [1]_.

.. [1] 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.7 or higher
InfluxDB-Grafana Fuel plugin (optional) 0.7 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.7-0.7.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.7-0.7.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. Add a node with the "Operating System" role.
  3. Before applying changes or once changes applied, edit the name of the node by clicking on "Untitled (xx:yy)" and modify it for "alerting".
  4. Click on the Settings tab of the Fuel web UI.
  5. Scroll down the page, select the "LMA Infrastructure Alerting Server plugin" checkbox and fill-in the required fields.
    • The name of the node where the plugin is deployed.
    • The username and password to access Nagios web interface.

Testing

Nagios

Once installed, you can check that Nagios is working by pointing your browser to this URL:

http://<HOST>/nagios3/

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