Contents » Configuration » Preferences Dialog »

Logging Page (Preferences Dialog)

The Logging page on the Preferences dialog allows user to configure session and XML logging.

Refer to documentation of page sections:

Session log

To enable logging to a file, check Enable session logging on level. In versions prior to the latest beta version, you also need to check Log to file.


To increase verbosity of the session log select Debug 1 or Debug 2 level. You will probably need these (together with logging to file), when reporting bugs only.

Specify local path to log file into Log path/Log to file box. Log file name can contain following patterns: !Y (year), !M (month), !D (day), !T (time), !@ (hostname), !S (session name), !P (process ID), !! (exclamation mark).

If you select Append option, and the logging file already exists, session log will be appended to the end of the file. Otherwise the existing file will be overwritten.

You can limit a log file size by specifying a maximum size in bytes in Rotate log files after reaching box. Supported units are K, M and G. If a log file reaches the configured limit, it is archived to a file with extension .1, .2, etc. You can limit number of archived log files using Delete old logs files, keep … files checkbox. This feature is available only in the latest beta release.

If you enable logging to file in mid-session the past events will not be written to the log retrospectively. Note that to log several sessions simultaneously to file, you need to ensure unique names of the log files (e.g. using some of the patterns above). Passwords are not written to log file.

Tick Log passwords and other sensitive information to turn off obfuscation of passwords and other sensitive information in session log. It is useful when debugging authentication issues. Note that sensitive information passed on command-line are logged even with the option turned off.

XML log

To enable XML log, check Enable XML logging to file and specify local path to log file. You can use the same patterns as for session log file (see above).

It is not possible to change XML log file name in middle of the session.

Further Reading

Read more about Preferences dialog and its other pages.

  ui_pref_logging.txt · Last modified: by martin


This page


About donations

$9   $19   $49   $99

About donations



Site design by Black Gate