x
/
fuel-plugin-lma-collector
Code Issues Proposed changes
RETIRED, Fuel plugin to collect Logging Monitoring and Alerting metrics
98 Commits 1 Branch 32 Tags 39 MiB
Go to file
Simon Pasquier 3d71e776b4 Add Apache license headers to Puppet manifests 
This change fixes the text of the LICENSE file too.

Change-Id: Iaebc5a8fc174b4bfe12fa0fb917c6de79ebba334
 		2015-04-20 15:21:17 +02:00
contrib Add contrib/ directory 2015-02-26 15:53:21 +01:00
deployment_scripts/puppet Add Apache license headers to Puppet manifests 2015-04-20 15:21:17 +02:00
doc Merge "Changed the title of the document to reflect the fact this document is not only about the Collector but the LMA toolchain as a whole. Improved significantly the wording of the introduction." 2015-04-16 12:54:57 +00:00
repositories Initial import of the LMA collector plugin 2015-02-27 14:16:49 +01:00
specs Add blueprint for the LMA collector Fuel plugin 2015-02-13 14:54:23 +01:00
.gitreview Added .gitreview 2015-02-12 08:27:40 +00:00
LICENSE Add Apache license headers to Puppet manifests 2015-04-20 15:21:17 +02:00
README.md Modify the plugin's version to 0.7.0 2015-04-07 11:37:16 +02:00
environment_config.yaml Changed the title of the document to reflect the fact this document is not only about the Collector but the LMA toolchain as a whole. 2015-04-15 12:24:01 +02:00
metadata.yaml Modify the plugin's version to 0.7.0 2015-04-07 11:37:16 +02:00
pre_build_hook Add Nova service state metrics 2015-04-14 14:33:54 +02:00
tasks.yaml Ceph metrics 2015-03-31 12:31:52 +02:00

README.md

Logging, Monitoring and Alerting (LMA) Collector Plugin for Fuel

Overview

The Logging, Monitoring & Alerting (LMA) collector is a service running on each OpenStack node that collects logs and notifications. Those data are sent to an ElasticSearch server for diagnostic, troubleshooting and alerting purposes.

Requirements

Requirement Version/Comment
Mirantis OpenStack compatility 6.1 or higher
A running ElasticSearch server 1.4 or higher, the RESTful API must be enabled over port 9200

Limitations

The plugin is only compatible with OpenStack environments deployed with Neutron for networking.

Installation Guide

Prior to installing the LMA Collector Plugin, you may want to install ElasticSearch and Kibana. To install ElasticSearch and Kibana automatically using Fuel, you can refer to the ElasticSearch-Kibana Fuel Plugin .

You can install ElasticSearch and Kibana outside of Fuel as long as your installation meets the LMA Collector plugin's requirements defined above.

LMA collector plugin installation

To install the LMA Collector plugin, follow these steps:

  1. Download the plugin from the Fuel Plugins Catalog.

  2. Copy the plugin file to the Fuel Master node.

    scp lma_collector-0.7-0.7.0-0.noarch.rpm root@<Fuel Master node IP address>:

  3. Install the plugin using the fuel command line:

    fuel plugins --install lma_collector-0.7-0.7.0-0.noarch.rpm

  4. Verify that the plugin is installed correctly:

    fuel plugins --list

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 collector 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, select the LMA collector plugin checkbox and fill-in the required fields.

Exploring the data

Refer to the ElasticSearch/Kibana plugin for exploring and visualizing the collected data.

Troubleshooting

If you see no data in the ElasticSearch server, check the following:

  1. The LMA collector service is running

    # On CentOS
/etc/init.d/lma_collector status
# On Ubuntu
status lma_collector

  2. Look for errors in the LMA collector log file (located at /var/log/lma_collector.log) on the different nodes.

  3. Nodes are able to connect to the ElasticSearch server on port 9200.

Known issues

None

Release Notes

0.7.0

  • Initial release of the plugin. This is a beta version.

Contributors