Set Up Agent for Windows Locally on a PC

To monitor a Windows device, run the setup of the Agent for End User Devices. Start by monitoring a few selected PCs to evaluate its features, then you can mass-deploy the Agent to all devices in your enterprise. There are several ways to install the Agent for End User Devices on Windows:

  • Install the Agent for End User Devices locally on a Windows desktop or laptop.

  • On virtual desktops (VDIs), install the Agent inside the desktop image which is dynamically created for every session.

  • Monitor virtual applications (even if you do not monitor the device which runs the virtual session) by installing the Agent on the virtual application server.

Install the Agent for End User Devices on a PC securely (setup and connection)

Before you begin

Each monitored Windows device must have the following minimum system requirements to install the Agent for End User Devices locally:

Attribute Requirement

Windows operating system

Device must have:

  • (For servers): Windows Server 2016 64-bit, Windows Server 2012 R2 64-bit, or Windows Server 2008 R2 64-bit.

  • (For devices with Agent up to 12.0.x): Microsoft Windows 10, 8.1, or Windows 7 SP1 (with KB3125574) Enterprise / Professional 32-bit and 64-bit (32-bit requires Agent 9.0.6 or later).

  • (For devices with Agent 12.1 or later): Microsoft Windows 11, Microsoft Windows Server 2016 64-bit, or Microsoft Windows Server 2012 R2 64-bit, or Microsoft Windows 10, or Microsoft Windows 8.1, or Microsoft Windows Server 2008 R2 or later 64-bit (Enterprise / Professional), or Windows 7 SP1 (with KB3125574) or later 64-bit (Enterprise / Professional).

Monitored web applications

Agent 11.x can monitor a web (cloud) application running in any of the following Windows browsers:

  • Chromium-based Microsoft Edge version 88 and above.

  • Monitor any web application in any version of Google Chrome released in the past two years. For legacy Agents (on Windows until Agent 9.1.x or on Mac until Agent for Mac 2.3), you must also manually add the Aternity Extension for Chrome to monitor web page load events (WPM) and usage. Without this, Aternity only monitors clicking a link, back, forward, direct URL, HTTP GET and POST events.

  • Monitor only managed applications with custom activities or page load activities (WPM) in Firefox (beta) single process mode versions 38 ESR, 45 ESR or 52 ESR. Contact Customer Services if you have versions 45 ESR or 52 ESR to enable monitoring of custom activities, and to ensure they are compatible with your Firefox.

Agent 12.0.x (unlike Agent 11.x) monitors managed applications with custom activities or page load activities (WPM) in Firefox (beta) version 60.4 and above.


The Agent sends monitoring data to Aternity (including IP v6 for Agent 11 or later) using HTTPS over port 443.


Aternity gathers and stores detailed performance data. To view older data, it displays a condensed summary (aggregated data), like an hourly or daily summary.

The Agent for End User Devices reports data to Aternity once every minute. If its status becomes disconnected and it cannot send data after trying for five minutes, it locally stores up to 50 minutes of retention data in offline mode, and then sends it when it renews its connection.

The device continuously tries to reconnect to Aternity in ever-increasing intervals, after ½ minute, one minute, two minutes, four minutes, eight minutes, 16 minutes, 32 minutes, and if it still fails, the Agent restarts itself and tries again to connect, restarting this cycle again.

Resource usage

A local Agent in Windows typically uses:

  • CPU: Total utilization across all cores approx. 0.12%. For virtual application servers and MS Terminal Server: typically 5-15%.

  • RAM: Approx. 120MB physical memory (private working set). For virtual application servers and MS Terminal Server, add 40MB per session.

  • Storage: Approx. 110MB, plus Agent log files (10MB to log only errors, or up to 740MB for complete logs). In rare support-led troubleshooting cases, log files can reach up to 3GB.

  • Bandwidth: Network traffic load overhead increases by approx. 0.02 kilobytes per second (KBps) incoming to the device, and approx. 0.05KBps reporting data to Aternity.

Microsoft .NET

(For Agent for End User Devices 12.0 or earlier) Device must have Microsoft .NET v4.5 SP1 or later to use security (TLS 1.2).

(For Agent for End User Devices 12.1 or later) Device must have Microsoft .NET v4.6 SP2 or later to use security (TLS 1.2).

Install privileges

You must run the Agent setup with administrator privileges on the device.


  • The Agent must have write access to the registry during the installation and while the Agent is running.
  • The Agent must have permissions to write to the allusersprofile\aternity directory.

Global security policies

Enable and configure accordingly the Global Security Policies such as GPOs to ensure the Aternity Agent is able to inject into the desired monitored application. Aternity HTML hook is needed to monitor any web based application. If Enable third-party browser extensions is disabled, the hook will be unable to inject. This setting must be enabled or a GPO must be created and/or modified to add our hook to the exclusions.


If you deploy antivirus software on devices, exclude the following Agent's Windows processes:
  • %systemdrive%\Program Files (x86)\Aternity Information Systems\Agent\A180AG.exe

  • %systemdrive%\Program Files (x86)\Aternity Information Systems\Agent\A180CM.exe

  • %systemdrive%\Program Files (x86)\Aternity Information Systems\Agent\A180WD.exe

  • %systemdrive%\Program Files (x86)\Aternity Information Systems\Agent\A180RS.exe

  • %systemdrive%\Program Files (x86)\Aternity Information Systems\a180powershellcollector.exe

  • %systemdrive%\Program Files (x86)\Aternity Information Systems\A180Remediation.exe

Exclude the folders, such as:
  • %systemdrive%\Program Files\Aternity Information Systems\

  • %systemdrive%\Program Files (x86)\Aternity Information Systems\

  • %allusersprofile%\Application Data\Aternity\

  • %allusersprofile%\Aternity\

If your enterprise deploys Ivanti (AppSense), configure the exclusion list to add the process called A180AG.exe in the AppSense Application Manager and AppSense Environment Manager.


Aternity on-premise 12.x requires that devices run Agent for End User Devices 11.0.x, 12.0.x or 12.1.x).

Product Supported Agent for End User Devices
Aternity 12.0-12.1

Agent 11.0.x, 12.0.x or Agent 12.1.x

Aternity 11.x

Agent 9.0, 9.1.7, 9.2.x, or Agent 11.0.x

Aternity monitors performance in a wide range of virtual applications and virtual desktops. The virtual servers must be housed in one of the following operating systems:

Attribute Requirement

Virtual server operating system

Windows Server 2016, 2012 R2, 2012, 2008 R2 or 2019.

The Windows Agent supports virtual devices and/or virtual applications with any of the following requirements:

Attribute Requirement

Citrix virtual application servers

(Legacy naming up to v7.18) Citrix XenApp 6.5, 7.6, 7.8, 7.15, 7.18

(New naming from v7.19) Citrix Virtual Apps 7.19.

Citrix virtual desktop servers

(Legacy naming up to v7.18) Citrix XenDesktop 6.5, 7.6, 7.8, 7.15, 7.18

(New naming from v7.19) Citrix Virtual Desktops 7.19

VMWare Enterprise VDI

VDI support is for VMWare Horizon View up to 8.0. Aternity does not monitor the ESXi hypervisor. VMWare ThinApp is NOT supported.

Microsoft RDC

Microsoft Remote Desktop Services 6.1, 8.1, 10.0.

Microsoft virtual application servers

Microsoft App-V 4.6 SP3, 5.0, 5.1.

Azure Windows Virtual Desktop (WVD)

Windows 10 Enterprise multi-session or Windows 10 Enterprise

When upgrading from the Agent 12.1 Beta 2 to a newer version, it is necessary to uninstall Agent 12.1 Beta 2. In other cases, uninstalling older versions is not required.


  1. Step 1 Set up the Agent for End User Devices on a single PC using the command line installer, which you can download from the Riverbed Support Site.

    Copy the batch files to a directory where the logged in user has permissions to create and write files. The setup creates log files in the same directory as the batch file.


    Aternity on-premise 12.x requires that devices run Agent for End User Devices 11.0.x, 12.0.x or 12.1.x).

    Product Supported Agent for End User Devices
    Aternity 12.0-12.1

    Agent 11.0.x, 12.0.x or Agent 12.1.x

    Aternity 11.x

    Agent 9.0, 9.1.7, 9.2.x, or Agent 11.0.x

    The setup package and the extracted Agent files are secure, signed with our certificate. After you set up the Agent, it can communicate securely with the server using the HTTPS protocol on port 443. Learn more about security.

    1. a Download and open the Agent setup package.

      The command line Agent setup is a standard .msi file (Aternity_Agent_xx.msi), and an accompanying batch file (Aternity_Agent_xx_Install.bat) which contains the default parameters to run the setup.

      Filename Description


      Use this batch file to launch the setup for Windows PCs.


      The core setup file, which a batch file launches.


      Hash file to verify the authenticity of the msi file.


      Use this batch file to launch the setup on a virtual application server.


      Use this batch file to launch the setup to be part of the image of a virtual desktop (VDI).


      Use the settings in this batch file to perform a mass-uninstall of the Agent on multiple devices.

    2. b (Optional) Configure the command line setup by editing its parameters in the batch file (learn more).

      The default settings in the batch file fit most enterprises. However, for VDIs or virtual app servers, or for a dedicated proxy server just for Agent connections, configure the parameters manually. Learn more.

      Field Description




      Do NOT change or remove these parameters. They are standard Microsoft .msi parameters required for a successful setup with log files.


      Enter the list of Agent features to deploy on this device. For example, by default it adds:


      Learn more.


      Enter this parameter to specify if this device is a local desktop setup, or a VDI (virtual desktop infrastructure) like VMWare vSphere, or a virtual application server (like Citrix XenApp).

      Learn more


      For Aternity on-premise deployments, set this parameter to the address of your Aternity Aggregation Server. Use https for secure connections (learn more).

      To implement failover to switch to a redundant (set of) Aggregation Servers if the main one fails, enter the redundant server's address after this one (learn more).

      To communicate via a proxy server, add its address as part of the Aggregation Server address.

      Learn more.


      Remove this parameter for Aternity on-premise deployments.

      (Service Providers only) If you are a service provider with a multi-tenant deployment, use this parameter to add the customer's account key. To find the key for each tenant, select the Gear Icon > Accounts > Account Key


      (Optional) Enter this parameter to configure the Agent to report data anonymously, by encrypting personally identifiable information (PII).

      Note that historical data will not be affected. Configuration changes affect data only going forward once the encryption is set. The stored data prior to the change remains unencrypted.

      Learn more.


      (Optional) Enter the address of Aternity's Chrome Store to download the Aternity Extension for Chrome and/or Aternity Extension for Microsoft Edge, if your enterprise blocks access to the Google Chrome Store.

      Learn more.


      (Optional, advanced) Add this parameter to force the setup to look for a PAC or JS file which routes to different proxy servers.

      Learn more.

    3. c Open a command prompt as an administrator.

      Search for cmd on your computer, right-click and select Run as Administrator.

      Open the computer's command prompt as an administrator
    4. d Navigate to the location of the batch file.
    5. e Run the batch file from inside the command prompt.

      You're done!

  2. Step 2 You can verify the Agent is running by checking the device itself or viewing the device in Aternity's dashboards.

    The Agent runs the following processes on Windows:

    • A180AG.exe is the Agent's core process, performing most of the data collection, operations, and configuration.

    • A180CM.exe manages communication between the Agent and Aternity.

    • A180RS.exe runs under the user's name and collects user experience data.

    • A180WD.exe is the Agent watchdog, a Windows service which checks the Agent is functioning and communicating properly with Aternity. If it detects a problem, it restarts the Agent.

    • A180AA.exe is the back end Windows service of the Aternity Recorder. It only records if an end user manually starts the Recorder (when creating a custom activity).

    1. a Go to the Windows Control Panel > Apps & Features or Programs and Features. Search for Aternity and verify it displays the Agent for End User Devices with the correct version number.
      Verify successful setup
    2. b Open a browser and sign in to Aternity.
    3. c Select the device icon in the top bar of any dashboard to view details of your computer.
      Verify the number of monitored devices
  3. Step 3 (Agent 9.0.x or 9.1.x only) To monitor web applications running in the Chrome browser, deploy the Aternity Extension for Chrome.

    Learn more.


    Setup deploys this automatically from Agent 9.2.x or Agent for Mac 2.4. However, it requires that the device is part of the enterprise's domain, and it can download from the Chrome Web store. Just restart Chrome to automatically start monitoring web applications.

    Monitor web applications running in Chrome with the Aternity Extension for Chrome
  4. Step 4 If the Agent for End User Devices did not install successfully, check the log (.log) file in the same directory as the installer files (.msi and .bat files), to search for the following text:
    • You do not have sufficient privileges to complete this installation indicates you must run the installer with administrator privileges. This also applies to the message Non-assigned apps are disabled for non-admin users

      To resolve, close and re-open the command prompt window, remembering this time to right-click and select Run as administrator.

    • Address parsing failed. Invalid protocol indicates the protocol of an Aggregation Server address is incorrect.

      To resolve, edit the batch file and verify the protocol is either http or https.

    • Address parsing failed. EPM URI is invalid indicates the address or port number of an Aggregation Server address is incorrect.

      To resolve, edit the batch file and verify accuracy of the address and port number of the Aggregation Server.

    • same component with higher versioned keyfile exists indicates that you tried to run the fresh setup batch file instead of the batch file dedicated for downgrades.

      If you are downgrading your setup, make sure you activate the downgrade batch file.