Skip to main content
Kofax

TotalAgility - How to enable Transformation Data Layer Logging

Goal

To enable Transformation Server Data Layer logging.

First Step

Backup the existing Kofax.CEBPM.CPUServer.ServiceHost.exe.config.  The default location is: C:\Program Files\Kofax\TotalAgility\Transformation Server\Kofax.CEBPM.CPUServer.ServiceHost.exe.config

Second Step

Replace the system diagnostics section with the following section (this will enable both verbose TS and DL logging):

<system.diagnostics>
    <trace autoflush="true" />
    <switches>
      <!-- Set the TraceLevelSwitch to any of the following values:
    
        Off - None
        Error - Only error messages
        Warning - Warning messages and error message
        Information  - Informational messages, warning messages and error messages.
        Verbose - Verbose messages, informational messages, warining messages and error messages.
        All - All messages.
      
    For more information about tracing options, see: http://msdn.microsoft.com/en-us/libr...v=vs.100).aspx -->
        <add name="TraceLevelSwitch" value="All" />
        <add name="DataLayerSwitch" value="All"/>
    </switches>
    <sources>
      <source name="Kofax.CEBPM.CPUServer.ServiceHost" switchName="TraceLevelSwitch">
        <listeners>
          <clear />
          <add name="CPUServerLogTxt" />
          <add name="EventLogListener" />
        </listeners>
      </source>
      <source name="Kofax.CEBPM.CPUServer.Core" switchName="TraceLevelSwitch">
        <listeners>
          <clear />
          <add name="CPUServerLogTxt" />
          <add name="EventLogListener" />
        </listeners>
      </source>
      <source name="Kofax.CEBPM.CPUServer.Common" switchName="TraceLevelSwitch">
        <listeners>
          <clear />
          <add name="CPUServerLogTxt" />
          <add name="EventLogListener" />
        </listeners>
      </source>
      <source name="Kofax.CEBPM.DataLayer.Extensions" switchName="TraceLevelSwitch">
        <listeners>
          <clear />
          <add name="CPUServerLogTxt" />
          <add name="EventLogListener" />
        </listeners>
      </source>   
    <!--  <source name="Performance" switchValue="All" >
        <listeners>
          <clear />
          <add name="CPUServerPerf" />
        </listeners>
      </source> -->
     <source name="Kofax.CEBPM.DataLayer" switchName="DataLayerSwitch">
           <listeners>
             <clear/>
             <add name="DataLayerAll"/>
           </listeners>
         </source>   
    </sources>        
    <sharedListeners>
      <!-- The below info applies only to listeners of type Kofax.CEBPM.CPUServer.Common.Diagnostics.DateTimeTaggedTraceListener
 
  For initializeData, specify the file where log entries are saved, and optionally, the format for timestamps.
 
  The format for initializeData is "log file name;timestamp format;encoding" where timestamp format and encoding are optional (leave blank).
  The log file will be placed in the same folder where the Transformation Server is installed.  To place it elsewhere, give the full path including drive.
  And make sure that the user account running the Transformation Server service has full access to that folder.
 
    By default, the entries use timestamps in the default date format:
 
    MM/dd/yyyy hh:mm:ss.fff tt
          
    If you want to specify a different timestamp format, use a semicolon (;) after the file name and use the appropriate date/time format string.
  For supported formats, see: http://msdn.microsoft.com/en-us/library/8kb3ddd4.aspx
    
    For example, to save logs to TSLog.log and set timestamps to day-month-year format, give the following value for
    initializeData:
    
    initializeData="TSLog.log;dd.MM.yyyy hh:mm:ss.fff tt"
    
    If you only provide the file name, such as initializeData="TSLog.log", the default timestamp format is used.
    -->
      <add name="CPUServerLogTxt" type="Kofax.CEBPM.CPUServer.Common.Diagnostics.DateTimeTaggedTraceListener, Kofax.CEBPM.CPUServer.Common" initializeData="KofaxCPUServerLog.log">
        <filter type="System.Diagnostics.EventTypeFilter" initializeData="All" />
      </add>
      <!--
      <add name="CPUServerLogXml" type="System.Diagnostics.XmlWriterTraceListener" initializeData="KofaxCPUServerLogXml.log" >
        <filter type="System.Diagnostics.EventTypeFilter" initializeData="All"/>
      </add>
  -->
      <add name="EventLogListener" type="System.Diagnostics.EventLogTraceListener" initializeData="KofaxTransformationServerService">
        <filter type="System.Diagnostics.EventTypeFilter" initializeData="Error" />
      </add>
      <add name="CPUServerPerf" type="Kofax.CEBPM.CPUServer.Common.Diagnostics.DateTimeTaggedTraceListener, Kofax.CEBPM.CPUServer.Common" initializeData="KofaxCPUServerPerfLog.log">
        <filter type="System.Diagnostics.EventTypeFilter" initializeData="All" />
      </add>
      <add name="DataLayerAll" traceOutputOptions="DateTime,ThreadId" initializeData="KofaxCEBPMDataLayer.log" type="System.Diagnostics.TextWriterTraceListener"/>
    </sharedListeners>
  </system.diagnostics>
 

Third Step

Restart the Transformation Server service to apply the change.  Then replicate the behaviour to capture in the TS and DL verbose log data.  Note: By default, the logs will be generated in the Transformation Server folder:  C:\Program Files\Kofax\TotalAgility\Transformation Server. 

 

Please attach the Transformation Server logs to your Kofax Support case.   

Important

This should not be enabled for a long period of time and should be closely monitored as the logs can become large quickly.  Once the necessary TS and DL information is gathered within a short time period, please ensure to revert to the original Kofax.CEBPM.CPUServer.ServiceHost.exe.config and restart the Transformation server.

 

  • Was this article helpful?