arillso.system.rsyslog role – Configure and manage rsyslog environment using Ansible

Note

This role is part of the arillso.system collection (version 0.0.34).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install arillso.system.

To use it in a playbook, specify: arillso.system.rsyslog.

Entry point main – Configure and manage rsyslog environment using Ansible

Synopsis

  • This spec defines the parameters for configuring rsyslog and its environment on various distributions using Ansible.

Parameters

Parameter

Comments

rsyslog_configuration

dictionary

Main configuration for rsyslog including modules, global directives, and rules.

global_directives

dictionary

Global directives for file ownership, permissions, and other settings.

dir_create_mode

string

Permissions for new directories.

file_create_mode

string

Permissions for new log files.

file_group

string

Default group for log files.

file_owner

string

Default owner for log files.

include_config

string

Include additional configuration files.

umask

string

Default umask for creating new files and directories.

work_directory

string

Work directory for rsyslog.

modules

list / elements=dictionary

Configuration for rsyslog modules.

description

string

Description of the module.

name

string

Name of the module.

settings

dictionary

Specific settings for the module, varies by module.

input

dictionary

Input settings for imudp and imtcp modules.

port

integer

Port number for UDP or TCP syslog reception.

type

string

Type of the input, e.g., imudp or imtcp.

rules

list / elements=dictionary

Defines rules for logging different types of messages.

action

string

Action to take for messages matching the filter.

description

string

Description of what the rule does.

filter

string

Filter defining which messages this rule applies to.

rsyslog_packages

list / elements=string

List of rsyslog packages to be installed.

Default: ["rsyslog"]

rsyslog_service

string

Name of the rsyslog service.

Default: "rsyslog"