python-watcher_metering_drivers 0.20.0

Drivers for the Watcher Metering agent

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)