New report available only in version 9.2
The following section describes a new data pipeline report only available in ControlUp for VDI version 9.2.
The Citrix Connection Failures report provides a detailed view of connection failure events in your Citrix environment. This report includes data on user identity, infrastructure details, failure categories, and client context to help you troubleshoot connection issues, identify failure patterns, and proactively address problems affecting the end-user experience.
Use the report to answer questions such as:
Which specific users encountered the highest frequency of connection issues?
What are the most common reasons for session failures across my environment?
Do connection issues primarily affect new session requests or reconnection attempts?
Is a specific Delivery Group or VDA machine disproportionately responsible for failures?
Report Functionality
For the selected timeframe, the report shows data for all Citrix VDA machines in your environment. By default, the selected time is the previous 24 hours.
Column Descriptions
The Citrix Connection Failures report contains the following columns:
Column | Description |
|---|---|
Connection Failure Time | Exact date and time the connection failure occurred |
User UPN | User Principal Name (email-style identifier) of the user who attempted the failed connection |
User Name | User who attempted the failed connection |
User Full Name | Display name or full name of the user who attempted the failed connection, as configured in Active Directory or the user directory |
Machine Name | Name of the machine where the connection failure occurred, or null if no specific machine was involved in the failure |
Resource Name | Storefront resource name (published app/desktop) as sent in event 28; raw requested resource string, not normalized to Delivery Group |
Delivery Group | Display name of the desktop group (delivery group) that the failed connection was attempting to access |
Is Reconnect | Indicates whether this was an attempt to reconnect to an existing session (true/1) or start a new session (false/0) |
Failure Category | Broad category that classifies the connection failure type (e.g.. Machine Failure. Client Connection Failure, No Capacity Available. No Licenses Available, or Configuration Issue) |
Connection Failure Problem | Description of the connection failure |
Recommended Action | Actionable recommendation for the connection failure |
Connection Failure Code | Numeric code that identifies the specific type of connection failure that occurred (e.g., machine not functional, licensing issues, etc.) |
Client Name | Name or identifier of the device the user was connecting from when the failure occurred |
Client IP Address | IP address of the user device that attempted to connect to the session |
Protocol | Communication protocol used for the connection attempt (HDX, RDR ICA, etc.) |
Client Version | Version of the Citrix client software (Workspace app. Receiver, etc.) used during the connection attempt |
Client Platform | Operating system or platform type of the user's device (Windows. Mac, iOS, Android, etc.) |
Connected Via Host Name | Hostname of the server or gateway that the user's device connected through to reach the session |
Connected Via IP | IP address of the server or gateway that handled the user's connection request |
Machine Registration State | Registration status of the machine at the time of the connection failure, indicating whether the machine was properly registered with the Citrix broker |
Machine Maintenance Mode | Indicates whether the machine was in maintenance mode when the connection failure occurred, which would prevent new user sessions from starting |
Current Power State Description | Machine power status at the time of the connection failure |
Fault State Description | Health status of the machine when the connection failure occurred (0 = Unknown, 1 = None/Healthy, 2 = Failed to Start, 3 = Stuck on Boot, 4 = Unregistered, 5 = Max Capacity, 6 = VM Not Found) |
Session Count | Number of active user sessions running on the machine at the time of the connection failure |
Session Key | Unique identifier that links this failure record to the specific user session that experienced the connection problem |
Session Start Date | Date and time when this session was started by the user |
Connection State Description | Current connection status of this session |
Session Start Date | Date and time when this session was started by the user |
Brokering Duration | Time spent by the broker to locate and assign session resources (in milliseconds) |
VM Start Date | When the VDA power-on process began |
VM Start End Date | When the VDA power-on process completed |
Logon Start Date | Date and time when the user logon process began, representing the earliest recorded timestamp from any part of the session establishment workflow |
Server Session Validation Date | Date and time when the server completed validating the session connection |
Client Session Validation Date | Date and time when the client device completed validating the session connection |
Establishment Date | Date and time when the connection between client and server was successfully established |
Profile Load Time Start Date | Date and time when user profile loading began, including desktop settings, application preferences, and personal data synchronization |
GPO Processing Start Date | Date and time when Group Policy processing began for applying Windows policies and settings to the user session |
GPO Processing End Date | Date and time when Group Policy processing completed, indicating all Windows policies and security settings have been applied to the session |
Scripts Start | Date and time when logon script execution began, running automated commands and configuration tasks for the user session |
Scripts End | Date and time when logon script execution completed, indicating all automated startup tasks and configurations have finished |
HDX Start | Date and time when HDX protocol initialization began for optimizing the display and user experience of the remote session |
HDX Ready | Date and time when HDX protocol initialization completed, indicating the session is ready for optimized display and input handling |
Machine ID | Unique identifier of the machine where this connection failure occurred, or null if no specific machine is associated |
Machine IP Address | IP address of the machine where this connection failure occurred, or null if no specific machine was involved in the failure |
Machine DNS Name | DNS hostname of the machine where this connection failure occurred, or null if no specific machine was involved in the failure |
VM Name | Name of the virtual machine as it appears on the hypervisor platform where this connection failure occurred, or null if not applicable |
Hypervisor Name | Name of the hypervisor server (e.g., VMware vCenter, Hyper-V host) that hosts the virtual machine where this connection failure occurred, or null if not applicable |
Controller DNS | DNS name of the Citrix Delivery Controller that was managing the machine when the connection failure occurred |
CVAD Site Name | Name of the Citrix Virtual Apps and Desktops site |
VDA Version | Specific product version of the Citrix Virtual Delivery Agent software installed on the VDA |
OS Type | Operating system type installed on the machine where this connection failure occurred (e.g., Windows 10, Windows Server 2019) |
Machine Lifecycle | Lifecycle status of the machine record (Active, Deleted, Requires Resolution, or Stub) at the time of the connection failure |
User ID | Unique identifier of the user who experienced this connection failure, or null if no specific user is associated |
User Domain | Domain the user belongs to |
User SID | Unique Security Identifier (SID) assigned by Windows to identify the user who attempted the failed connection |
Published Desktop ID | Identifier of the published desktop associated with this session, or null if not applicable |
Desktop Group ID | Unique identifier of the desktop group (delivery group) that the failed connection was attempting to access |
Current Connection ID | Identifier of the current active connection for this session |
Session Failure ID | Identifier of the connection failure category associated with this session, or null if no failure occurred |
Launched Via IP | IP address of the Citrix server (typically StoreFront) that attempted to process this failed session launch request |
Launched Via Host Name | Hostname of the Citrix server (typically StoreFront) that attempted to process this failed session launch request |
Secure ICA | Indicates whether the failed connection attempt was configured to use secure ICA encryption (SSL/TLS) for data transmission |
Connection Failure Type Description | Description of the specific type of connection failure that occurred, providing context about why the connection could not be established |