Documentation

Contents
Contents
Contents
Contents
!
This documentation applies to a beta version of uberAgent (docs for the latest official release)

Description of the uAInSessionHelper.exe Helper Process

Some information is only available to processes running in a user’s session, not to services running in session 0. In order to be able to collect such data, too, uberAgent makes use of the helper process uAInSessionHelper.exe.

uAInSessionHelper is a lightweight process that collects specific data and sends it to the main service. There is one uAInSessionHelper.exe process running permanently for every user session in the local SYSTEM context, to collect e.g. GPU usage information and uAInSessionHelper.exe is also executed on-demand for every user session with user privileges, when collecting UX metrics for SaaS and web apps using Chrome or Firefox.

uAInSessionHelper is utilized to collect the following metrics

  • Information about a UWP app
  • Internet Explorer performance data
    Metric: BrowserPerformanceIE
  • UX metrics for SaaS and web apps in Internet Explorer
    Metric: BrowserPerformanceIE
  • UX metrics for SaaS and web apps in Chrome
    Metric: BrowserPerformanceChrome
  • UX metrics for SaaS and web apps in Firefox
    Metric: BrowserPerformanceFirefox
  • GPU performance data
    Metric: GpuUsage

Troubleshooting uAInSessionHelper.exe

uAInSessionHelper log locations are documented here.

Please review the contents of these log files when you suspect things are not working correctly.

Common Errors

Class Not Registered

You may see messages like the following in uAInSessionHelper’s log file:

2015-09-04 22:16:48.140 +0200, ERROR, HK, XA1$, 1856, IE Performance, Action 2 failed with: -2147221164
2015-09-04 22:16:48.142 +0200, ERROR, HK, XA1$, 1856, GetBrowserPerformanceIE, Failed (2) with: Class not registered

The root cause for these errors is that uberAgent can only determine IE performance per website if IE is run in desktop mode, i.e. not as a Citrix XenApp published application. If IE is run as a published application certain classes required by uAInSessionHelper are not available, thus the messages.

Leave a Reply

Your email address will not be published. Required fields are marked *