By default this role will install rsyslog and provide a minimal configuration, however variables can be passed to this role and configuration can be overridden, for additional informations please have a look to defaults/main.yml

rsyslog_default_config: Setup a default basic configuration stanza (default: "True")
purge_config: Purge existing config snippets (default: "False")
rsyslog_use_repo: Use Adiscon rsyslog official package repository (default: "False")
rsyslog_repo_releasever: Default rsyslog major release repository version to use (default: 8)
rsyslog_action_file_template: Define a custom template for file logging (default: RSYSLOG_TraditionalFileFormat)
rsyslog_priv_drop_to_user: Drop root privileges and switch to given user (default: root)
rsyslog_priv_drop_to_group: Drop root privileges and switch to given group (default: root)
rsyslog_server_udp: Enable a simple UDP server receiver (default: False)
rsyslog_server_udp_name: Assign a name to the given receiver (default: "imudp")
rsyslog_server_udp_port: Specifies the port the server shall listen to (default: "514")
rsyslog_server_udp_address: Local ip address the udp server should listen (default: "0.0.0.0")
rsyslog_server_udp_ratelimit: The rate-limiting interval in seconds (default: "5")
rsyslog_server_tcp: Enable a simple TCP server receiver (default: False)
rsyslog_server_tcp_name: Assign a name to the given receiver (default: "imtcp")
rsyslog_server_tcp_port: Specifies the port the server shall listen to (default: "514")
rsyslog_server_tcp_address: Local ip address the tcp server should listen POSSIBLY BROKEN (default: "0.0.0.0")
rsyslog_server_tcp_ratelimit: The rate-limiting interval in seconds (default: "5")

Additional Role Variables:

rsyslog_custom_config: Use a custom template to use as main configuration file (eg: rsyslog_custom_config: /path/to/rsyslog_custom.j2)

Dependencies

None at this time.

Example Playbook

Just install rsyslog with default configuration (it will be placed in /etc/rsyslog.d/)

- hosts: all
  remote_user: root
  sudo: no
  - roles: 
    - { role: rsyslog }

Install rsyslog, without default configuration and setup two different custom stanzas

- hosts: all
  remote_user: root
  vars:
    rsyslog_default_config: False
  roles:
  - role: rsyslog
    items:
    - name: "20-iptables"
      lines: 
        - ':msg, contains, "iptables" /var/log/iptables.log'
        - '& ~'
    - name: "30-dovecot"
      lines: 
        - 'if $programname == "dovecot" and $syslogseverity <= "6" then ~'
        - '& ~'

Install rsyslog, specify a custom configuration template

- hosts: all
  remote_user: root
  vars:
    rsyslog_default_config: False
    rsyslog_custom_config: /home/servers/foo.bar/templates/rsyslog_custom.j2
  roles:
  - role: rsyslog

Install rsyslog using official repository packages, use major release 7

- hosts: all
  remote_user: root
  roles:
    - { role: rsyslog, "rsyslog_use_repo": True, "rsyslog_repo_releasever": 7 }

Enable a simple rsyslog UDP server (receiver) for remote logging

- hosts: all
  vars:
  roles:
  - role: rsyslog
    rsyslog_server_udp_port: 514
    rsyslog_server_udp_address: 192.168.200.201

License

GPLv2

Author Information

Alessio Cassibba (x-drum) http://blog.zerodev.it.