Forge Home


Module to configure logstash_forwarder


6,195 latest version

4.6 quality score

Version information

  • 0.1.2 (latest)
  • 0.1.1
released Oct 25th 2016
This version is compatible with:
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'icann-logstash_forwarder', '0.1.2'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add icann-logstash_forwarder
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install icann-logstash_forwarder --version 0.1.2

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



icann/logstash_forwarder — version 0.1.2 Oct 25th 2016

Build Status Puppet Forge Puppet Forge Downloads


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 logstash_forwarder
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module


This module installs logstash_forwarder and can also manage the custom scripts, host script and custom modules directories


What logstash_forwarder affects

  • installs logstash_forwarder
  • Adds a syslog entry for logstash
  • Optionally rotate the logstash log file

Setup Requirements OPTIONAL

  • puppetlabs-stdlib 4.12.0
  • icann-tea 0.2.5
  • icann-logrotate

Beginning with logstash_forwarder

The logstash host and the SSL certificate source locations are both mandadory parameters

class {'::logstash_forwarder':
  logstash_server => '',
  logstash_cert_source => 'puppet:///modules/mod_files/logstash.pem',



Public Classes

Private Classes

Class: logstash_forwarder

Main class

  • logstash_server (Tea::Host, Default: undef): The host name or IP address of the logstash server
  • logstash_cert_source (Tea::Puppetsource, Default: undef): This is a string which will be passed the file type source paramter and treated as the file containing the logstash public key
  • logstash_port (Tea::Port, Default: 5000): The port of the logstash server
  • service_name (String, Default: 'logstash-forwarder'): name of the service to mnanage
  • syslog_enable (Boolean, Default: true): redirect syslog entries to a logstash file
  • syslog_pattern (String, Default: '*.warn'): The syslog pattern to forward to logstash
  • syslog_file (Tea::Absolutepath, Default: /var/log/logstash_syslog): file file location to redirect syslog messages to
  • logrotate_enable (Boolean, Default: true): Rotate the file used for syslog messages
  • logrotate_rotate (Integer[1,1000], Default: 5): how many copys of the syslog file to keep with logrotate
  • logrotate_size (String, Default: '100M'): how large a file is allowed to be before its rotated
  • conf_file (Tea::Absolutepath, Default: os specific): location of the logstash forwader config file
  • logstash_cert_dir (Tea::Absolutepath, Default: os specific): location where to store the logstash public certificate
  • files (Array[Logstash_forwarder::File), default: undef): An array of hashes. Each hash tells what paths to watch and what fields to annotate on events from those paths (


This module is tested on Ubuntu 12.04, and 14.04 and FreeBSD 10