Puppet module to manage logstash
Switch branches/tags
Pull request Compare This branch is 658 commits behind elastic:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
manifests
spec
templates/etc/init.d
.fixtures.yml
.gemfile
.travis.yml
CHANGELOG
CONTRIBUTORS
Modulefile
README.md
Rakefile

README.md

puppet-logstash

A puppet module for managing and configuring Logstash

http://www.logstash.net

Build Status

Usage

Installation, make sure service is running and will be started at boot time:

 class { 'logstash': }

Removal/decommissioning:

 class { 'logstash':
   ensure => 'absent',
 }

Install everything but disable service(s) afterwards:

 class { 'logstash':
   status => 'disabled',
 }

When you want to use an other service manager like 'runit' or 'daemontools':

 class { 'logstash':
   status   => 'unmanaged'
 }

If you rather supply your own init script:

 class { 'logstash':
   initfile => 'puppet:///path/to/initfile'
 }

In all cases you can supply a defaults file:

 class { 'logstash':
   defaultsfile => 'puppet:///path/to/defaults'
 }

Installation with a JAR file:

 class { 'logstash':
   provider => 'custom',
   jarfile  => 'puppet:///path/to/jarfile',
   installpath => '/path/to/install/dir'
 }

When no init script is provided when using custom provider, built in init script will be placed. You can however supply your own init script and defaults file.

 class { 'logstash':
   provider     => 'custom',
   jarfile      => 'puppet:///path/to/jarfile',
   initfile     => 'puppet:///path/to/initfile',
   defaultsfile => 'puppet:///path/to/defaultsfile'
 }

If you want java to be installed by the module:

 class { 'logstash':
   java_install => true
 }

If you want a specific java package/version:

 class { 'logstash':
   java_install => true,
   java_package => 'packagename'
 }

Plugins

Every plugin in Logstash has its own define file.

For more information check the puppet files in the input, output and filter directories.