x
/
fuel-plugin-lma-collector
Code Issues Proposed changes
RETIRED, Fuel plugin to collect Logging Monitoring and Alerting metrics
4 Commits 1 Branch 32 Tags 39 MiB
Go to file
Simon Pasquier c9ee4d30d9 Initial import of the LMA collector plugin 
This is an import of the initial LMA PoC code. For now, it only covers
the collection of logs (notifications will be added in a subsequent
commit).

There's been a bit of rewrite to:
- decouple the Heka configuration from the LMA collector.
- run the Heka service as non-root when possible (Ubuntu only for now
  due to file permission issues on CentOS [1]).
- adapt to version 0.9 of Heka.

[1] https://bugs.launchpad.net/fuel/+bug/1425954

Change-Id: I4472b49a25e18e06984b5b29bdce18f917137bc8
 		2015-02-27 14:16:49 +01:00
deployment_scripts/puppet Initial import of the LMA collector plugin 2015-02-27 14:16:49 +01: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 Initial import of the LMA collector plugin 2015-02-27 14:16:49 +01:00
README.md Add README file 2015-02-26 09:57:26 +01:00
environment_config.yaml Initial import of the LMA collector plugin 2015-02-27 14:16:49 +01:00
metadata.yaml Initial import of the LMA collector plugin 2015-02-27 14:16:49 +01:00
pre_build_hook Initial import of the LMA collector plugin 2015-02-27 14:16:49 +01:00
tasks.yaml Initial import of the LMA collector plugin 2015-02-27 14:16:49 +01:00

README.md

Logging, Monitoring and Alerting collector Plugin for Fuel

Overview

The Logging, Monitoring & Alerting (LMA) collector is a service running on each OpenStack node that collects logs and notifications. This data is 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 environments using Neutron.

Installation Guide

ElasticSearch configuration

To install and configure ElasticSearch, you can refer to the ElasticSearch/Kibana plugin for Fuel.

You can also install the ElasticSearch server outside of Fuel as long as it meets the plugin's requirements.

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-1.0.0.fp root@<IP address>:
  1. Install the plugin using the fuel command line:
fuel plugins --install lma_collector-1.0.0.fp
  1. Verify that the plugin is installed correctly:
fuel plugins --list

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
  1. Look for errors in the LMA collector log file (located at /var/log/lma_collector.log) on the different nodes.
  2. Nodes are able to connect to the ElasticSearch server on port 9200.

Known issues

None

Release Notes

6.1.0

  • Initial release of the plugin.

Contributors