Collect logs

Log collection simplifies the process of collecting logs for Citrix Workspace app. The logs help Citrix to troubleshoot, and, in cases of complicated issues, provide support.

You can collect logs using the GUI.

  1. Open Citrix Workspace app.
  2. Click the account icon in the top‑right corner and click the Accounts option.


    Click the App indicator icon in the top‑right corner and click the Preferences option.

    The Citrix Workspace app - Preferences screen appears.

    Preferences - Accounts

  3. In the Preferences window, click the General tab.
  4. Select one of the following log levels from the Logging drop-down list:
    • Verbose: Detailed authentication and store communication logs are collected.
    • Normal: Only store communication logs are collected.
    • Only errors (Default): Only error logs are collected.
    • Disabled: Minimum logs are collected for basic troubleshooting.
  5. Click Save and Close to collect and share logs as a .zip file.

Citrix Log Collection Utility

The Citrix Log Collection Utility helps you collect both new and existing logs. This utility specifically collects verbose logs and saves all logs in a tar.gz file.

You can open the Citrix Log Collection Utility by using any one of the following methods:

  • By clicking Collect logs from the Add Account screen
  • By clicking Collect logs from the App indicator icon
  • By running ./logmgr command from the commandline
  1. Navigate to the Add Account screen.
  2. Click the hamburger menu.
  3. Select Collect logs.

    Add account


From the App indicator icon, click Troubleshooting > Collect logs.

App indicator


  1. At the command-line, navigate to the /opt/Citrix/ICAClient/util path.
  2. Run the following command: ./logmgr

    The Citrix Log Collection utility screen appears.

Citrix log collection utility

Collect fresh logs

  1. Navigate to Citrix Log Collection Utility and click Start collecting logs. The following screen appears:

    Log collection in progress

  2. Reproduce the issue scenario.
  3. Click Stop collecting logs after the issue is reproduced. The following screen appears:

    Save fresh logs

  4. Click Save logs to save the log file. The file explorer window to save logs appear.

    Save logs

  5. Click Save. The log file is saved. The following screen appears:

    Save logs file explorer

  6. Click View saved logs to view the saved logs. The saved log files are displayed in the following screen:

    Save logs file explorer


If you click Start collecting logs for the second time, you get a warning message to overwrite the existing logs:

Warning message

Collect existing logs

  1. Open the Citrix Log Collection Utility.

    Existing log utility

  2. Click Collect existing logs to collect the logs that might have captured the issue from previous occurrences. The file explorer window is opened to save the existing logs.

    Existing log file explorer

  3. Click Save to save the existing logs to a different folder, from where you can access the log files later. The following screen appears:

    Existing log file explorer

  4. Click View saved logs to view the logs.

    Existing log file explorer

Collect logs