Contents

Sending events from Puppet to Riemann

Contents

I’ve just released a Puppet report processor for sending metrics to Riemann. The report sends the status of the current run: unchanged, failed, etc and then each of the metrics generated during the run.

You can find the code on GitHub and a module on the Forge.

There are some simple installation instructions:

  1. Install the riemann-client gem on your Puppet master

    $ sudo gem install riemann-client
    
  2. Install puppet-riemann as a module in your Puppet master’s module path.

  3. Update the riemann_server and riemann_port variables in the riemann.yaml file with your riemann server IP and port and copy the file to /etc/puppet/. An example file is included.

  4. Enable pluginsync and reports on your master and clients in puppet.conf

    [master]
    report = true
    reports = riemann
    pluginsync = true
    [agent]
    report = true
    pluginsync = true
    
  5. Run the Puppet client and sync the report as a plugin.