Differences
This shows you the differences between the selected revisions of the page.
| logging 2011-09-15 | logging 2023-08-13 (current) | ||
| Line 1: | Line 1: | ||
| ====== Logging ====== | ====== Logging ====== | ||
| - | WinSCP can log session events. Log can be written to file, to [[ui_log|log window]] (only session log), 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: | ||
| Line 8: | Line 6: | ||
| * //[[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]]. | * //[[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. | + | 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.)) | ||