Troubleshoot
As a Technical Preview, this software is under active development. This section provides guidance on known issues and outlines the essential process for providing feedback and collecting diagnostic logs. Active participation from the user community is vital to identifying and resolving issues.
How to provide feedback
User feedback represents the most critical component of the Technical Preview program. Detailed reports from users prove invaluable to the engineering teams for improving the product.
Submit all feedback, including feature requests, bug reports, and general usability comments, through the following methods. You can leave basic feedback about the app with optional screenshots, directly on your Vision Pro using the TestFlight app. You can also leave more detailed feedback here: Feedback Form.
For support during the beta testing phase, email us at cwavisionoshelp@citrix.com.
When submitting feedback, be as detailed as possible. Include a clear description of the issue, the steps you need to reproduce it, the expected behavior, and the actual behavior you observe.
Collecting logs to report an issue
For technical issues, providing diagnostic logs helps engineers identify the root cause of a problem most effectively.
Before reporting an issue, follow these steps to collect logs:
On-device app logging
To help with troubleshooting general app and store connection issues, we have added on-device app logging and log sharing.
To collect logs, follow these steps:
- Go to Settings > Logging and set the log level to High.
- Reproduce the issue.
- Go back to Settings > Logging and click Share Logs - this allows you to share the logs as an archive.
- You can share the archive via AirDrop or Mail or Save to Files, and so on.
Store session logging
To help with troubleshooting issues with your store configuration around launching apps or desktops, we have added a way for you to access the Session Logs page. A Clipboard button is now available on the Store window toolbar. Once you log in to the store, use this button to open the Session Logs page.
Note:
When you first log in to a store, the Session Logs page might take a few seconds to load (if it’s already open or if you open it right after you log in). This is normal - the Session Logs page eventually loads once the necessary server cookies synchronize.
If you’re having trouble starting an app or desktop:
- Log in to the store - wait a few seconds if you are a first-time user.
- Tap the Clipboard button to open the Session Logs page.
- Tap Enable Logging - Logging is specific to the Workspace Preview client and for the device you’re on.
- Close the Session Logs window (or move it to the side).
- Use the store to start an app or desktop - wait for the app to open or error out.
- Go back to the Session Logs page.
- Click the log related to the app or desktop launch that you want to download, then click the down arrow next to it. That downloads the log as a text file (.txt) and opens the Share page.
- From there you can copy the log contents, or share the file via AirDrop or Mail or Save to Files, and so on.
For stores that have the Download All Logs option, you can use that to download all the logs in a zip file and share.