652ceff526
* nova: instances and services * cinder: volumes and snapshots * glance: images and snapshots * keystone: tenants, users, roles Change-Id: I1bbc97b7d4119100abc149d796f9697d7f35548b |
||
---|---|---|
contrib | ||
deployment_scripts/puppet | ||
doc | ||
repositories | ||
specs | ||
.gitreview | ||
environment_config.yaml | ||
LICENSE | ||
metadata.yaml | ||
pre_build_hook | ||
README.md | ||
tasks.yaml |
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:
-
Download the plugin from the Fuel Plugins Catalog.
-
Copy the plugin file to the Fuel Master node.
scp lma_collector-1.0.0.fp root@<IP address>:
-
Install the plugin using the
fuel
command line:fuel plugins --install lma_collector-1.0.0.fp
-
Verify that the plugin is installed correctly:
fuel plugins --list
User Guide
LMA collector plugin configuration
- Create a new environment with the Fuel UI wizard.
- Click on the Settings tab of the Fuel web UI.
- 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:
-
The LMA collector service is running
# On CentOS /etc/init.d/lma_collector status # On Ubuntu status lma_collector
-
Look for errors in the LMA collector log file (located at
/var/log/lma_collector.log
) on the different nodes. -
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
- Guillaume Thouvenin gthouvenin@mirantis.com
- Simon Pasquier spasquier@mirantis.com
- Swann Croiset scroiset@mirantis.com