Differences
This shows you the differences between the selected revisions of the page.
| logging 2009-03-03 | logging 2023-08-13 (current) | ||
| Line 1: | Line 1: | ||
| - | ====== Session Logging ====== | + | ====== Logging ====== |
| - | WinSCP can log session events. Log can be written to file, to [[ui_log|log window]], or both. | + | WinSCP can log session events to a log file. |
| - | + | ||
| - | Logging can be enabled from //Logging tab//, which is present on both [[ui_pref_logging|Preferences dialog]] and [[ui_login_logging|Login dialog]]. Use the latter if you want to log authentication process. Logging can also be enabled from [[commandline|command-line]]. | + | |
| Events can be logged in two formats: | Events can be logged in two formats: | ||
| - | * //Text log//: Events are logged in unstructured form with configurable level of verbosity. Information logged differ with [[protocols|protocol]] used. This format is useful to diagnose problems with connection. You should also include this log when [[reporting|reporting bugs or asking for support]]. | + | * //Session log//: Events are logged in unstructured form with configurable level of verbosity. Information logged differ with [[protocols|protocol]] used. This format is useful to [[troubleshooting|troubleshoot]] problems with connection. You should also include this log when [[reporting|reporting bugs or asking for support]]. |
| - | * //[[logging_xml|XML log]]//: Events are logged in structured form in XML format. This format includes less information than text log. However its format is [[logging_xml|documented]] and independent from [[protocols|protocol]] used. You will find this format particularly useful to analyze automatically performed operations, such as when using [[scripting|scripting]]. | + | * //[[logging_xml|XML log]]//: Events are logged in structured form in XML format. This format includes less information than session log. However its format is [[logging_xml|documented]] and independent from [[protocols|protocol]] used. You will find this format particularly useful to analyze automatically performed operations, such as when using [[scripting|scripting]]. |
| + | |||
| + | Note that passwords and passphrases are not stored to either log format, with the default settings.((That is, if logging is set to the default level //Normal//, and password logging is turned off.)) | ||
| + | |||
| + | Logging can be enabled from //[[ui_pref_logging|Logging page]]// of Preferences dialog. Logging can also be enabled from [[commandline#logging|command-line]] using ''/log'' and ''/xmllog'' parameters respectively, what is particularly useful with [[scripting]]. In [[library|.NET assembly]], session logging is enabled using ''[[library_session#sessionlogpath|Session.SessionLogPath]]''.((XML logging is used internally by the assembly.)) | ||
| - | Note that passwords and passphrases not stored to either log format. | ||