Skip to main content
Kofax

Kofax TotalAgility - How to enable Transformation Server CPU and Performance Logging

Goal

This KB provides steps to enable advanced diagnostic logging including performance information for the TotalAgility Transformation Server.

First Step

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

Second Step

In the Kofax.CEBPM.CPUServer.ServiceHost.exe.config update the system diagnostics section with the following lines:  Set the TraceLevelSwitch to All and uncomment the Performance source:

Kofax.CEBPM.CPUServer.ServiceHost.exe.config

<add name="TraceLevelSwitch" value="All"/>

<source name="Performance" switchValue="All" >
        <listeners>
          <clear />
          <add name="CPUServerPerf" />
        </listeners>
      </source>

In the Kofax.CEBPM.ProcessingService.Host.exe.config update the system diagnostics section with the following line: Set the TraceLevelSwitch to All

<add name="TraceLevelSwitch" value="All"/>

If you wish to save the logs in a different path, the initializeData can be updated to a different drive/path to save the log file.

For example:
<add name="CPUServerLogTxt" type="Kofax.CEBPM.CPUServer.Common.Diagnostics.DateTimeTaggedTraceListener, Kofax.CEBPM.CPUServer.Common" initializeData="d:\logs\KofaxCPUServerLog.log">
        <filter type="System.Diagnostics.EventTypeFilter" initializeData="All" />
 </add>

Restart the Kofax Transformation Server service and verify that the updated log file is written to the new directory.

Third Step

Restart the Transformation Server service to apply the change.  Then replicate the behaviour to capture the advanced diagnostic logging.  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 advanced logging information is gathered within a short time period, please ensure to revert to the original .config versions and restart the Transformation server.

 

Further logging information can be found in the Kofax TotalAgility Administrators Guide. 

Applies to KTA 7.x