uberAgent - User Sessions dashboard does not show ICA Session Client data

book

Article ID: CTX695359

calendar_today

Updated On:

Description

The session is visible on the User Sessions dashboard in Splunk.

 

Protocol shows Console instead of ICA:

 

No data is visible under Remoting Protocol information:

 

Environment

"Caution! Using Registry Editor incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it."

Cause

Citrix HDX binaries folder not found.

Resolution

Create the following registry value and set it to the installation location of the Citrix HDX binaries.

 

  • Hive: HKLM\Software\vast limits\uberAgent
  • Value name: CitrixHDXBinFolder
  • Type: REG_SZ
  • DataPath to HDX binary folder (e.g., C:\Program Files\Citrix\HDX\bin\ )

Please note - when a legacy VDA version is in use, the location is C:\Program Files\Citrix\ICAService.

Please check in windows explorer if the location exists before setting the registry key value. 

 

Issue/Introduction

User Sessions dashboard does not show ICA Session Client data like Client IP or Client name. The values were visible when old uberAgent version was in use (7.2).

Additional Information

Citrix Session Monitoring: 

https://docs.citrix.com/en-us/uberagent/7-3-0/uxm-features-configuration/citrix-session-monitoring

 

Starting with uberAgent 7.3, the agent uses the following registry values to automatically determine the installation location of the Citrix HDX binaries that are part of a Citrix deployment. Make sure that at least one of these values points to the correct Citrix HDX binaries folder.

 

1.

  • Hive: HKLM\Software\Citrix\Install\HDX
  • Value name: BinFolder
  • Type: REG_SZ
  • DataPath to HDX binary folder (e.g., C:\Program Files\Citrix\HDX\bin\ )

2.

  • Hive: HKLM\Software\Citrix\Install
  • Value name: Location
  • Type: REG_SZ
  • DataPath to HDX binary folder (e.g., C:\Program Files\Citrix\HDX\bin\ )

 

If neither of the values listed above is present - uberAgent CitrixHDXBinFolder registry value is required. 

This value takes precedence over those mentioned previously.