Ansible Role systemd_journald

This role configures Systemd’s logging service „journald“.

From man journald.conf:

SystemKeepFree= control how much disk space systemd-journald shall leave free for other uses.
SystemMaxUse= control how much disk space the journal may use up at most.
systemd-journald will respect both limits and use the smaller of the two values.

Example with numbers on a 100G disk:

SystemKeepFree=10G means that journald may use at most 100G - 10G = 90G
SystemMaxUse=20G

Whenever journald needs to free space, it computes min(90G, 20G), and then deletes archived journal files until usage <= that value. Here, journald will grow the journal up to about 20G, then start deleting archived files to stay under that cap.

Tags

Tag	What it does
`systemd_journald`	Manages the journald config
`systemd_journald:state`	Manages the state of the journald service

Optional Role Variables

Variable	Description	Default Value
`systemd_journald__conf_storage`	Controls where to store journal data. Have a look at `man 5 journald.conf`. Possible options: * `volatile` * `persistent` * `auto` * `none`	`'persistent'`
`systemd_journald__conf_system_keep_free`	Controls how much disk space systemd-journald shall leave free for other uses. Unlike in `journald.conf`, you may also specify a percentage value, which will be automatically converted to bytes based on the partition size.	`'70%'`
`systemd_journald__conf_system_max_use`	Controls how much disk space the journal may use up at most. Unlike in `journald.conf`, you may also specify a percentage value, which will be automatically converted to bytes based on the partition size.	`5G`
`systemd_journald__service_enabled`	Enables or disables the service, analogous to `systemctl enable/disable`.	`true`
`systemd_journald__service_state`	Changes the state of the service, analogous to `systemctl start/stop/restart/reload`. Possible options: * `started` * `stopped` * `restarted` * `reloaded`	`'started'`

Example:

# optional
systemd_journald__conf_storage: 'persistent'
systemd_journald__conf_system_keep_free: '20%'
systemd_journald__conf_system_max_use: '5G'
systemd_journald__service_enabled: true
systemd_journald__service_state: 'started'

License

The Unlicense

Author Information

Linuxfabrik GmbH, Zurich