<commit_before>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](https://software.mirantis.com/download-mirantis-openstack-fuel-plug-ins/).

2. Copy the plugin file to the Fuel Master node. Follow the [Quick start
   guide](https://software.mirantis.com/quick-start/) 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](https://wiki.openstack.org/wiki/Fuel/Plugins)
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<commit_msg>Fix wrong reference and wrong version<commit_after>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](https://software.mirantis.com/download-mirantis-openstack-fuel-plug-ins/).

2. Copy the plugin file to the Fuel Master node. Follow the [Quick start
   guide](https://software.mirantis.com/quick-start/) 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](https://wiki.openstack.org/wiki/Fuel/Plugins)
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
{'fraction_non_alphanumeric': 0.15858026701400196, 'fraction_numerical': 0.010094431781178768, 'mean_word_length': 2.8904369854338188, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 12, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 6, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4341817', 'n_tokens_mistral': 1749, 'n_tokens_neox': 1616, 'n_words': 642}