This blog post was updated March 17, 2023.

We have been continually focused on improving the Session Launch Diagnostics feature since its launch last year, adding visualization improvements and quick links for error codes from the UT to make issue resolution easier. But there was a dependence for admins to get from end users the 32-bit transaction ID from the error message generated by Citrix.

Now, we’ve made enhancements to DaaS Monitor to enable admins to use Session Launch Diagnostics when they don’t have a transaction ID by allowing admins to search for failed sessions by username. You can search for a username and select a session to triage from a list of failed sessions that the user attempted to launch over the previous 48 hours. The Session Launch Diagnostics page (below) shows the details of the failed session and lists the exact component and stage where the failure occurred.

For more information, see our Session Launch Diagnostics product documentation.


Citrix products and solutions provide the flexibility and capabilities our customers need to deliver an outstanding virtual application and desktop experience to end users. Using Monitor service, we can provide information on the inner workings and statuses for the various products that, together, power Citrix DaaS. And thanks to feedback from our customers, we’re making it easier to understand why components sometimes fail so you can diagnose and fix the issue.

Consider when a user session in Citrix Workspace app fails. This can be frustrating for the user and the IT team. In this case, the Citrix admin could use the Monitor tool to pinpoint session issues across Citrix products and solutions. We’re happy to announce that session launch diagnostics functionality is now available in preview for Citrix DaaS hosted on Citrix Cloud.

Take the Guess Work Out of Session Failures

Session launch diagnostics helps IT admins understand why a session might have failed for your user by aggregating all the information you need in one place. You can also track and report each session failure independently, and we’ve compiled an exhaustive library of error codes to help you understand what went wrong and what you can do to resolve the problem.

Here’s how it works.

If you want to use session launch diagnostics, you have some prerequisites to fulfill. These include ensuring that all products in your Citrix solutions are connected and able to send data to your cloud Monitor instance and that you’re running newer versions of Citrix products that incorporate the functionality. You can find details on meeting these pre-requisites on Citrix Docs.

After you meet the pre-requisites, whenever your user encounters problems establishing a session, Citrix Workspace app will show a unique Transaction ID and give you the ability to share it with the admin or IT help desk team. The image below shows a sample error:

When the IT team or helpdesk receives the user’s unique Transaction ID, they can use Citrix Director/Monitor to quickly find out where in the Citrix ecosystem and pipeline the problem(s) occurred. All they need to do is open Citrix DaaS in the Citrix Cloud console, navigate to the Monitor section, and search using the unique transaction ID provided by the user, as shown below.

Click image to view larger.

Once they find the transaction-id details in Monitor, they can view the details of the session that generated the transaction-id, along with an option to Export logs for this transaction-id as CSV file, as shown here:

Click image to view larger.

The logs will contain details of all the Citrix products or services involved when the user initiated a session. The error code is also produced for any failures that might have occurred. Based on the product or component, you can find more details about the error code, like the cause of the error and its recommended remediation, in our product documentation.

As a public preview, session launch diagnostics will roll out to all customers using Citrix DaaS on Citrix Cloud in the U.S., E.U. and AP-S regions by April 8, 2022. And no sign-up or change in settings is required for customers to try session launch diagnostics in preview.

Share Your Feedback

We’re excited about the preview of session launch diagnostics, and we’re looking to continue to enhance the functionality. As we approach general availability, we want to hear from you. Share your feedback and questions on the Citrix Discussion Forum.

In the coming months, we plan to make enhancements to the experience for session launch in Monitor. And we look forward to your feedback to help us further improve the debugging experience for Citrix admins.


Disclaimer: The development, release and timing of any features or functionality described for our products remains at our sole discretion and are subject to change without notice or consultation. The information provided is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making purchasing decisions or incorporated into any contract.