Enable logging for Citrix Workspace app

This topic explain how to enable verbose logging for Citrix Workspace app in a Windows, Linux and Mac machine.

Citrix Workspace app for Windows

To enable verbose logging for WebRTC and WebRPC:

  1. Create the following registries on your Citrix Workspace app endpoint:

    HKCU\Software\Citrix\HDXMediaStream

    DWORD: WebrtcLogLevel

    Value: 0

     

    HKCU\Software\Citrix\HDXMediaStream

    DWORD: WebrpcLogLevel

    Value: 0

  2. Restart your application and try to reproduce the issue.

  3. Navigate to %Temp%\HdxRtcEngine\ and retrieve the logs.

    Each HDX session will create a separate folder.

Citrix Workspace app for Linux

To enable verbose logging for WebRTC and WebRPC:

  1. From you your Citrix Workspace app endpoint, navigate to /var/.config/citrix/hdx_rtc_engine/

  2. Create a config.json file with the following:

    {

    "WebrpcLogLevel": 0,

    "WebrtcLogLevel": 0

    }

  3. Retrieve the log files from /tmp/webrpc/<current date>/ and /tmp/hdxrtcengine/<current date>/ via SCP (WinSCP or similar)

Citrix Workspace app for MAC

On your Citrix Workspace app endpoint, log levels can be adjusted by executing the following commands with configuration keys, for example:

defaults write com.citrix.HdxRtcEngine WebrpcLogLevel -int 0

defaults write com.citrix.HdxRtcEngine WebrtcLogLevel -int 0

Retrieve the following logs:

  • vdwebrtc log --records the execution of Virtual Channel vdwebrtc

    Location： /Users/<User Name>/Library/Logs/Citrix Workspace/CitrixViewer_<Y_M_D_H_M_S>.txt

  • HdxRtcEngine log - records the execution of process HdxRtcEngine

    Location: $TMPDIR/hdxrtcengine/<W_M_D_H_M_S_Y>/hdxrtcengine.log

    Note that HdxRtcEngine log is enabled by default.