Skip to content
Reports logs and metrics from Puppet to Logstash
Ruby Puppet HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib/puppet/reports
manifests
spec
templates
.fixtures.yml
.gitignore
.pmtignore
.rspec
CHANGELOG.md
Gemfile
LICENSE
README.md
Rakefile
metadata.json

README.md

#Logstash Reporter Puppet module

####Table of Contents

  1. Overview
  2. Module description - What the module does and why it is useful
  3. Setup - The basics of getting started with the Logstash Reporter
  1. Usage - Configuration options and additional functionality
  2. Limitations - OS compatibility, etc.
  3. Development - Guide for contributing to the module
  4. Support - When you need help with this module
  5. Credits

##Overview

This module manages the Logstash reporter which sends puppet reports to Logstash ( http://www.elasticsearch.org/overview/logstash/ )

##Module description

The logstash_reporter module sets up and configures the reporter

##Setup

###The module manages the following

  • reporter configuration file.

###Requirements

  • json
  • yaml
  • Master puppet.conf needs to use the logstash reporter.
[master]
report = true
reports = logstash
pluginsync = true
  • Agent puppet.conf needs to send the reports to master.
[agent]
report = true
pluginsync = true

##Usage

###Main class

####Basic usesage

class { 'logstash_reporter':
}

And have a TCP input configured in logstash

input {
  tcp {
    type => "puppet-report"
    port => 5999
    codec => json
  }
}

####Separate logstash host and port

class { 'logstash_reporter':
  logstash_host => '123.123.123.123',
  logstash_port => 1234,
}

##Limitations

This module has been built on and tested against Puppet 3.2 and higher.

The module has been tested on:

  • Debian 6/7/8
  • CentOS 6/7
  • Ubuntu 12.04, 14.04
  • OpenSuSE 13.x

Other distro's that have been reported to work:

  • RHEL 6
  • OracleLinux 6
  • Scientific 6

Testing on other platforms has been light and cannot be guaranteed.

##Development

##Support

Need help? Join us in #logstash on Freenode IRC or go to our Discuss groups

##Credits

This module was originally posted by John Vincent at https://github.com/lusis/puppet-logstash-reporter

You can’t perform that action at this time.