rsyslog
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:
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.
ansible-galaxy install papanito/ansible-role-rsyslog