modoboa / modoboa-stats

Graphical statistics for Modoboa
MIT License
9 stars 12 forks source link
c3js email modoboa rrdtool statistics

modoboa-stats

|travis| |codecov| |landscape|

Graphical statistics for Modoboa.

Installation

Install this extension system-wide or inside a virtual environment by running the following command::

$ pip install modoboa-stats

Since this extension relies on the rrdtool package, you may need to install additional libraries in order to compile it. On a Debian system, you will require the following packages::

$ apt-get install librrd-dev

Edit the settings.py file of your modoboa instance and add modoboa_stats inside the MODOBOA_APPS variable like this::

MODOBOA_APPS = (
  'modoboa',
  'modoboa.core',
  'modoboa.lib',
  'modoboa.admin',
  'modoboa.relaydomains',
  'modoboa.limits',
  'modoboa.parameters',
  # Extensions here
  # ...
  'modoboa_stats',
)

Run the following commands to setup the database tables::

$ cd $ python manage.py collectstatic $ python manage.py load_initial_data

Finally, restart the python process running modoboa (uwsgi, gunicorn, apache, whatever).

Additional documentation is available on ReadTheDocs <http://modoboa-stats.readthedocs.io/en/latest/>_.

.. |landscape| image:: https://landscape.io/github/modoboa/modoboa-stats/master/landscape.svg?style=flat :target: https://landscape.io/github/modoboa/modoboa-stats/master :alt: Code Health

.. |travis| image:: https://travis-ci.org/modoboa/modoboa-stats.svg?branch=master :target: https://travis-ci.org/modoboa/modoboa-stats

.. |codecov| image:: https://codecov.io/gh/modoboa/modoboa-stats/branch/master/graph/badge.svg :target: https://codecov.io/gh/modoboa/modoboa-stats