This article provides an overview of logging features available with Receiver for Mac, and explains how to use them in the Receiver.
Receiver for Mac has the logging interface in the Advanced tab of the Receiver Preferences. The Preferences menu can be accessed from the Desktop Viewer Window or the Apple application bar along the top.
There are five types of logging available in Receiver for Mac: Installer Logging, Session Logging, Store Logging, Always-on Logging, and Receiver Updates Logging. Installer logging, Always-on and Receiver Updates logging are enabled by default. Conversely, Session Logging and Store Logging are disabled by default.
Installer Logging captures debug messages from the Receiver during the installation.
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. As expected, the AuthManager handles the authentication between the user and the Receiver Store or Site. The StoreComms manages the information about the Store configurations and connection settings.
Receiver for Mac 12.2 introduced the Always-on Logging feature, which helps collect important one-time event. This feature is enabled by default and turns on basic level of logging regardless of the logging configuration.
Log files generated by Always-on Logging are stored in ~/Library/Logs/Citrix Receiver. Always-on Logging keeps 2 log files for the ReceiverHelper/Citrix Receiver/Citrix Receiver Launcher/NPAPI plugin component, and 10 files for Citrix Viewer.Log files for the Citrix Receiver Launcher and NPAPI plugin component contain logs related to session launch from a web browser. The NPAPI plugin is used while launching using Safari web browser and Citrix Receiver Launcher for launch using Chrome and Firefox.
Citrix Receiver Updates logging is enabled by default with Citrix Receiver for Mac Version 12.6 and later. This is helpful when troubleshooting Receiver auto-update related issues.