Monitoring and notification tools for Masakari
Go to file
Ghanshyam Mann fe5247c228 [community goal] Update contributor documentation
This patch updates/adds the contributor documentation to follow
the guidelines of the Ussuri cycle community goal[1].

[1] https://governance.openstack.org/tc/goals/selected/ussuri/project-ptl-and-contrib-docs.html

Story: #2007236
Task: #38536
Change-Id: Ib2e9cd7b736a7488ebad350aa2eb95311fd99f5c
2021-05-31 20:34:00 +00:00
doc [community goal] Update contributor documentation 2021-05-31 20:34:00 +00:00
etc/masakarimonitors Drop unused samples 2021-03-13 20:12:17 +00:00
masakarimonitors Merge "Replaces yaml.load() with yaml.safe_load()" 2021-04-27 01:01:58 +00:00
releasenotes Fix one reno 2021-03-27 18:32:10 +00:00
.coveragerc Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
.gitignore Add .stestr/ to .gitignore 2020-08-30 17:04:52 +02:00
.gitreview OpenDev Migration Patch 2019-04-19 19:49:18 +00:00
.mailmap Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
.stestr.conf Switch to using stestr 2019-06-19 03:54:45 +00:00
.zuul.yaml Add Python3 xena unit tests 2021-03-26 15:55:33 +00:00
CONTRIBUTING.rst [community goal] Update contributor documentation 2021-05-31 20:34:00 +00:00
HACKING.rst Removed unnecessary parantheses in yield statements 2018-12-10 06:16:18 +00:00
LICENSE Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
MANIFEST.in Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
README.rst Update and replace http with https for doc links 2020-04-02 00:28:48 +00:00
bindep.txt [goal] Migrate testing to ubuntu focal 2020-08-04 16:25:39 +00:00
requirements.txt [goal] Migrate testing to ubuntu focal 2020-09-12 08:53:52 +00:00
setup.cfg setup.cfg: Replace dashes with underscores 2021-04-28 10:54:57 +08:00
setup.py Cleanup py27 support 2020-04-17 21:48:40 +02:00
test-requirements.txt Merge "Switch to newer openstackdocstheme and reno versions" 2020-08-29 08:52:45 +00:00
tox.ini Merge "Update TOX_CONSTRAINTS_FILE" 2020-12-22 17:32:03 +00:00

README.rst

masakari-monitors

Monitors for Masakari

Monitors for Masakari provides Virtual Machine High Availability (VMHA) service for OpenStack clouds by automatically detecting the failure events such as VM process down, provisioning process down, and nova-compute host failure. If it detect the events, it sends notifications to the masakari-api.

Original version of Masakari: https://github.com/ntt-sic/masakari

Tokyo Summit Session: https://www.youtube.com/watch?v=BmjNKceW_9A

Monitors for Masakari is distributed under the terms of the Apache License, Version 2.0. The full terms and conditions of this license are detailed in the LICENSE file.

Configure masakari-monitors

  1. Clone masakari using:

    $ git clone https://github.com/openstack/masakari-monitors.git
  2. Create masakarimonitors directory in /etc/.

  3. Run setup.py from masakari-monitors:

    $ sudo python setup.py install
  4. Copy masakarimonitors.conf and process_list.yaml files from masakari-monitors/etc/ to /etc/masakarimonitors folder and make necessary changes to the masakarimonitors.conf and process_list.yaml files. To generate the sample masakarimonitors.conf file, run the following command from the top level of the masakari-monitors directory:

    $ tox -egenconfig
  5. To run masakari-processmonitor, masakari-hostmonitor and masakari-instancemonitor simply use following binary:

    $ masakari-processmonitor
    $ masakari-hostmonitor
    $ masakari-instancemonitor

Features

  • TODO