Monitoring and notification tools for Masakari
Go to file
Sean McGinnis 2171a824bb Increment versioning with pbr instruction
With moving away from required milestone releases, the version numbers
calculated by PBR on the master branch will not work for those testing
upgrades from the last stable release. More details can be found in the
mailing list post here:

    http://lists.openstack.org/pipermail/openstack-dev/2018-October/135706.html

This is an empty commit that will cause PBR to increment its calculated
version to get around this.

PBR will see the following which will cause it to increment the version:

Sem-Ver: feature

Please merge this patch as soon as possible to support those testing
upgrades.

Change-Id: I86165fd2347393e9567217b70937ecc6c70a2754
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
2018-10-12 13:10:51 -05:00
doc/source Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
etc/masakarimonitors Remove an extra word in process_list.yaml.sample 2017-07-31 15:58:59 +09:00
masakarimonitors Pass region_name and interface parameters during connection initialization 2018-08-14 14:41:01 +09:00
releasenotes Update reno for stable/rocky 2018-08-10 16:42:04 +00:00
.coveragerc Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
.gitignore Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
.gitreview Added .gitreview 2016-10-17 07:59:04 +00:00
.mailmap Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
.testr.conf Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
.zuul.yaml import zuul job settings from project-config 2018-08-17 19:20:37 +09:00
CONTRIBUTING.rst Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
HACKING.rst Remove log translations 2017-06-19 16:55:00 +09: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 Fix syntax errors of README.rst 2017-03-03 14:52:09 +09:00
babel.cfg Initial Cookiecutter Commit. 2016-11-01 13:46:13 +09:00
lower-constraints.txt Remove python-openstackclient from global-requirements 2018-08-08 08:41:36 +00:00
requirements.txt Remove python-openstackclient from global-requirements 2018-08-08 08:41:36 +00:00
setup.cfg Introspective Instance Monitoring through QEMU Guest Agent 2018-07-12 14:02:34 +00:00
setup.py Updated from global requirements 2017-08-11 11:52:33 +00:00
test-requirements.txt Updated from global requirements 2018-03-26 08:08:05 +00:00
tox.ini Merge "fix tox python3 overrides" 2018-08-17 03:34:34 +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

If you are intend to use bash scripts of masakari-processmonitor and masakari-hostmonitor, use following steps to install them. However, those bash shell scripts are deprecated as of the Ocata release and will be removed in the Queens release. Use above masakari-hostmonitors implemented in python instead.

  1. Clone masakari using:

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

  3. Remove '.sample' from files hostmonitor.conf.sample, processmonitor.conf.sample and proc.list.sample which exist at masakari-monitors/etc/.

  4. Copy hostmonitor.conf, processmonitor.conf and proc.list files from masakari-monitors/etc/ to /etc/masakarimonitors folder and make necessary changes to the hostmonitor.conf, processmonitor.conf and proc.list files.

  5. To run bash scripts of masakari-processmonitor and masakari-hostmonitor simply use following binary:

    $ masakari-processmonitor.sh /etc/masakarimonitors/processmonitor.conf /etc/masakarimonitors/proc.list
    $ masakari-hostmonitor.sh /etc/masakarimonitors/hostmonitor.conf

Features

  • TODO