Skip to content
Monitoring and notification tools for Masakari
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc Switch from oslosphinx to openstackdocstheme Apr 10, 2019
etc/masakarimonitors
masakarimonitors
releasenotes
.coveragerc
.gitignore
.gitreview
.mailmap
.testr.conf
.zuul.yaml
CONTRIBUTING.rst
HACKING.rst
LICENSE
MANIFEST.in Initial Cookiecutter Commit. Nov 1, 2016
README.rst
babel.cfg
lower-constraints.txt
requirements.txt
setup.cfg
setup.py
test-requirements.txt
tox.ini Dropping the py35 testing Apr 14, 2019

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
You can’t perform that action at this time.