How to Enable and Collect Logging for Citrix Workspace App (CWA) for Mac

Citrix Workspace App (CWA) for Mac logging

This article provides an overview of logging features available with Citrix Workspace App for Mac, and explains how to use them in the Citrix Workspace App.

Logging Interface

The logging interface is located in the Advanced tab of the CWA Preferences. The Preferences menu can be accessed from the Desktop Viewer Window or the Apple application bar along the top.

User-added image

There are five types of logging available in CWA for Mac and some are enabled by default:

  • Installer Logging (default: Enabled)
  • Always-on Logging (default: Enabled)
  • CWA Updates Logging (default: Enabled)
  • Session Logging (default: Disabled)
  • Store Logging (default: Disabled)

Installer Logging

Installer Logging captures debug messages from the CWA during the installation.

Session and Store Logging

Session Logging includes all the diagnostic logging from the ICA session. Therefore, it only applies to the Citrix Viewer when the session is up. Use this logging for any problem within the ICA session, perhaps unexpected behavior in an ICA session.

Store Logging includes logging of AuthManager and StoreComms modules. AuthManager handles user authentication to the CWA Store. The StoreComms manages the information about the Store configurations and connection settings.

Always-on Logging

The Always-on Logging feature continuously collects a subset of important logs.This feature is enabled by default and turns on basic level of logging regardless of the logging configuration.

Always-on Logging keeps log files for the following components:

  • ReceiverHelper
  • Citrix Receiver
  • Citrix Viewer
  • Citrix Workspace Launcher & NPAPI plugin components: Includes ogs related to session launch from a web browser. The Citrix Workspace Launcher for launching using Chrome and Firefox and NPAPI plugin is used while launching using Safari web browser .

NOTE: Support for NPAPI was deprecated by Apple in Safari 12.0. See here for more info.

CWA Updater Logging

CWA Updater Logging is enabled by default with Citrix Receiver for Mac Version 12.6 and later. This is helpful when troubleshooting CWA auto-update related issues.


  • No Related Posts

Leave a Reply