Ansible role "papanito.rsyslog"

Ansible role to forward syslog to a log service like Loggly.com or Logz.io. The role also forwards the systemd logs to syslog. Details regarding the syslog configuration can be found here:

• Loggly.com
• Logz.io
• NewRelic.com

Remark

This role is based on the role from jmcvetta/ansible-loggly

Requirements

Respective account for the logging service and an api token for that account to be able to submit the data. Checked link documentation above.

NewRelic.com requires an account in us data center, european data center will not work.

Role Variables

There are common role variables and service specific ones. Most variables should be fine (as tested). Thus it's recommended to only define these variables

Parameter	Description	Default Value
rsyslog_srv	set this to use the correct service	logz.io
rsyslog_tls	true or false in case you want plaintext	true
rsyslog_tag		syslog
rsyslog_token	Token to authenticate against the rsyslog_srv - please set accordingly in your playbook	YOUR_TOKEN_GOES_HERE
rsyslog_cert	[Name of the certificate to be used for secure connection	rsyslog.crt
rsyslog_action_queue_file_name	unique name prefix for spool files	fwdRule1
rsyslog_action_queue_max_disk_space	space limit (use as much as possible)	1g
rsyslog_action_queue_save_on_shutdown	save messages to disk on shutdown	on
rsyslog_action_queue_action_type	type of the action queue	LinkedList
rsyslog_action_resume_retry_count	number of retries if host is done, ,-1 means infinite	-1
rsyslog_additional_config	list of additional config like authpriv.* /var/log/auth.log	''

Dependencies

n/a

Testing

Assumes you have Ruby and Bundler already installed.

bundle install  # Only required once
bundle exec kitchen test

You can run the test playbook if you use Hetzner Cloud:

ANSIBLE_HOST_KEY_CHECKING=false HCLOUD_TOKEN=$HCLOUD_DEV ansible-playbook tests/newrelic.com.yml -i tests/inventory --vault-pass-file $ANSIBLE_VAULT_FILE -e stop_server=false

Example Playbook

- name: Forward server logs to rsyslog service
  hosts: "servers"
  vars:
    rsyslog_srv: logz.io
    rsyslog_tls: true
    rsyslog_tag: syslog
    rsyslog_token: xxxxxxxxxxxxxxxxxxxxxxxx

  roles:
     - papanito.rsyslog

License

This is Free Software, released under the terms of the Apache v2 license.