Debug Log Level Citrix Workspace App For Mac

admin

Citrix Workspace app for Mac overview High performance web and self-services access to virtual apps and desktops. Configure for anywhere access from your desktop or web access with Safari, Chrome or Firefox.

  1. If Workspace is installed, this is the process to uninstall Citrix Workspace for MAC:.Of Note. Do not install the app from the APP Store, this causes apps to automatically update.
  2. Open Citrix Workspace app and tap 'Settings' and then 'Support'. Tap 'Request Help from Support'; This generates an email with log file. Send the email to your company's IT support team. In the App Store, go to Citrix Workspace 2. Tap 'Reviews' and then tap 'App Support' found at the bottom right of the screen.
  3. Complete the following procedure to obtain detailed logging details for troubleshooting Citrix Receiver for the Windows: Note Post debug, logging needs to be stopped and the logs have to be deleted manually. If the logging is not stopped this will increase disk utilization by log file. Also while debugging is enabled, expect an impact to.
  4. Download, Install, and Configure Citrix Workspace for Mac OSX Adding, Removing, and Refreshing Apps Within Citrix Receiver Citrix ICA files do not automatically delete from Chrome's Downloads folder.

Applicable Products

  • Receiver for Mac

Objective

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.

Instructions

Select Connection Diagnostics or Full in the Session Logging.
There are two settings within Session Logging- Connection Diagnostics and Full Logging. Connection Diagnostics logging is specific to identifying errors while connecting so all logging will be enabled up until the point when the session is deemed successful. Full Logging will log everything including the Connection Diagnostics and Session Logging.
CitrixNote: Full Logging can impact performance and must only be used while troubleshooting an issue because of the amount of data. It must not be left on during normal use. The user enabling this logging will get a warning that must be acknowledged to continue.
Once enabled, the Receiver will store up to 10 Session Logs after which they are deleted starting with the oldest to maintain 10 logs. Select Normal or Verbose in the Store Logging.
The two levels of the Store Logging are Normal and Verbose. With Verbose, the AuthManager will provide more detailed debugging information. Use Normal when only StoreComms logging is necessary. Select Disabled in the Session Logging and Disabled in the Store Logging.
The Receiver log files are stored in the local Mac user’s home directory: ~/Library/Logs/.
Type of loggingLog file location
Installer logging~/Library/Logs/ReceiverInstall.log
Session logging~/Library/Logs/Citrix Receiver/CitrixViewer_<time_stamp>.txt (*)
Store loggingNormal~/Library/Logs/CitrixServerCommunication.log
Verbose~/Library/Logs/com.citrix.AuthManager.log, com.citrix.AuthManager_1.log
andServiceRecord.log
(along with CitrixServerCommunication.log)
Always-on loggingWeb Browser Launch Logging
(Citrix Receiver Launcher/NPAPI plugin component)		~/Library/Logs/Citrix Receiver/com.apple.WebKit.Plugin.64_<time_stamp>.txt
~/Library/Logs/Citrix Receiver/Citrix Receiver Launcher_<time_stamp>.txt
Receiver Helper Logging~/Library/Logs/Citrix Receiver/ReceiverHelper_<time_stamp>.txt
Citrix Receiver Logging~/Library/Logs/Citrix Receiver/Citrix Receiver_<time stamp>.txt
Citrix Viewer Logging~/Library/Logs/Citrix Receiver/CitrixViewer_<time_stamp>.txt (*)
Citrix Receiver Updater Logging~/Library/Logs/Citrix Receiver/Citrix Receiver Updater_<time_stamp>.txt

(*) The log files for Always-on logging (for Citrix Viewer) and Session logging are the same. Viewer log files generated by Always-on logging contains only the most important logs. However, if Session logging is enabled, other logging along with the Always-on logswill be written to the log file.

You can click “Email Log Files” available in the Logging screen to zip Session/Store/Always-on/Citrix Receiver Updater log files, and send it as an attached file via email using your default email client.

Applicable Products

  • Receiver for Windows

Objective

This article describes how to enable logging on Receiver for Windows by using registry entries.
This article might be helpful if you have difficulty in using Receiver Diagnostic Tools.
If there is no special reason, we recommend Receiver Diagnostic Tools instead of using registry entries.

Instructions

There are several types of logging available using the registry entries. Enable any combination of these logs, depending on the issue.

To switch on the logging, requires an administrator to change registry values

Complete the following procedure to obtain detailed logging details for troubleshooting Citrix Receiver for the Windows:

Note Post debug, logging needs to be stopped and the logs have to be deleted manually. If the logging is not stopped this will increase disk utilization by log file. Also while debugging is enabled, expect an impact to performance.

In addition to the above logging CitrixWorkspace app 1808 provides capability for to generate SSON and browser logging​

Receiver Logging - General

Use the following settings to enable general logging for Receiver:

  1. Navigate to HKEY_LOCAL_MACHINESOFTWARECITRIX.

  2. Add new DWORD value:

    • For 32-bit systems: [HKEY_LOCAL_MACHINESOFTWARECitrix]
      Name: ReceiverVerboseTracingEnabled
      Type: REG_DWORD
      Data: 1

    • For 64-bit systems: [HKEY_LOCAL_MACHINESOFTWAREWow6432NodeCitrix]
      Name: ReceiverVerboseTracingEnabled
      Type: REG_DWORD
      Data: 1

  3. Restart the workstation or server.

  4. Log Location (Receiver_.log ):

    • %localappdata%CitrixReceiver

  5. To disable this logging, set the preceding registry value to zero (0).

Receiver Logging - Authentication Manager

Use the following settings to enable logging for authentication issues (for example StoreFront, and so on.).

  1. Navigate to HKEY_LOCAL_MACHINESOFTWARECITRIX.

  2. Browse to the following registry key:

    • For 32-bit systems: [HKEY_LOCAL_MACHINESOFTWARECitrixAuthManager]

    • For 64-bit systems: [HKEY_LOCAL_MACHINESOFTWAREWow6432NodeCitrixAuthManager]

  3. Add the following registry values:

    • Name: LoggingMode
      Type: REG_SZ
      Data: verbose

    • Name: TracingEnabled
      Type: REG_SZ
      Data: True

    • Name: SDKTracingEnabled
      Type: REG_SZ
      Data: True

  4. Restart Citrix Receiver

  5. Log Location

    • %localappdata% CitrixAuthManager

  6. To disable this logging, set the TracingEnabled and SDKTracingEnabled registry data to: False and the type: REG_SZ.

Receiver Logging - Self-Service Plugin

Use the following settings to enable logging related to subscribed applications, communication with StoreFront:

  1. Navigate to HKEY_LOCAL_MACHINESOFTWARECITRIX.

  2. Browse to the following registry key:

    • For 32-bit systems: [HKEY_LOCAL_MACHINESOFTWARECitrixDazzle]

    • For 64-bit systems: [HKEY_LOCAL_MACHINESOFTWAREWow6432NodeCitrixDazzle]

  3. Add the following registry values:

    • Name: Tracing
      Type: REG_SZ
      Data: True

    • Name: AuxTracing
      Type: REG_SZ
      Data: True

    • Name: DefaultTracingConfiguration
      Type: REG_SZ
      Data: global all -detail

  4. Restart Citrix Receiver.

  5. Log Location (There are sub-folders in this location, collect all filesfolders):

    • %localappdata% CitrixSelfService

  6. To disable this logging, set the Tracing and AuxTracing registry data value to: False and the type: REG_SZ.

SSON Logging

Use the following settings to enable logging with SSON enabled:

  1. Navigate to registry path

    • For 32 bit platforms, the registry path is
      HKEY_LOCAL_MACHINESOFTWARECitrixInstallSSON

    • For 64 bit platforms, the registry path is
      HKEY_LOCAL_MACHINESOFTWAREWow6432NodeCitrixInstallSSON

  2. Add new String value 'DebugEnabled'='true'

  3. Add another String value 'LogPath'=<specify the path to save logs>

Receiver Logging - Browser (New Component of Receiver)

Debug Log Level Citrix Workspace App For Mac 10 11

Use the following settings to enable logging related to browser for SaaS applications

  1. Navigate to HKEY_LOCAL_MACHINESOFTWARECITRIX

  2. Browse to the following registry key:
    For 32-bit systems: [HKEY_LOCAL_MACHINESOFTWARECitrixBrowser]
    For 64-bit systems: [HKEY_LOCAL_MACHINESOFTWAREWow6432NodeCitrixBrowser]

  3. Add the following registry values:
    Name: Logging
    Type: REG_SZ
    Data: Enable (Values can be Enable or Disable or Verbose and values are case-insensitive)
    By Default logging would be disabled

  4. Restart the launched SaaS app for logging to take place

  5. Log Location:
    %localappdata% Citrix Browser

By default, logging would be disabled.

Debug Log Level Citrix Workspace App For Mac 1812

Additional Resources

CTX141751 - Citrix Receiver Diagnostics Tool - For Windows

Disclaimer

Debug Log Level Citrix Workspace App For Mac Windows 10

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.