Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A Python agent for collecting metrics and store them into an InfluxDB.

What is tourbillon

tourbillon is an efficient, very simple and extensible agent that allows to collect metrics from servers or services and writes them into a InfluxDB.

It's is written in pure python.

Supported platforms

tourbillon has been tested and it runs on Ubuntu 12.04 or greater, Centos 6 or greater and Mac OSX Maveriks or greater.

tourbillon works under python 2.7 and python 3.4 or greater.


You can browse the tourbillon documentation online, it is hosted on Read The Docs. The documentation of the latest version of tourbillon can be found here.

Getting started


There are no special requirements to run tourbillon.


Using distribution packages

Ubuntu 14.04

Download the debian package for your architecture:



Run dpkg to install it:

$ sudo dpkg -i tourbillon_0.5_amd64.deb

or for the 32 bit version:

$ sudo dpkg -i tourbillon_0.5_i386.deb

Centos 6.6

Download the rpm package for your architecture:



Run rpm to install it:

$ sudo rpm -i tourbillon-0.5-1.x86_64.rpm

or for the 32 bit version:

$ sudo rpm -i tourbillon-0.5-1.i686.rpm

Using pip

It's strongly recomended to install tourbillon inside a virtualenv.

$ pip install tourbillon

Generate an initial configuration file

Except for the debian package, you will need to generate the tourbillon's configuration file.

By default, the tourbillon's configuration is stored in /etc/tourbillon/tourbillon.conf.

To generate the configuration file type the following command:

$ tourbillon init

The init command will ask you for the InfluxDB's connection parameters and the logging configuration.

List available Tourbillon plugins

tourbillon has an index of official, featured and unofficial plugins. The plugins listed in the index are python packages hosted on pypi.

You can list the plugins present in the index by typing:

$ tourbillon list

The output of this command will only show the plugins compatible with you python runtime version.

Install plugins

To install a plugin enter:

$ tourbillon install <plugin-name>

After the installation it will be needed to create the plugin configuration file. By default tourbillon search for the plugins configuration file in /etc/tourbillon/conf.d. Please refer to the plugin documentation for detailed instruction.

Start tourbillon

If you have installed tourbillon from a distribution package enter:

$ sudo /etc/init.d/tourbillon start

If you have installed tourbillon with pip type:

$ tourbillon run


If you want to contribute to the project, you can submit bugs, feature requests, translations or fork the github repository and submit your pull request.



tourbillon and all the official plugins are released under the Apache License 2.0.