WinSCP can log session events to a log file.

Events can be logged in two formats:

  • Session log: Events are logged in unstructured form with configurable level of verbosity. Information logged differ with protocol used. This format is useful to troubleshoot problems with connection. You should also include this log when reporting bugs or asking for support.
  • XML log: Events are logged in structured form in XML format. This format includes less information than session log. However its format is documented and independent from protocol used. You will find this format particularly useful to analyze automatically performed operations, such as when using scripting.


Note that passwords and passphrases are not stored to either log format, with the default settings.1

Logging can be enabled from Logging page of Preferences dialog. Logging can also be enabled from command-line using /log and /xmllog parameters respectively, what is particularly useful with scripting. In .NET assembly, session logging is enabled using Session.SessionLogPath.2

  1. That is, if logging is set to the default level Normal, and password logging is turned off.Back
  2. XML logging is used internally by the assembly.Back

Last modified: by martin