python-watcher_metering_drivers 0.21.0

Description:

pythonwatcher metering drivers 0.21.0

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.


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:
$ 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:
[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:
$ watcher-metering-agent \
--config-file=$(WATCHER_METERING_AGENT_CONFIG_FILE)
--config-file=$(WATCHER_METERING_DRIVERS_CONFIG_FILE)