logstash_reporter

Install and configure Logstash reporter for Puppet

Elastic

elasticsearch

70,219 downloads

70,219 latest version

3.1 quality score

Version information

  • 0.1.0 (latest)
released Jun 5th 2015
This version is compatible with:
  • Puppet Enterprise >= 3.2.2
  • Puppet >=3.2.0 <4.0.0
  • RedHat
    ,
    CentOS
    ,
    OracleLinux
    ,
    Scientific
    ,
    Debian
    ,
    Ubuntu
    ,
    OpenSuSE

Start using this module

Documentation

elasticsearch/logstash_reporter — version 0.1.0 Jun 5th 2015

#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