hindsight

Manage Hindsight log processing service

deric

deric

8,345 downloads

1,621 latest version

4.0 quality score

Version information

  • 0.3.0 (latest)
  • 0.2.1
  • 0.2.0
  • 0.1.2
  • 0.1.1
  • 0.1.0
released Mar 3rd 2020
This version is compatible with:
  • Debian
    ,
    Ubuntu
    ,
    RedHat
    ,
    CentOS

Start using this module

Documentation

deric/hindsight — version 0.3.0 Mar 3rd 2020

puppet-hindsight

Puppet
Forge Build Status Puppet Forge
Downloads

Module for managing Mozilla's Hindsight configuration and service.

Related projects

Hindsight is a log forwarding engine (successor of Mozilla's Heka) implemented in low-level C with Lua scripting support.

Usage

All module names are expected to be available via package manager.

  class{'::hindsight':
    modules => [ 'luasandbox','luasandbox-elasticsearch',
    'luasandbox-kafka','luasandbox-lpeg','luasandbox-systemd']
  }

plugin configuration:

  hindsight::plugin {'tcp':
    filename => 'tcp.lua',
    target   => 'input/tcp',
    config   => {
      instruction_limit => 0,
      address => "0.0.0.0",
      port => 5858,
      keep_payload => false,
      send_decode_failures => true,
    }
  }

target is file location in run_dir without extension (.cfg).

The simplest plugin is probably debug:

hindsight::plugin {'debug':
  filename => 'heka_debug.lua',
  target   => 'output/debug',
  config   => {
    message_matcher => 'TRUE',
  }
}

in order to disable plugin use ensure => absent:

  hindsight::plugin {'debug':
    ensure   => absent,
    filename => 'heka_debug.lua',
    target   => 'output/debug',
  }

New since version 0.3.0

  hindsight::plugin {'debug':
    filename => '',
    target   => output/debug',
    content  => template('path/to/template.erb');
  }
  # or
  hindsight::plugin {'debug':
    filename => '',
    target   => output/debug',
    source   => 'puppet:///fubarmodule/debug.cfg';
  }

Service pre-start commands

Before starting Hindsight service custom commands can be provided:

  class{'::hindsight':
    service_prestart => [ '/bin/echo foo', '/bin/echo bar']
  }