trappar / remote_syslog2-cookbook

Development repository for the remote_syslog2 cookbook https://supermarket.getchef.com/cookbooks/remote_syslog2

remote_syslog2 cookbook

Installs and configures remote_syslog2

Requirements

Platforms

• Ubuntu (tested using 14.04)

Attributes

remote_syslog2 runtime configuration

The main configuration of remote_syslog2 is done using a hash which mirrors the structure of the remote_syslog2 config yaml file...

node['remote_syslog2']['config'] = {
  files: [],
  exclude_files: [],
  exclude_patterns: [],
  hostname: node['hostname'],
  destination: {
    host: 'logs.papertrailapp.com',
    port: 12345
  }
}

Since this is rendered directly to YAML, you can theoretically configure any value which is normally configurable. For more information please reference the remote_syslog2 examples

Additional remote_syslog2 command line settings can be specfified in the extra_options attribute

node['remote_syslog2']['extra_options'] = '--facility=local6'

For the sake of clarity this cookbook saves the config file to /etc/remote_syslog2.yml rather than the normal /etc/log_files.yml by default

Note about updates

As of version 0.3.0 of this cookbook the binary for remote_syslog2 will include the binary's version number after it - for example "/usr/local/bin/remote_syslog_0.17". This is because remote_syslog2 has no command line flag to find out a binary's version, and this cookbook needs some way of detecting old versions that need to be updated. If you are directly using this binary outside of chef, you will need to make sure you're using the correctly updated binary path.

Recipes

default

Include the default recipe in a run list to have remote_syslog2 installed and configured

install

Installs remote_syslog2

configure

Generates config file for remote_syslog2

service

Installs remote_syslog2 as an init.d service and starts/enables it

Usage

Generally all you have to do to use this cookbook is add the default recipe to your run_list and configure the node['remote_syslog2']['config'] hash.

Troubleshoot

Wiki

License and Authors

Author:: Jeff Way ([e-mail])