librato / statsd-cookbook

Chef cookbook to install Statsd
Apache License 2.0
26 stars 36 forks source link

DESCRIPTION

Chef cookbook to install Etsy's StatsD daemon. Supports the new pluggable backend modules.

REQUIREMENTS

Depends on the cookbooks:

ATTRIBUTES

Basic attributes

Graphite settings

Adding backends

Set the attribute backends to a hash of statsd NPM module backends. The hash key is the name of the NPM module, while the hash value is the version of the NPM module to install (or null for latest version).

For example, to use version 0.0.1 of [statsd-librato-backend][]:

attrs[:statsd][:backends] = { 'statsd-librato-backend' => '0.0.1' }

To use the latest version of statsd-librato-backend:

attrs[:statsd][:backends] = { 'statsd-librato-backend' => nil }

The cookbook will install each backend module under the statsd directory and add it to the list of backends loaded in the configuration file.

Extra backend configuration

Set the attribute extra_config to any additional configuration options that should be included in the StatsD configuration file.

For example, to set your email and token for the [statsd-librato-backend][] backend module, use the following:

    attrs[:statsd][:extra_config] => {
      'librato' => {
        'email' => 'myemail@example.com',
        'token' => '1234567890ABCDEF'
      }
    }

Test

To run unit tests using rspec you can run:

$ bundle exec rspec

To run integration tests using kitchen-ci you can run:

$ bundle exec kitchen test