Documentation

Contents
Contents

uberAgent Browser Extensions

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

Dashboards

uberAgent monitors Internet Explorer and Chrome on a process level. The data goes to the dashboards Browser Performance: Chrome as well as Browser Performance: Internet Explorer. You do not need any extensions for this to work.

However, if you want data about websites, like page load time, extensions are needed. This data goes to the dashboards Browser Web App Performance and Browser Web App Usage for all browsers. Inside these dashboards, you can filter for or group by different browsers and versions.

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. Check if the native messaging host is configured correctly.
    1. On an x86 machine, 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, 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
  4. Enable console logging
    1. Navigate to: chrome://extensions/
    2. Enable developer mode
    3. Click the extension’s background page link
    4. The developer tools appear
    5. In the dev tools console enter:
      1. logSeverity = LogSeverities.Error
      2. logContext = LogContexts.All
    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, 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, the following registry items are created by the uberAgent service and must be present.
      1. Key: HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\NativeMessagingHosts\com.vastlimits.uainsessionhelper
        Value: (Default)
        Data: C:\Program Files\vast limits\uberAgent\uAInSessionHelperFirefox.json
      2. Key: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Mozilla\NativeMessagingHosts\com.vastlimits.uainsessionhelper
        Value: (Default)
        Data: C:\Program Files\vast limits\uberAgent\uAInSessionHelperFirefox.json

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.
      1. Key: HKEY_CLASSES_ROOT\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32
        Value: (Default)
        Data: C:\Program Files\vast limits\uberAgent\uaIEExtension32.dll
      2. Key: HKEY_CLASSES_ROOT\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32
        Value: ThreadingModel
        Data: Apartment
    2. On an x64 machine, the following registry items must be present.
      1. Key: HKEY_CLASSES_ROOT\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32
        Value: (Default)
        Data: C:\Program Files\vast limits\uberAgent\uaIEExtension64.dll
      2. Key: HKEY_CLASSES_ROOT\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32
        Value: ThreadingModel
        Data: Apartment
      3. Key: HKEY_CLASSES_ROOT\WOW6432Node\CLSID\{82004312-5B53-46F1-B179-4FCE28048E6F}\InProcServer32
        Value: (Default)
        Data: C:\Program Files\vast limits\uberAgent\uaIEExtension32.dll
      4. 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

  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