logstash_forwarder

Module to configure logstash_forwarder

ICANN

icann

5,636 downloads

5,563 latest version

4.6 quality score

Version information

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

Start using this module

Documentation

icann/logstash_forwarder — version 0.1.2 Oct 25th 2016

Build Status Puppet Forge Puppet Forge Downloads

logstash_forwarder

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

Overview

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

Setup

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.example.com',
  logstash_cert_source => 'puppet:///modules/mod_files/logstash.pem',
}

Reference

Classes

Public Classes

Private Classes

Class: logstash_forwarder

Main class

Parameters
  • 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 (https://github.com/elastic/logstash-forwarder).

Limitations

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