25.1  Log settings

When you right-click inside any log window, a context menu will be displayed where you can choose several functions or change the log's parameters (view, logged information).

Context menu

Figure 25.1. Context menu


Copy

Copies the selected text onto the clipboard. You can use the operating system hotkeys to do this (e.g. Ctrl+C or Ctrl+Insert in Windows).

Save log

The Save log option enables saving of the entire log or its selected part in any file on the disk.

The dialog options are as follows:

Save log

Figure 25.2. Save log


  • Format — the log may be saved as in plain text (TXT) or in hypertext (HTML). If the log is saved in HTML, the encoding and colours (where highlighting was used) will be saved. If it is expected that the log would be processed by a script, it might be better to save it in plain text.

  • Source — the option enables saving of the entire log or a selected part of the text.

    The Only selection option is not active by default. Once a part of the text in the log is selected by the pointer, the option becomes active and the selected text can be saved.

Find

Use this option to find a particular log row. Insert search criteria into the Find entry (words, numerals, characters).

Search

Figure 25.3. Search


  • Start from — text can be scanned either from the start of the log or from the start of the selected text (only text displayed in the window is scanned) or from the last found occurrence of the string.

  • Direction — set whether the log will be scanned upwards or downwards (Up, Down).

Highlighting

Kerio MailServer enables to highlight any part of text in logs. This function is used for better reference.

Click Highlighting to open a dialog box where highlighting can be added, changed and removed by using the typical Add, Edit and Remove buttons.

Highlighting

Figure 25.4. Highlighting


New highlighting can be set in the Add highlighting dialog box:

  • Description — description used for better reference.

  • Condition (substring) — every line containing the substring specified will be highlighted according to the parameters set in this dialog.

    If Treat as regular expression is enabled, any regular expression can be entered (for advanced users).

    Regular expressions are special POSIX expression for a string description. They are created by various flexible patterns that are compared with strings.

  • Color — select a color used for the highlighting.

Every highlighting is applied to all log types. All lines meeting the condition are highlighted.

Select font

This option opens a standard dialog box for selection of size, style and font for the log.

Encoding

Select encoding for the log.

Log Settings

Select this option to open the Log debug dialog where you can set parameters for clearing or saving logs.

The File Logging tab

File Logging

Figure 25.5. File Logging


  • Enable logging to file — enables logging to a specified file. Use the File name entry to specify a path where logs will be saved.

  • Rotate regularly— select one of the following options:

    • Every hour — log is saved once an hour and a new log file is started.

    • Every day — log is rotated once a  24 hours.

    • Every week — log is rotated once a week.

    • Every month — log is rotated once a month.

  • Rotate when file exceeds size — set maximum log file size (in KBs) in Max log file size.

  • Keep at most ... log file(s) — define how many log files will be stored. The oldest file will be cleared after each rotation.

The External Logging tab

Open the External Logging dialog to set logging to a  Syslog server or to a file. The three options can be combined.

Storing logs on Syslog server

Figure 25.6. Storing logs on Syslog server


  • Enable Syslog logging — use this option to enable logging to a Syslog server

  • Syslog server — DNS name or IP address of the particular Syslog server.

  • Facility — this entry helps Kerio MailServer recognize where a log came from (Syslog server can receive logs from various sources).

  • Severity — set how important the log is (Syslog enables filtering of logs with respect to their severity).

Clear log

Clears the log window (information is also removed from the appropriate file).

Messages

Advanced parameters for the logs can be set using this option (for details, see below). Available only in the Debug section.