drove is a modern monitoring tool which support alerting (with escalation), auto-register nodes, statistics gathering and much more... in a few lines of python code. https://docs.drove.io

Andrés J. Díaz 83cde1ae68 Bump version 0.3 2 years ago
doc e27848352c Upgrade documentation style 2 years ago
drove 83cde1ae68 Bump version 0.3 2 years ago
.gitignore 780ba02f8c initial import 3 years ago
.travis.yml 0a43a02a0f Add pypy3 as check in travis 3 years ago
LICENSE 780ba02f8c initial import 3 years ago
MANIFEST.in 5d60d980cc Big refactor 3 years ago
README.rst 813c7bc339 Add logo in README 3 years ago
setup.py bb24ba1ebb Fix python setup.py test behaviour 3 years ago

README.rst

|drovelogo| drove
==================

.. |drovelogo| image:: https://avatars0.githubusercontent.com/u/9040325?v=2&s=24

.. image:: https://img.shields.io/pypi/v/drove.svg?style=flat
:target: https://pypi.python.org/pypi/drove
:alt: Latest PyPI version:

.. image:: https://img.shields.io/travis/droveio/drove.svg?style=flat
:target: https://travis-ci.org/droveio/drove
:alt: Build Status

.. image:: https://img.shields.io/coveralls/droveio/drove.svg?style=flat
:target: https://coveralls.io/r/droveio/drove?branch=master
:alt: Coverage

.. image:: http://img.shields.io/pypi/l/drove.svg?style=flat
:target: http://www.gnu.org/licenses/gpl-3.0.txt
:alt: License GPLv3


**drove** is a modern monitoring tool which support alerting
(with escalation), auto-register nodes, statistics gathering
and much more in a few lines of python code.

Installation
------------

The stable releases of drove will be uploaded to
`PyPi `_, so you can install
and upgrade versions using `pip `_::

pip install drove

You can use unstable versions at your risk using pip as well::

pip install -e git://github.com/droveio/drove

By the way: **drove** works better with python3, but 2.7 is also
supported.

Usage
-----

You need to configure **drove** to enable the features that you
like to use. In fact **drove** act as a producer-consumer daemon,
which means that there are read *plugins* and write
*plugins*.

- A **reader** read a metric or an event from somewhere and
report it to **drove** (in a internal cache).

- A **consumer** write a metric (taken from the internal cache)
in somewhere.

Some *plugins* can act as reader and writer at the same time.

By default **drove** start with a very basic readers configured.

To start the daemon just type::

drove -c myconfig.conf daemon

You can avoid to daemonize with ``--no-daemon`` option in the
command line.

Development
-----------

**drove** is under heavy development. If you want to contribute,
please us the usual github worflow:

1. Clone the repo
2. Hack!
3. Make a pull-request
4. Merged!

If you don't have programming skills, just open a
`issue `_ in the
Github project.