22.2  Logs Context Menu

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).

Logs Context Menu

Figure 22.4. Logs Context Menu


Copy

Copies the selected text onto the clipboard. A key shortcut from the operating system can be used (Ctrl+C or Ctrl+Insert in Windows).

Save log

This option saves the log or selected text in a file as plaintext or in HTML.

Hint

This function provides more comfortable operations with log files than a direct access to log files on the disk of the computer where WinRoute is installed. Logs can be saved even if WinRoute is administered remotely.

The Save log option opens a dialog box where the following optional parameters can be set:

Saving a log to a file

Figure 22.5. Saving a log to a file


  • Target file — name of the file where the log will be saved. By default, a name derived from the file name is set. The file extension is set automatically in accordance with the format selected.

  • Format — logs can be saved as plaintext or in HTML. If the HTML format is used, colors will be saved for the lines background (see section Highlighting) and all URLs will be saved as hypertext links.

  • Source — either the entire log or only a part of the text selected can be saved. Bear in mind that in case of remote administration, saving of an entire log may take some time.

Find

Use this option to search for a string in the log. Logs can be scanned either Up (search for older events) or Down (search for newer events) from the current position.

During the first lookup (when switched to the log window), the log is searched through from the top (or the end, depending on the lookup direction set). Further search starts from the marked text (marked by mouse or as a result of the recent search).

Highlighting

Highlighting may be set for logs meeting certain criteria (for details, see below).

Select font

Within this dialog you can select a font of the log printout. All fonts installed on the host with the Administration Console are available.

Encoding

Coding that will be used for the log printout in Administration Console can be selected in this section. UTF-8 is used by default.

Hint

Select a new encoding type if special characters are not printed correctly in non-English versions.

Log Settings

A dialog where log parameters such as log file name, rotation and Syslog parameters can be set. These parameters can also be set in the Log settings tab under Configuration → Accounting. For details, refer to chapter 22.1  Log settings.

Clear log

Removes entire log. The file will be removed (not only the information saved in the selected window).

Warning

Removed logs cannot be refreshed anymore.

Note: If a user with read rights only is connected to WinRoute(see chapter 15.1  Viewing and definitions of user accounts), the Log settings and Clear log options are missing in the log context menu. Only users with full rights can access these functions.

Log highlighting

For better reference, it is possible to set highlighting for logs meeting certain criteria. Highlighting is defined by special rules shared by all logs. Seven colors are available (plus the background color of unhighlighted lines), however, number of rules is not limited.

Use the Highlighting option in the context pop-up menu of the corresponding log to set highlighting parameters.

Log highlighting settings

Figure 22.6. Log highlighting settings


Highlighting rules are ordered in a list. The list is processed from the top. The first rule meeting the criteria stops other processing and the found rule is highlighted by the particular color. Thanks to these features, it is possible to create even more complex combinations of rules, exceptions, etc. In addition to this, each rule can be “disabled” or “enabled” for as long as necessary.

Use the Add or the Edit button to (re)define a highlighting rule.

Highlighting rule definition

Figure 22.7. Highlighting rule definition


Each highlighting rule consists of a condition and a color which will be used to highlight lines meeting the condition. Condition can be specified by a substring (all lines containing the string will be highlighted) or by a so called regular expression (all lines containing one or multiple strings matching the regular expression will be highlighted).

The Description item is used for reference only. It is recommended to describe all created rules well (it is recommended to mention also the name of the log to which the rule applies).

Note: Regular expression is such expression which allows special symbols for string definition. WinRoute accepts all regular expressions in accordance with the POSIX standard.

For detailed instructions contact Kerio technical support. For detailed information, refer for example to

The Debug log advanced settings

Special options are available in the Debug log context menu. These options are available only to users with full administration rights (see chapter 15.1  Viewing and definitions of user accounts)..

Options of information which can be monitored by the Debug log are addressed in chapter 22.6  Debug Log.