uberAgent

uberAgent Browser Extensions

uberAgent’s browser web app performance functionality requires a browser extension to be installed. This article lists possible troubleshooting steps.

Dashboards That Do Not Require Browser Extensions

uberAgent monitors Chrome and Internet Explorer performance on a process level. The collected data is available in the dashboards Browser Performance: Chrome and Browser Performance: Internet Explorer, respectively. You do not need any extensions for this to work.

However, if you want data about websites, like page load time, extensions are needed. Website data is visualized in the dashboards Browser Web App Performance and Browser Web App Usage for all supported browsers. Grouping and filtering by browser type or browser version are possible, of course.

Troubleshooting the Chrome Extension

  1. Reread the Chrome extension installation guide carefully. Take notice of the relevant configuration settings section.
  2. Check the uberAgent service log as well as the Chrome extension logs for any errors.
  3. uberAgent is using native messaging for communication with the extension. Make sure that the extension is not on the native messaging denylist.

    1. If the denylist is enforced in the company, adding com.vastlimits.uainsessionhelper to the allowlist overrides the denylist.
  4. Check if the native messaging host is configured correctly:

    1. On an x86 machine running Windows, the following registry item is created by the uberAgent service and must be present. Key: HKEY_LOCAL_MACHINE\SOFTWARE\Google\Chrome\NativeMessagingHosts\com.vastlimits.uainsessionhelper Value: (Default) Data: C:\Program Files\vast limits\uberAgent\uAInSessionHelperChrome.json

    2. On an x64 machine running Windows, the following registry item is created by the uberAgent service and must be present. Key: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Google\Chrome\NativeMessagingHosts\com.vastlimits.uainsessionhelper Value: (Default) Data: C:\Program Files\vast limits\uberAgent\uAInSessionHelperChrome.json

    3. On macOS, a file called com.vastlimits.uainsessionhelper.json is created and must be present in the directory /Library/Google/Chrome/NativeMessagingHosts/.

  5. Enable console logging

    1. Navigate to: chrome://extensions/
    2. Enable developer mode
    3. Click the extension’s background page link

    2019-03-26-uberAgent-Chrome-dev-tools-400x208

    1. The developer tools appear
    2. In the dev tools console enter:
    logSeverity = LogSeverities.Info
    logContext = LogContexts.All
    <!--NeedCopy-->
    
  6. The extension now logs events to the dev tools console

Troubleshooting the Firefox Extension

  1. Reread the Firefox extension installation guide carefully.
  2. Check the uberAgent service log as well as the Firefox extension logs for any errors.
  3. Check if the native messaging host is configured correctly:

    1. On an x86 machine running Windows, the following registry item is created by the uberAgent service and must be present. Key: HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\NativeMessagingHosts\com.vastlimits.uainsessionhelper Value: (Default) Data: C:\Program Files\vast limits\uberAgent\uAInSessionHelperFirefox.json

    2. On an x64 machine running Windows, the following registry items are created by the uberAgent service and must be present.

    3. Key: HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\NativeMessagingHosts\com.vastlimits.uainsessionhelper Value: (Default) Data: C:\Program Files\vast limits\uberAgent\uAInSessionHelperFirefox.json

    4. Key: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Mozilla\NativeMessagingHosts\com.vastlimits.uainsessionhelper Value: (Default) Data: C:\Program Files\vast limits\uberAgent\uAInSessionHelperFirefox.json

    5. On macOS, a file called com.vastlimits.uainsessionhelper.json is created and must be present in the directory /Library/Application Support/Mozilla/NativeMessagingHosts/.

  4. Enable console logging

    1. Navigate to: about:debugging#/runtime/this-firefox
    2. Identify the uberAgent extension and click Inspect
    3. The developer tools appear
    4. In the dev tools console enter:
    logSeverity = LogSeverities.Info
    logContext = LogContexts.All
    <!--NeedCopy-->
    
  5. The extension now logs events to the dev tools console

Troubleshooting the Internet Explorer Extension

  1. Reread the Internet Explorer installation guide carefully. Take notice of the relevant configuration settings section.
  2. Check the uberAgent service log as well as the IE add-on logs for any errors.
  3. Check if the IE add-on is registered correctly

    1. On an x86 machine, the following registry items must be present.

    2. Key: HKEY_CLASSES_ROOT\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32 Value: (Default) Data: C:\Program Files\vast limits\uberAgent\uaIEExtension32.dll

    3. Key:HKEY_CLASSES_ROOT\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32 Value: ThreadingModel Data: Apartment

    4. On an x64 machine, the following registry items must be present.

    5. Key: HKEY_CLASSES_ROOT\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32 Value: (Default) Data: C:\Program Files\vast limits\uberAgent\uaIEExtension64.dll

    6. Key: HKEY_CLASSES_ROOT\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32 Value: ThreadingModel Data: Apartment

    7. Key: HKEY_CLASSES_ROOT\WOW6432Node\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32 Value: (Default) Data: C:\Program Files\vast limits\uberAgent\uaIEExtension32.dll

    8. Key: HKEY_CLASSES_ROOT\WOW6432Node\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32 Value: ThreadingModel Data: Apartment

  4. Check if the IE add-on is enabled in Settings > Manage add-ons

    2019-03-26-uberAgent-ie-addonx86x64-800x222

  5. uberAgent identifies IE processes by the full path to the EXE file. For this, the path must correspond to one of the following paths entered in the registry.

    1. Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\IEXPLORE.EXE Value: (Default) Data (example): C:\Program Files\Internet Explorer\IEXPLORE.EXE

    2. Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Main Value: x86AppPath Data (example for a x86 machine): C:\Program Files\Internet Explorer\IEXPLORE.EXE Data (example for a x64 machine): C:\Program Files (x86)\Internet Explorer\IEXPLORE.EXE

Troubleshooting Specific Fields

Please see the following articles for additional information on specific fields:

uberAgent Browser Extensions