rotation.sizeLimit¶
This permits to set a size limit on the output file.
This parameter applies to omfile: File Output Module.
- Name:
rotation.sizeLimit
- Scope:
action
- Type:
size
- Default:
action=0 (disabled)
- Required?:
no
- Introduced:
at least 5.x, possibly earlier
Description¶
This permits to set a size limit on the output file. When the limit is reached, rotation of the file is tried. The rotation script needs to be configured via rotation.sizeLimitCommand.
Please note that the size limit is not exact. Some excess bytes are permitted to prevent messages from being split across two files. Also, a full batch of messages is not terminated in between. As such, in practice, the size of the output file can grow some KiB larger than configured.
Also avoid to configure a too-low limit, especially for busy files. Calling the rotation script is relatively performance intense. As such, it could negatively affect overall rsyslog performance.
Action usage¶
action(type="omfile" rotation.sizeLimit="...")
Legacy names (for reference)¶
Historic names/directives for compatibility. Do not use in new configs.
$outchannel — maps to rotation.sizeLimit (status: legacy)
See also¶
See also omfile: File Output Module.
Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project
Contributing: Source & docs: rsyslog source project
© 2008–2025 Rainer Gerhards and others. Licensed under the Apache License 2.0.