How to Capture a Common Diagnostic Facility (CDF) Trace using Registry Settings

This article describes how to capture a Common Diagnostic Facility (CDF) trace during system startup using registry settings.

Caution! Refer to the Disclaimer at the end of this article before using Registry Editor.
To capture a CDF trace during system startup using registry settings, complete the following steps:

1. Create a registry value under: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Tracing:
   Value Name: PersistentTraceLogPath
   Value Type: REG_SZ
   Value: Type the log path here
   
   Note: The value for the log path must be a file path, such as C:\CitrixLogFile. Do not type the name of the log file.

   The trace session name and trace log file name is always CDF_PersistSession and CDF_PersistSession.etl, respectively. The log file is stored in the path specified by the registry settings. The trace path must be an existing path, you cannot create it at runtime.?? ?? ?? ?? ?? ?? ??

2. To enable the trace providers, modify the provider registry values under:
   KEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Tracing\Modules\<Providers>:
   Value Name: “Enabled”
   Value Type: REG_DWORD
   Value: Set 1, to enable tracing?? ?? ?? ?? ?? ?? ?? ?? ?? ??

3. Set Flags and Level in HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Tracing\Modules\<Providers>:
   Value Type: REG_DWORD
   Value: Set the required trace flags, supplied by Citrix Technical Support.
   The maximum flag level is hex FFFFFF.
   
   Value Name: “Level”??
   Value Type: REG_DWORD
   Value: Set the required trace level, supplied by Citrix Technical Support.
   The highest level is decimal 16.

4. In addition to these steps you may have to modify the following registry value to LocalSystem:
   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\CdfSvc\
   Value Name: ObjectName
   Value Type: REG_SZ
   Value: “LocalSystem”
   Note: To correctly capture traces during startup, some service and driver components might need to depend on the CdfSvc service.

5. Change the service startup dependency. You must modify or add the DependOnService registry value to the following recommended components:
   • TermService
   • Cdm
   • WDICA
   • IMAService

6. The DependOnService registry value is located in: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<ServiceName>
   Value Name: “DependOnService”
   Value Type: REG_MULTI_SZ
   Value: Append CdfSvc to the list

7. Restart cdfsvc.exe or the server.

Note:

CTX127131 -?? How to Collect a Citrix Diagnostic Facility (CDF) Trace at System Startup

Caution! Using Registry Editor incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.