Differences
This shows you the differences between the selected revisions of the page.
| 2017-07-23 | 2017-09-05 | ||
| Roll = >Rotate: More usual terminology and also consistency with /logsize (martin) | released 5.11 stable (martin) | ||
| Line 7: | Line 7: | ||
| ===== [[session_log]] Session log ===== | ===== [[session_log]] 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//. &beta | + | To enable logging to a file, check //Enable session logging on level//. |
| 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. | 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. | ||
| - | Specify [[local_path|local path]] to log file into //Log path/Log to file// box. &beta Log file name can contain following patterns: ''!Y'' (year), ''!M'' (month), ''!D'' (day), ''!T'' (time), ''!@'' (hostname), ''!S'' (session name), ''!P'' (process ID), ''!!'' (exclamation mark). | + | Specify [[local_path|local path]] to log file into //Log path// 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. | 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. &beta_feature | + | 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. |
| 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 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. | ||