Metadata-Version: 1.1
Name: python-watcher_metering_drivers
Version: 0.20.1.0b0
Summary: Drivers for the Watcher Metering agent
Home-page: http://www.openstack.org/
Author: OpenStack
Author-email: openstack-dev@lists.openstack.org
License: UNKNOWN
Description: ========================
        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)
        
        
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
