SAP Knowledge Base Article - Public

1470978 - How to enable/disable crpe logging for the Crystal Reports .NET SDK

Symptom

  • Advanced logging for the Crystal Reports .NET SDK.
  • How to turn on/off crpe logging for the Crystal Reports .NET SDK?

Environment

  • Crystal Reports for Visual Studio 2010
  • Crystal Reports 2008
  • Crystal Reports XI R2
  • Crystal Reports XI R1
  • Crystal Reports 10
  • Visual Studio 2003, 2005, 2008

Resolution

Crystal Reports .NET Logging


When regular troubleshooting fails you may need to dive deeper into an issue to find out what is going on. You can turn on CRPE logging in the CR .NET SDK by modifying a few registry keys.

How to turn logging on and off


The first thing to keep in mind is that logging slows down performance. Logging is not recommended for long term use. It can result in a very slow reporting system and it creates large log files on the system.

  1. Create two .reg files called logging-on.reg and logging-off.reg using Notepad.
  2. Copy the text from the appropriate section below into each .reg file and save it.
  3. Copy the .reg files to the system where you need to do your logging.
  4. Double click the logging-on.reg file and merge the contents into the registry.
  5. Restart IIS, service, or Windows application you are monitoring. Note: The logging won't work if the Crystal runtime files are already in memory.
  6. Run the application until the point of failure, or your error message.
  7. Locate the .log files in your temp directory.
    1. Windows XP; C:\Documents and Settings\<user>\Local Settings\Temp
    2. Windows Vista, 7, Server 2008; C:\Users\<user>\AppData\Local\Temp
    3. Windows Server 2008 running Visual Studio IDE creates a subfolder \2 ( in my case ) that VS uses as a temp folder. This is where the log files are located
  8. They will be named according to the application. For example, if your app is called mySlowReport.exe - the log files will be named:
    1. mySlowReport.crpe.bkgrnd.log
    2. mySlowReport.crpe.Diagnostics.log
    3. mySlowReport.crpe.functions.log

It is best to open and analyze these log files in Excel.

Note: This logging doesn't work for the bundled version of the CR .NET SDK for Visual Studio .NET 2003.

Descriptions for the registry key values:


Destinations:

0 - No logging
1 - Log output to file
2 - Log output to the debug output window
3 - Log output to file and to the debug output window

Positions:

0 - No Logging
1 - Log on function entry
2 - Log on function exit (default)
3 - Log on function entry and exit

LogErrorsOnly:

0 - Output all log messages.
1 - Output only log messages associated with an error (non-zero return)

Crystal Reports for Visual Studio 2010

Note The log file extension created by Crystal for Visual Studio 2010 is .GLF.

Enable Logging

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging]
[HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.bkgrnd]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.diagnostics]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.functions]
"Destinations"=dword:00000003
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000003
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging]
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.bkgrnd]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.diagnostics]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.functions]
"Destinations"=dword:00000003
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000003

Disable Logging

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging]
[HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.bkgrnd]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.diagnostics]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.functions]
"Destinations"=dword:00000000
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging]
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.bkgrnd]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.diagnostics]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Crystal Reports for .NET Framework 4.0\Crystal Reports\Logging\crpe.functions]
"Destinations"=dword:00000000
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000000

 

Crystal Reports 2008

Enable Logging

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\Crystal Reports\Logging\crpe.functions]
"Destinations"=dword:00000003
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000003

Disable Logging


Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 12.0\Crystal Reports\Logging\crpe.functions\]
"Destinations"=dword:00000000
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000000

Crystal Reports 2011/2013/2016

Enable Logging

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite XI 4.0\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite XI 4.0\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite XI 4.0\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite XI 4.0\Crystal Reports\Logging\crpe.functions]
"Destinations"=dword:00000003
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000003

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Suite XI 4.0\Crystal Reports\Logging]

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Suite XI 4.0\Crystal Reports\Logging\craxdrt.methods]
"Destinations"=dword:00000003
"Position"=dword:00000002
"LogErrorsOnly"=dword:00000000

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Suite XI 4.0\Crystal Reports\Logging\crpe.functions]
"Destinations"=dword:00000003
"Position"=dword:00000002
"LogErrorsOnly"=dword:00000000

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Suite XI 4.0\Crystal Reports\Logging\crpe.bkgrnd]
"Destinations"=dword:00000003
"Position"=dword:00000002
"LogErrorsOnly"=dword:00000000

Disable Logging

 
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite XI 4.0\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite XI 4.0\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite XI 4.0\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite XI 4.0\Crystal Reports\Logging\crpe.functions]
"Destinations"=dword:00000000
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000000

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Suite XI 4.0\Crystal Reports\Logging]

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Suite XI 4.0\Crystal Reports\Logging\craxdrt.methods]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Suite XI 4.0\Crystal Reports\Logging\crpe.functions]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SAP BusinessObjects\Suite XI 4.0\Crystal Reports\Logging\crpe.bkgrnd]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000

Crystal Reports XI R2

Enable Logging


Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.5\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.5\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.5\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.5\Crystal Reports\Logging\crpe.functions\]
"Destinations"=dword:00000003
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000003

Disable Logging


Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.5\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.5\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.5\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.5\Crystal Reports\Logging\crpe.functions\]
"Destinations"=dword:00000000
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000000

Crystal Reports XI R1

Enable Logging

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.0\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.0\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.0\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.0\Crystal Reports\Logging\crpe.functions\]
"Destinations"=dword:00000003
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000003

Disable Logging


Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.0\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.0\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.0\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.0\Crystal Reports\Logging\crpe.functions\]
"Destinations"=dword:00000000
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000000

Crystal Reports for Visual Studio 2005

Enable Logging

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Crystal Decisions\10.2\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Crystal Decisions\10.2\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Crystal Decisions\10.2\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000003
"Position"=dword:00000003
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Crystal Decisions\10.2\Crystal Reports\Logging\crpe.functions\]
"Destinations"=dword:00000003
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000003

Disable Logging


Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Crystal Decisions\10.2\Crystal Reports\Logging\]
[HKEY_LOCAL_MACHINE\SOFTWARE\Crystal Decisions\10.2\Crystal Reports\Logging\crpe.bkgrnd\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Crystal Decisions\10.2\Crystal Reports\Logging\crpe.diagnostics\]
"Destinations"=dword:00000000
"Position"=dword:00000000
"LogErrorsOnly"=dword:00000000
[HKEY_LOCAL_MACHINE\SOFTWARE\Crystal Decisions\10.2\Crystal Reports\Logging\crpe.functions\]
"Destinations"=dword:00000000
"LogErrorsOnly"=dword:00000000
"Position"=dword:00000000

 

 

Keywords

trace tracing , KBA , BI-DEV-NET , BI Software Development Kits (SDKs) - .NET or Other , How To

Product

Crystal Reports 2008 V0 ; Crystal Reports 2008 V1 ; SAP Crystal Reports XI ; SAP Crystal Reports XI R2 ; SAP Crystal Reports, developer version for Microsoft Visual Studio ; SAP Crystal Reports, version for Visual Studio .NET 2005 ; SAP Crystal Reports, version for Visual Studio .NET 2008