Metadata-Version: 2.1
Name: amqpeek
Version: 0.0.6
Summary: RMQ CLI Monitor
Home-page: https://github.com/steveYeah/AmqPeek
Author: Steve Hutchins
Author-email: hutchinsteve@gmail.com
License: MIT
Download-URL: https://github.com/steveYeah/amqpeek/archive/v0.0.6.tar.gz
Keywords: amqp,monitor,rabbitmq,rabbit,notifier,notifications
Platform: UNKNOWN
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: click (>=6.6)
Requires-Dist: PyYAML (>=5.1)
Requires-Dist: pika (<2.0.0)
Requires-Dist: slacker (>=0.9.24)
Provides-Extra: dev
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: pep8 ; extra == 'dev'
Requires-Dist: mock (==2.0.0) ; extra == 'dev'

.. image:: https://img.shields.io/travis/steveYeah/amqpeek.svg?branch=master
   :target: https://travis-ci.org/steveYeah/amqpeek


AMQPeek
=======

.. pull-quote::

    A flexible RMQ monitor that keeps track of RMQ, notifying you over multiple channels when
    connections cannot be made, queues have not been declared, and when queue
    lengths increase beyond specified limits.

Install
-------
.. code-block:: shell

    $ pip install amqpeek

Once installed, you can then setup AMQPeek to suit your needs by editing the configuration file

Create configuration file
-------------------------
To create a base configuration file:

.. code-block:: shell

    $ amqpeek --gen_config

This will create a file called ``amqpeek.yaml`` in your current directory. Here you
can setup your connection details for RMQ, define queues you wish to monitor
and define the notifier channels you wish to use. Edit this file to suit your
needs

Running
-------
listing all options:

.. code-block:: shell

    $ amqpeek --help

Run AMQPeek with no arguments:
This runs the monitoring script once and then exits out (useful when running AMQPeek as a Cron job)

.. code-block:: shell

    $ amqpeek

Run AMQPeek with an interval:
This monitors RMQ, running the tests every 10 minutes in a
continuous loop (useful when running AMQPeek under Supervisor or something similar)

.. code-block:: shell

    $ amqpeek --interval 10

You can also specify the location of a configuration file to use instead of the default
location of your current directory

.. code-block:: shell

    $ amqpeek --config config.yaml


Notification channels
---------------------
AMQPeek supports multiple notification channels.

Currently supported channels:

* Slack
* Email (SMTP)

These are controlled via the configuration file, under notifiers. You can mix and match
the notifiers you wish to use, and you can have multiples of the same notifier types.


