Citrix Workspace Mac App



downloadWhy can't I download this file?Citrix Workspace Latest Download
  • Citrix Receiver Download
  • Citrix Workspace Mac App

    Applicable Products

    See full list on docs.citrix.com. 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.

    • Citrix Workspace App
    • Receiver

    Objective

    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.

    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.

    Instructions

    To enable Session Logging


    Connection Diagnostics logging is specific to identifying errors while connecting. 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. Once enabled, the CWA will store up to 10 Session Logs after which they are deleted starting with the oldest to maintain 10 logs.
    Note: 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.

    To enable Store Logging

    Select Normal or Verbose

    Citrix Workspace Latest Download

    in the Store Logging.

    Citrix Receiver Download

    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.

    To disable Session/Store Logging

    Select Disabled in the Session Logging and Disabled in the Store Logging.
    The CWA 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 Workspace/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 Workspace/com.apple.WebKit.Plugin.64_<time_stamp>.txt
    ~/Library/Logs/Citrix Workspace /Citrix Workspace Launcher_<time_stamp>.txt
    Receiver Helper Logging~/Library/Logs/Citrix Workspace /ReceiverHelper_<time_stamp>.txt
    Citrix Workspace App Logging~/Library/Logs/Citrix Workspace /Citrix Workspace _<time stamp>.txt
    Citrix Viewer Logging~/Library/Logs/Citrix Receiver/CitrixViewer_<time_stamp>.txt (*)
    CWA Updater Logging~/Library/Logs/Citrix Workspace /Citrix Workspace 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.

    Email Log Files

    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.

    downloadWhy can't I download this file?
  • The session display is four times bigger and network bandwidth usage increases significantly. You might see performance issues if you have applied a bandwidth limiter.
  • Increase in usage of Remote resources. For most of the users VDA CPU usage only increases marginally. Depending on the capacity and configuration of your VDA, the effect of CPU usage may vary. 3D Pro VDAs are best suited to handle these situations. Ensure that you use VDAs with adequate CPU and memory resources and GPU offloading in case you see degradation in the performance.
  • COMING SOON (we will update this article and Citrix Workspace app for mac release notes when these are available. We do not have a timeline as of now.)

    • Support for single monitor retina 5k displays (Mac mini, iMacs, and Mac Pro).
    • Support for multi-monitor scenarios.