Documentation forKiwi Syslog Server

Log file rotation

When you add an action to log messages to a file in Kiwi Syslog Server, you can choose to automatically rotate log files. Use log file rotation to prevent log files from growing indefinitely and using large amounts of disk space.

When log files are rotated:

  • Messages are logged to the current log file. For example, SyslogCatchAll.txt.
  • When the current log file reaches the specified size or age, it is renamed. For example, SyslogCatchAll.txt becomes SyslogCatchAll.txt.001. The logging process then creates a new, empty file with the original file name.
  • When the new file reaches the specified size or age, the process is repeated. For example, SyslogCatchAll.txt.001 becomesSyslogCatchAll.txt.002, and SyslogCatchAll.txt becomes SyslogCatchAll.txt.001.
  • When the maximum number of log files in the rotation have been created, the oldest is deleted.

To automatically rotate your log files:

  1. From the Kiwi Syslog NG navigation bar, choose Setup > Rules.
  2. Select the rule that will rotate log files and click Edit.
  3. In the Actions list, select the Log to file action and click Edit.
  4. Check the Enable Log File Rotation box.
  5. Specify the total number of log files in the rotation set.
  6. Specify the rotation criteria:
    • To rotate files based on size, select Maximum log file size.
    • To rotate files based on age, select Maximum log file age.
  7. If you are adding an action to an existing rule, click Apply. If you are creating an action in the New Rule wizard, click Add.