Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Puppet module for the Diamond stats collection daemon
branch: master

This branch is 4 commits ahead, 111 commits behind garethr:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

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,
}
Something went wrong with that request. Please try again.