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
37 Commits 1 Branch 25 Tags 6.4 MiB
Go to file
Simon Pasquier 5700f02289 Add documentation placeholder 
Change-Id: I1b324fe92805cc8e054a81709001114fda7b53da
 		2015-09-18 17:48:56 +02:00
deployment_scripts/puppet Merge "Locate InfluxDB and Elasticsearch nodes by role" 2015-09-14 06:47:50 +00: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
LICENSE Bootstrap the plugin structure 2015-07-09 17:02:54 +02:00
README.md Dedicate a Logical Volume for Nagios 2015-09-11 15:55:34 +02:00
deployment_tasks.yaml Add tools task 2015-09-08 11:23:45 +02:00
environment_config.yaml Define new role infrastructure_alerting 2015-09-08 11:23:41 +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
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 Add documentation placeholder 2015-09-18 17:48:56 +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. 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.

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