Differences
This shows you the differences between the selected revisions of the page.
| 2009-12-20 | 2011-09-15 | ||
| 4.2.5 bug 311 (martin) | bug 481 separate session and xml log (martin) | ||
| Line 1: | Line 1: | ||
| ====== Logging Tab (Preferences Dialog) ====== | ====== Logging Tab (Preferences Dialog) ====== | ||
| - | //Logging tab// allows user to configure [[logging|session logging]]. For easier access before opening a session, the tab is duplicated on [[ui_login_logging|Login dialog]]. | + | //Logging tab// allows user to configure [[logging|session and XML logging]]. For easier access before opening a session, the tab is duplicated on [[ui_login_logging|Login dialog]]. |
| + | |||
| + | //Separate configuration of session and XML log files is available only in the latest beta release.// &beta | ||
| &screenshotpict(pref_logging) | &screenshotpict(pref_logging) | ||
| - | To enable logging, select [[logging|logging format]], //Text log// or //XML log//. | + | ===== Session log ===== |
| + | To enable session log, check //Enable session logging on level//. | ||
| - | Once the logging is enabled, you can configure the //Logging options//. | + | 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|reporting bugs]] only. |
| - | In //Logging level// you can select //Debug 1// or //Debug 2// for more verbose logging. You will probably need these (together with logging to file), when [[reporting|reporting bugs only]]. | + | To enable logging to file tick //Log to file// checkbox and specify [[local_path|local path]] to log file. Log file name can contain following patterns: ''!Y'' (year), ''!M'' (month), ''!D'' (day), ''!T'' (time), ''!@'' (hostname), ''!S'' (session name), ''!!'' (exclamation mark). |
| - | To enable logging to file tick //Log to file// checkbox and specify [[local_path|local path]] to log file. Log file name can contain following patterns: ''!Y'' (year), ''!M'' (month), ''!D'' (day), ''!T'' (time), ''!@'' (hostname), ''!S'' (session name), ''!!'' (exclamation mark). It is not possible to change log file name in middle of the session for [[logging_xml|XML logging]]. | + | 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. |
| - | 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. Appending is not allowed for XML logging. | + | 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. |
| - | + | ||
| - | If you enable logging to file in mid-session the past events will not be written to the log retrospectively. Note that simultaneous logging of several sessions to file is not supported. Passwords are not written to log file. | + | |
| When you tick //Show log window// checkbox, session log window will appear. For peformance reasons it is recommended to limit number of displayed lines. Note that if you tick //Show log window// checkbox on Login dialog, the log window will appear only after you open the session. Once the session is already opened you can show/hide log window also from //Options// menu and from toolbar. If you display log window in mid-session the past events will be displayed only if the //Enable logging// was already ticked before. | When you tick //Show log window// checkbox, session log window will appear. For peformance reasons it is recommended to limit number of displayed lines. Note that if you tick //Show log window// checkbox on Login dialog, the log window will appear only after you open the session. Once the session is already opened you can show/hide log window also from //Options// menu and from toolbar. If you display log window in mid-session the past events will be displayed only if the //Enable logging// was already ticked before. | ||
| + | |||
| + | ===== XML log ===== | ||
| + | To enable [[logging_xml|XML log]], check //Enable XML logging to file// and specify [[local_path|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. | ||
| + | |||
| + | |||
| + | |||
| + | |||