https://github.com/AerisCloud/ansible-rsyslog

Manage the rsyslog configuration files
https://github.com/AerisCloud/ansible-rsyslog

Last synced: 3 months ago
JSON representation

Manage the rsyslog configuration files

• Host: GitHub
• URL: https://github.com/AerisCloud/ansible-rsyslog
• Owner: AerisCloud
• License: mit
• Created: 2015-02-25T06:06:05.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-07-07T05:18:25.000Z (almost 7 years ago)
• Last Synced: 2024-01-18T12:44:39.285Z (5 months ago)
• Homepage: http://www.wizcorp.jp/
• Size: 23.4 KB
• Stars: 3
• Watchers: 5
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars - ansible-rsyslog - Manage the rsyslog configuration files (Others)

README

        
rsyslog

=======

This roles configures [rsyslog](http://www.rsyslog.com/).

It manages the general configuration file and several service-specific configuration files.

Usage

-----

In your role's meta, add a dependency to this role using the syntax described below.

```yaml

# my_role/meta/main.yml

dependencies:

  - role: aerisloud.rsyslog

    caller_name: my_role

```

Your role must contain a template file named `rsyslog.conf.j2` which will be copied on to the server.

Variables

---------

When `use_rsyslog_udp` is set to `true`, rsyslog will provides UDP syslog reception. Default is `false`.

The default UDP listening port is `514`. Set `use_rsyslog_udp_port` to change the port.

If `logstash_forwarder` is set to the name of one of the machine in the inventory,

`rsyslog` will forward the logs to this machine.

In addition to setting `logstash_forward`, if `private_ip` is set, `rsyslog` will forward

to this IP address. Default is the `ansible_host` of the `logstash_forwarder`. This is

useful when the `logstash_forwarder` have multiple IPs, such as global and private IPs.

If `logstash_syslog_port` is set, rsyslog will send to the `logstash_forwarder` on that port.

The default port is `514`. This is useful if logstash is not running as root and cannot listen on ports 0-1024.

If you are not using a centralized log forwarding service and would like to have rsyslog on each server to

send logs directly to [Papertrail](https://papertrailapp.com/), set the following:

  - set `use_papertrail` to `true`. Default is false.

  - set `papertrail_host` to the [Papertrail log destination](https://papertrailapp.com/account/destinations). An

    account is required.

  - set `papertrail_port` to the [Papertrail port](https://papertrailapp.com/account/destinations) given.

  - `logstash_forwarder` defaults to an empty string, `''`. If it is defined, `rsyslog` will forward the logs to this machine.

  - set `papertrail_pem` to the full path of the papertrail-bundle.pem file. Default: `/etc/papertrail-bundle.pem`.