Metering library for Watcher
Project description
Introduction
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 project is part of the Watcher project.
For more information on Watcher, you can also refer to its OpenStack wiki page.
Getting started
Installing Requirements Linux Ubuntu
Linux Debian Procedure should work on Ubuntu and similar distributions:
You need to install the following packages:
$ sudo apt-get update
$ sudo apt-get install build-essential python-dev autoconf libtool unzip wget
Moreover, this package uses nanomsg and nanoconfig as socket library. As no official Debian nor RedHat package has been released yet, these two have to be compiled from the sources.
Installing nanomsg
$ wget https://github.com/nanomsg/nanomsg/archive/0.6-beta.zip
$ unzip 0.6-beta.zip
$ cd nanomsg-0.6-beta
$ ./autogen.sh
$ ./configure
$ make -j8
$ sudo make install
$ sudo ldconfig /usr/local/lib
Please also refer the instructions available on their README files.
Installing nanoconfig
$ wget https://github.com/nanomsg/nanoconfig/archive/master.zip
$ unzip master.zip
$ cd nanomsg-master
$ cmake .
$ make
$ sudo make install
$ sudo ldconfig /usr/local/lib
Please also refer the instructions available on their README files.
Configuration
Agent
The Agent configuration file sample, which is located at $(PROJECT_DIR)/etc/watcher-metering/agent.conf (where PROJECT_DIR is the root folder of this project) contains all the explanations for each of its field. Please refer to these notes to fully understand the role of each one of them.
To run the agent you can use the following command:
$ watcher-metering-agent --config-file=/etc/watcher-metering/agent.conf
Or even:
$ watcher-metering-agent --config-dir=/etc/watcher-metering
This alternative will automatically take into account any other file containing some configuration related to the agent (useful for dynamically including third-party driver configuration).
But if you want to learn more about all the options this command provides you can still use the following to access its documentation:
$ watcher-metering-agent --help
Publisher
The Publisher configuration file (located at /etc/watcher-metering/publisher.conf) contains all the explanations for each of its field. Please refer to these notes to fully understand the role of each one of them.
To run the publisher you can use the following command:
$ watcher-metering-publisher \
--config-file=/etc/watcher-metering/publisher.conf
Or even:
$ watcher-metering-publisher --config-dir=/etc/watcher-metering
This alternative will automatically take into account any other file containing some configuration related to the publisher (useful for dynamically including third-party driver configuration).
But if you want to learn more about all the options this command provides you can still use the following to access its documentation:
$ watcher-metering-publisher --help
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for python-watcher_metering-0.19.7.0b0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6b315193aed8d39f13bf257fad5e03abc639731930b191a3f27d648f0e6395bd |
|
MD5 | b825110452923fb1ecf94c05dd66cf82 |
|
BLAKE2b-256 | bcf638a7f950395e62086b22c44a316fa6f285e6288e305a6ee9b71a220791fe |
Hashes for python_watcher_metering-0.19.7.0b0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ec117bb548b3103b95bc72e4f427577ed1ac77ca586556d615b4d7f2a55a3b98 |
|
MD5 | 5dc8996b1f35041a4f18a3ec2407be95 |
|
BLAKE2b-256 | 4f6fa9618cf3b44f2bb8c3b1f2b11583b77c173316c4af0d355e7a991cef5e9a |