Documentation

PLEASE NOTE: This document applies to v2.18 version and not to the latest stable release v2.19

Documentation for other releases can be found by using the version selector in the top right of any doc page.

logrotate

Manage log rotation configurations.

Attributes

check_mode:
  support: full

Parameters

Parameter	Required	Type	Values	Description
compress		boolean		Compress rotated log files. [default: `false`]
config_file		string		Custom configuration file path (default: /etc/logrotate.d/).
copy		boolean		Copy log file before truncating instead of moving. [default: `false`]
copytruncate		boolean		Truncate original log file in place instead of moving. [default: `false`]
create		string		Create new log file after rotation with specified permissions. Format: mode owner group (e.g., “0644 root root”).
dateext		boolean		Use date as suffix for rotated files. [default: `false`]
dateformat		string		Format for date suffix (strftime format).
delaycompress		boolean		Delay compression until the next rotation cycle. [default: `false`]
frequency		string	daily weekly monthly yearly	How often to rotate logs. [default: `"daily"`]
missingok		boolean		Don’t report errors if log file is missing. [default: `false`]
notifempty		boolean		Don’t rotate empty log files. [default: `false`]
path	true			Path to log file(s). Can be a single path or a list of paths.
postrotate		string		Script to run after rotation.
prerotate		string		Script to run before rotation.
rotate		integer		Number of rotated files to keep.
shared_scripts		boolean		Execute prerotate/postrotate scripts only once for all matched files. [default: `false`]
sharedscripts		boolean		Don’t rotate if sharedscripts is set and the script fails. [default: `false`]
size		string		Rotate when file exceeds this size (e.g., “100M”, “1G”).
state		string	present absent	Whether the configuration should be present or absent. [default: `"present"`]

Examples

- name: Configure log rotation for app
  logrotate:
    path: /var/log/app.log
    frequency: daily
    rotate: 7
    compress: true
    missingok: true
    notifempty: true

- name: Configure log rotation for multiple log files
  logrotate:
    path:
      - /var/log/app1.log
      - /var/log/app2.log
    frequency: weekly
    rotate: 4
    compress: true
    delaycompress: true

- name: Configure log rotation with size limit
  logrotate:
    path: /var/log/large-app.log
    size: 100M
    rotate: 5
    compress: true

- name: Remove log rotation configuration
  logrotate:
    path: /var/log/old-app.log
    state: absent