Troubleshoot

Log collection

Log collection simplifies the process of collecting logs for Citrix Workspace app. The logs help Citrix to troubleshoot, and, in cases of complicated issues, provides support. This feature is available from Citrix Workspace app for Windows 2012 version and later.

You can collect logs using the GUI.

Collecting logs:

  1. Right-click the Citrix Workspace app icon in the notification area and select Advanced Preferences.
  2. Select Log collection. The Log collection dialog appears.

    log collection

  3. Select one of the following log levels:
    • Low
    • Medium
    • Verbose
  4. Click Start collecting logs to reproduce the issue and collect the latest logs.

    The log collection process starts.

    log collection

  5. Click Stop collecting logs after the issue is reproduced.
  6. Click Save log to save the logs to a desired location.

Data collected through logs

Hardware

  • Attached monitors information
  • Memory information
  • Network adapters
  • Processor
  • Direct X diagnostics information

Software

  • Citrix Workspace app version
  • OS information (version, service pack, and architecture)
  • Internet Explorer version
  • Default browser
  • ActiveX Flash version
  • NPAPI Flash version

Registry

  • HKEY_LOCAL_MACHINE\Software\Citrix\AuthManager
  • HKEY_LOCAL_MACHINE\Software\Citrix\CitrixCAB
  • HKEY_LOCAL_MACHINE\Software\Citrix\Dazzle
  • HKEY_LOCAL_MACHINE\Software\Citrix\ICA Client
  • HKEY_LOCAL_MACHINE\Software\Citrix\Install
  • HKEY_LOCAL_MACHINE\Software\Citrix\InstallDetect
  • HKEY_LOCAL_MACHINE\Software\Citrix\PluginPackages
  • HKEY_LOCAL_MACHINE\Software\Citrix\Receiver
  • HKEY_LOCAL_MACHINE\Software\Citrix\ReceiverInside
  • HKEY_LOCAL_MACHINE\Software\Citrix\XenDesktop
  • HKEY_LOCAL_MACHINE\Software\Policies\Citrix
  • HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Zones
  • HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ZoneMap\Domains
  • HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\NetworkProvider\Order
  • HKEY_CURRENT_USER\Software\Citrix\AuthManager
  • HKEY_CURRENT_USER\Software\Citrix\CitrixCAB
  • HKEY_CURRENT_USER\Software\Citrix\Dazzle
  • HKEY_CURRENT_USER\Software\Citrix\ICA Client
  • HKEY_CURRENT_USER\Software\Citrix\Install
  • HKEY_CURRENT_USER\Software\Citrix\InstallDetect
  • HKEY_CURRENT_USER\Software\Citrix\PluginPackages
  • HKEY_CURRENT_USER\Software\Citrix\Receiver
  • HKEY_CURRENT_USER\Software\Citrix\ReceiverInside
  • HKEY_CURRENT_USER\Software\Citrix\XenDesktop
  • HKEY_CURRENT_USER\Software\Policies\Citrix
  • HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\VisualEffects
  • HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Zones
  • HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ZoneMap\Domains

Event Logs

  • Application Event log
  • System Event log

Tracing

  • HDX
  • Receiver shell, Auth Manager, and Self-Service plug-in
  • Install logs
  • Always-On logs

Addition of the Troubleshooting option in the system tray of Citrix Workspace app

From Citrix Workspace app 2309 version and later, the Troubleshooting option is introduced to improve the user experience and to easily proceed with the troubleshooting. You can right-click on the Citrix Workspace app icon in the system tray that is placed in the bottom-right corner of your screen and then select Troubleshooting to access it.

The options available under Troubleshooting are:

  • Send Feedback
  • Collect Logs
  • Check Configuration
  • Reset App Data
  • Help

Troubleshooting

Send feedback on Citrix Workspace app

The Send feedback option allows you to inform Citrix about any issues that you might run into while using Citrix Workspace app. You can also send suggestions to help us improve your Citrix Workspace app experience.

You can submit feedback using the following steps:

  1. Right-click the Citrix Workspace app icon in the notification area and select Troubleshooting > Submit feedback. The Submit Feedback screen appears.

    Send feedback

  2. Provide the issue Title.
  3. Add issue details in the Tell us more field.
  4. Click Capture my issue. The Log collection screen appears.

    Log collection

    1. Click Start collecting logs and then reproduce the issue to collect the latest logs.
    2. Click Stop collecting logs after the issue is reproduced.

      Or,

      Click Collect existing logs if you are not able to reproduce the issue.

    3. Click Stop collecting logs after the issue is reproduced.
  5. Ensure that the log files are displayed next to Capture my issue.
  6. Click Choose file and then add attachments that describe your issues such as screenshots or screen recordings. The maximum file size allowed for all the attachments including the log file is 20 MB.
  7. Click Send. The Feedback report screen appears.

    Feedback report

    The .zip file contains the log files, the issue description as test files, and the attachments.

  8. You can send the feedback report to Citrix using the following options:
  • Click Ok to use the default mail app in your system.

Or,

  • Send the report manually to the provided email ID.

Note:

Ensure that the .zip file is attached in the email.

Troubleshoot