Skip to main content

How to enable logging for the Document Transformation Service

Article # 307582 - Page views: 1179


Question / Problem: 

How to troubleshoot the Thin Client Service (e.g. Validation Callback not working)

Answer / Solution: 


Thin Client Server:

  1. Open the Thin Client Service's 'Web.config' file in a text editor (by default this is located in C:\Document Transformation\Client\)
  2. Look for the commented '<system.diagnostics>' tag near the top
  3. Uncomment it, and edit it so it looks similar to the following:


<trace autoflush="true">
<add name="myListener" traceOutputOptions="DateTime" type="System.Diagnostics.TextWriterTraceListener" initializeData="C:\Document Transformation\ThinClientServer.txt">
<filter type="System.Diagnostics.EventTypeFilter" initializeData="



  • The path in the first 'initializeData' attribute is where the log file will be saved (C:\Document Transformation\ThinClientServer.txt)
    Important: the IIS user must have access to this location in order to log events!
  • The second 'initializeData' sets the log level ("Verbose")
  • Save the file and restart the IIS service (or use iisreset)


Document Transformation Service:

Open the registry editor regedit.exe and go to the following key:

32-Bit Machine:HKEY_LOCAL_MACHINE: SOFTWARE\Kofax\Transformation\4.0\Server\

64-Bit Machine:HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Kofax\Transformation\4.0\Server\

Here you will find the Values LogFilePath and LogLevel.


The LogFilePath value specifies the log folder and the LogLevel value can be used to specify the log level as shown below.


Log Level Description
1 Fatal - designates severe error events that presumably lead the application to terminate
2 Error - designates error events that may allow the application to continue running
3 (default) Warning - designates potentially harmful situations
4 Info - designates informational messages that highlight the progress of the application at a coarse-grained level
5 Debug - designates fine-grained informational events that are useful to application debugging


Applies to:  

Product Version Category
RPA 10.3.2.x Document Transformation


Author:  Delia Milchis