A Puppet module for managing the installation of Graphite.

The main difference to the usual graphite installations is that we always use instances explicitly here, even if there is only one running

That means that you should alway do something like:

• start carbon-cache-a
• start carbon-relay-a

All cache / relay instances will get their own set of configuration which can be globally via cache_default_override_conf and relay_default_override_conf or per instance specific config hash.

TODO:

• Fix puppet-rspec tests to match new configuration

Usage

You will need Python, Python's development headers/libs, pip and virtualenv installed. If you're not already managing these you can use the python module, which is included as a dependency:

class { 'python':
  pip        => true,
  dev        => true,
  virtualenv => true,
}

Then for the simplest possible configuration:

include graphite

Configuration

If you want to run the web interface on a port other than 80 you can pass this in like so:

class { 'graphite':
  port => 9000,
}

Versioning

If you want to install a specific version of whisper and carbon, you like so:

class { 'graphite':
  port    => 9000,
  version => '0.9.12',
}

Cluster setup

If you want to spawn multiple carbon cache and relay instances:

class {'graphite':
   root_dir => '/var/lib/graphite'
   cache_instances => {'a' => {}, 'b' => {}, 'c' => {} }
   relay_instances => {
       'a' => {
           'DESTINATIONS' = '1.2.3.4:2004:a, 5.6.7.8:3004:b' },
       'b' => {}
   }
}

Another Graphite module?

Graphite can be painfull to install and many blog posts and gists are dedicated to that fact. However it appears to have got easier with most of the components now available in the Python Package repository. All the other puppet modules I found either lacked support for Ubuntu/Debian, relied on an undocumented package or did a lot of wgetting.

Although I've only tested this module on Ubuntu it should work on other distros too, maybe with minor tweaks.