Skip to content

Latest commit

 

History

History
67 lines (52 loc) · 3.18 KB

README.magui.md

File metadata and controls

67 lines (52 loc) · 3.18 KB
Raw

Introduction

Magui is a wrapper that calls functions from the Python library of Citellus README.md.

Some problems are not detected only one one node, but are made by the aggregation of data across them, for example:

  • ntp sync
  • galera replication status
  • etc

Magui aims to use Citellus for gathering the data and later, write plugins to analyze that information.

Usage help

We are developing framework in python, and still no plugins created.

usage: magui.py [arguments] [-h] [-d {INFO,DEBUG,WARNING,ERROR,CRITICAL}]
                            [-p PLUGINPATH] [-m MPATH] [-q] [-i SUBSTRING]
                            [-x SUBSTRING] [-mf MFILTER]
                            [sosreports [sosreports ...]]

Processes several generic archives/sosreports scripts in a uniform way, to
interpret status that depend on several systems data

positional arguments:
  sosreports

optional arguments:
  -h, --help            show this help message and exit
  -d {INFO,DEBUG,WARNING,ERROR,CRITICAL}, --loglevel {INFO,DEBUG,WARNING,ERROR,CRITICAL}
                        Set log level
  -p PLUGINPATH, --pluginpath PLUGINPATH
                        Set path for Citellus plugin location if not default
  -m MPATH, --mpath MPATH
                        Set path for Magui plugin location if not default

Filtering options:
  -q, --quiet           Enable quiet mode
  -i SUBSTRING, --include SUBSTRING
                        Only include plugins that contain substring
  -x SUBSTRING, --exclude SUBSTRING
                        Exclude plugins that contain substring
  -mf MFILTER, --mfilter MFILTER
                        Only include Magui plugins that contains in full path
                        that substring

Running a check

This is an example of execution of Magui against a set of sosreports with seqno plugin of Citellus enabled.

#magui.py * -i seqno # (filtering for ‘seqno’ plugins.
{'/home/remote/piranzo/citellus/citellus/plugins/openstack/mysql/seqno.sh': {'ctrl0.localdomain': {'err': '08a94e67-bae0-11e6-8239-9a6188749d23:36117633\n',
                                                                                                   'out': '',
                                                                                                   'rc': 0},
                                                                             'ctrl1.localdomain': {'err': '08a94e67-bae0-11e6-8239-9a6188749d23:36117633\n',
                                                                                                   'out': '',
                                                                                                   'rc': 0},
                                                                             'ctrl2.localdomain': {'err': '08a94e67-bae0-11e6-8239-9a6188749d23:36117633\n',
                                                                                                   'out': '',
                                                                                                   'rc': 0}}}

On this example, UUID and SEQNO is shown for each controller.

Please if you have any idea on any improvements please do not hesitate to open an issue or submit your contributions.