Documentation forKiwi Syslog Server

Log file rotation

This snippet is used for legacy 9.8.3 topics that link to a KSS NG topic of the same name.

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.

Log file rotation is only available in the licensed version of legacy Kiwi Syslog Server.

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 Service Manager, go to File > Setup.
  2. Under the rule, select the Log to file action.
  3. Select Enable Log File Rotation.
  4. Specify the total number of log files in the rotation set.
  5. 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.
    • To rotate files based on date, see this THWACK page.
  6. Click OK.