Description

This cookbook installs only logstash and provides few typical configurations.
It doesn't install or depends on java, apache, nginx, elasticsearch, kibana, etc...

It also skips lumberjack.

Usage

Default recipe only creates user/group and arks logstash.
You are free to do anything with installation.

Also cookbook provides HWRPs for managing services and configs of logstash.
You can define multiple services and configs.

HWRP

logstash_config

Generic HWRP for managing logstashs' configs. It also creates parent directory for your config.
You better want to use its child classes.

Actions

• create - default, creates new config
• delete - deletes config

Attributes

• service - logstash service name config belongs to. Defaults to logstash
• config - logstash config file name to create. Defaults to node['logstash']['prefix_conf']/<service>/<name>.conf
• source - config template to use. Defaults to logstash/<name>.conf.erb
• owner - set owner of config file. Defaults to node['logstash']['user']
• group - set group of config file. Defaults to node['logstash']['group']
• mode - set group of config file. Defaults to 0640
• variables - set variables for config template. Defaults to {}

logstash_input

This resource based on logstash_config. It has the same actions and attributes.
But it has some different default values:

• config - Defaults to node['logstash']['prefix_conf']/<service>/10_input_<name>.conf
• source - Defaults to logstash/input/<name>.conf.erb

logstash_filter

This resource based on logstash_config. It has the same actions and attributes.
But it has some different default values:

• config - Defaults to node['logstash']['prefix_conf']/<service>/20_filter_<name>.conf
• source - Defaults to logstash/filter/<name>.conf.erb

logstash_output

This resource based on logstash_config. It has the same actions and attributes.
But it has some different default values:

• config - Defaults to node['logstash']['prefix_conf']/<service>/90_output_<name>.conf
• source - Defaults to logstash/output/<name>.conf.erb

logstash_service

Defines logstash service based on runit HWRP.

Actions

Actions are same as in runit HWRP. Use this resource as you use runit

Attributes

• logstash_config_path - Defaults to node['logstash']['prefix_conf']/<servicename>
• logstash_plugin_path - Defaults to nil
• logstash_filter_workers - Defaults to 1
• logstash_quiet - Defaults to true
• logstash_verbose - Defaults to false
• logstash_debug - Defaults to false

Example

You can visit fixture cookbook [simple-logstash-test](test/fixtures/cookbooks/simple-logstash-test)

Requirements

Platform:

• debian
• ubuntu
• centos

Cookbooks:

• ark
• runit (>= 1.7.2)

Attributes

• node['logstash']['download_url'] - Defaults to https://download.elastic.co/logstash/logstash/logstash-1.5.3.tar.gz.
• node['logstash']['checksum'] - Defaults to eb3c366074e561d777348bfe9db3d4d1cccbf2fa8e7406776f500b4ca639c4aa.
• node['logstash']['version'] - Defaults to 1.5.3.
• node['logstash']['user'] - Defaults to logstash.
• node['logstash']['group'] - Defaults to logstash.
• node['logstash']['prefix_root'] - Defaults to /opt.
• node['logstash']['prefix_conf'] - Defaults to /etc.

Recipes

• simple-logstash::default

License and Maintainer

Maintainer:: Yauhen Artsiukhou (jsirex@gmail.com)
Source:: https://github.com/jsirex/simple-logstash-cookbook
Issues:: https://github.com/jsirex/simple-logstash-cookbook/issues

License:: Apache 2