SAP Knowledge Base Article - Public

1598642 - How to turn on tracing in Crystal Reports for Enterprise and Crystal Reports Viewer?


  • How to create a trace?
  • How to generate a log for Crystal Reports for Enterprise?
  • How to enable tracing for Crystal Reports for Enterprise or Crystal Reports Viewer?


  • SAP Crystal Reports for Enterprise 4.1
  • SAP Crystal Reports for Enterprise 4.2
  • SAP Crystal Reports for Enterprise 4.3
  • SAP Crystal Reports Viewer 2013
  • SAP Crystal Reports Viewer 2016
  • SAP Crystal Reports Viewer 2020


  • To enable tracing for Crystal Reports for Enterprise, as well as for Crystal Reports Viewer:
    1. In a Text Editor, create a file and copy the following lines:
      log4j.rootLogger=INFO, CRtrace
      log4j.appender.CRtrace.layout.ConversionPattern=%r\t%t\t%p\t%c - %m%n
      # Modify the last line above to specify where to create the log files.
      # Make sure the directory exists before running your application.
      # For example, if you don't change this line, then make sure the directory C:\logs exists.
      # Note: There are 4 levels of logging: DEBUG, INFO, WARN, ERROR    
    2. Save the file as: C:\logs\
    3. Open the file: config.ini file, in a Text Editor.

      The file: config.ini, is located under the windows user profile directory at the following path:
      • For Crystal Reports for Enterprise 4.1, 4.2 and 4.3:
              %USERPROFILE%\AppData\Roaming\Business Objects\Crystal Reports for Enterprise XI 4.0\configuration14.x.x.xx
      • For Crystal Reports Viewer 2013:
              %USERPROFILE%\AppData\Roaming\Business Objects\Crystal Reports Viewer 2013\  
      • For Crystal Reports Viewer 2016:
              %USERPROFILE%\AppData\Roaming\Business Objects\Crystal Reports Viewer 2016\ 
      • For Crystal Reports Viewer 2020:
              %USERPROFILE%\AppData\Roaming\Business Objects\Crystal Reports Viewer 2020\ 
      • Notes:
        • If more than one configuration folder is available, use the most recent folder
        • If the config.ini file is not there, a file can be created
    4. Add the following line to the config.ini file, abd replace <filename>, by the file name:
      For example: If the filename was saved as C:\logs\, the line added would be: 
    5. Launch Crystal Reports for Enterprise, or Crystal Reports Viewer, and perform the workflow to reproduce the issue.
      The log file will be created in the location specified in the log4j.appender.CRTrace.File property of the '' file. In this example, the trace will be at C:\logs\CRtrace.log 
  • To enable tracing of the connection layer in of Crystal Reports for Enterprise, see the SAP Knowledge Base Article 1816033 

See Also

1816033  - How do I turn on Trace Logs in Crystal Reports for Enterprise?


CR4E, 4.0, CRViewer, CRViewer 2010, Crystal Reports Viewer 2010, Log on to SAP BusinessObjects Enterprise, log into SAP BusinessObjects Enterprise,  Cannot connect to SAP BO Enterprise at this time, Crystal viewer 2013, crystal reports viewer 2013 , KBA , BI-RA-CR , Crystal Reports designer or Business View Manager , BI-RA-CRV , SAP Crystal Reports Viewer , How To


SAP Crystal Reports viewer 2013 ; SAP Crystal Reports viewer 2016 ; SAP Crystal Reports viewer 2020