Metadata-Version: 2.0
Name: python-watcher-metering-drivers
Version: 0.19.0
Summary: Drivers for the Watcher Metering agent
Home-page: http://www.openstack.org/
Author: OpenStack
Author-email: openstack-dev@lists.openstack.org
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: pbr
Requires-Dist: oslo.config
Requires-Dist: oslo.i18n
Requires-Dist: oslo.log
Requires-Dist: requests
Requires-Dist: Cython
Requires-Dist: psutil
Requires-Dist: enum34
Requires-Dist: pysnmp

========================
Watcher Metering Drivers
========================

Introduction
============

Watcher Metering Drivers provides a set of metric-pulling drivers extending the
python-watcher_metering_ package.

Watcher Metering collects system metrics and publishes them to a store.
To do so, it is composed of two elements:

- The ``Agent`` who collects the desired metrics and sends it to a publisher.
  The ``Agent`` is meant to run on each monitored host (container, VM, ...)
- The ``Publisher`` who gathers measurements from one or more agent and pushes
  them to the desired store. The currently supported stores are Riemann
  (for CEP) and Ceilometer.

This package is part of the Watcher_ project.

For more information on Watcher_, you can also refer to its OpenStack wiki_
page.

.. _python-watcher_metering: https://pypi.python.org/pypi/python-watcher_metering
.. _Watcher: http://factory.b-com.com/www/watcher/watcher/doc/build/html/
.. _wiki: https://wiki.openstack.org/wiki/Watcher


Getting started
===============

System requirements
-------------------

As this package extends python-watcher_metering_, please make sure you
installed its system dependencies before continuing.

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

To install this package, just use *pip*:

.. code-block:: shell

    $ pip install python-watcher_metering_drivers


Activate a driver
-----------------

Within the your watcher metering configuration file, add the name of the driver
entry point you wish to enable.

As an example, if you wish to acticate both the ``cpu_user`` and the
``disk_free`` drivers, just edit the aforementioned configuration file like
this:

.. code-block:: ini

     [agent]
     driver_names =  cpu_user,disk_free
     # ...


Running the application
-----------------------

To run our Watcher Metering agent, you can use the following command


Driver configuration
====================

To configure a driver, you can specify it in a separate configuration file.
Please refer to the comments left within the ``$(ROOT_DIR)/etc/watcher-metering``\
``/watcher-metering-drivers.conf`` sample to get more details on the
configuration options.

Then, to run the agent using our driver configuration, you can use the
following command:

.. code-block:: shell

    $ watcher-metering-agent \
        --config-file=$(WATCHER_METERING_AGENT_CONFIG_FILE)
        --config-file=$(WATCHER_METERING_DRIVERS_CONFIG_FILE)



