Puppet module for the Diamond stats collection daemon
Ruby Puppet
Clone or download
Pull request Compare This branch is 4 commits ahead, 123 commits behind garethr:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
manifests
spec
templates/etc/diamond
.fixtures.yml
.gitignore
.travis.yml
Gemfile
Gemfile.lock
LICENSE
Modulefile
README.md
Rakefile

README.md

A Puppet module for managing the installation and configuration of Diamond.

Build Status

Usage

For experimenting you're probably fine just with:

include diamond

This installs diamond but doesn't ship the metrics anywhere, it just runs the archive handler.

Configuration

This module currently exposes a few configurable options, for example the Graphite host and polling interval. So you can also do:

class { 'diamond':
  graphite_host => 'graphite.example.com',
  interval      => 10,
}

Diamond supports a number of different handlers, for the moment this module supports only the Graphite, Librato and Riemann handers. Pull request happily accepted to add others.

With Librato:

class { 'diamond':
  librato_user   => 'bob',
  librato_apikey => 'jim',
}

With Riemann:

class { 'diamond':
  riemann_host => 'riemann.example.com',
}

Note that you can include more than one of these at once.

class { 'diamond':
  librato_user   => 'bob',
  librato_apikey => 'jim',
  riemann_host   => 'riemann.example.com',
  graphite_host  => 'graphite.example.com',
}

Optional requirements

Diamond appears not to have a canonical package repository I could find or a PPA or similar. PyPi has a record but not source or binary packages. So this module can make use of my own personal debian package repository. This is installed with the garethr module if needed. Alernatively host your own package repository.

The Riemann and Librato handlers require some additional Python libraries not currently installed by this module.

package {[
  'simplejson',
  'requests',
  'bernhard',
]:
  ensure   => installed,
  provider => pip,
}