Switch to Discovery Data in Aternity on-premise 9.x

When you upgrade your Aternity system to version 9.x, upgrade your devices to Agent 9.x to enjoy the new discovery features of version version 9.x like automatically monitoring discovered applications, or displaying discovery data like UXI, usage time, and wait time.

After you have enough devices running Agent 9.x to provide you with meaningful data, switch the system to fully utilize the discovery features of the system

The fully-featured discovery dashboards include more applications (managed and discovered applications), as well as more details, like UXI, wait times, and splitting response times into client time, network time and server time.

Take full advantage of discovery data in updated Agent 9.x deployments

Before you begin

Check that you have enough 9.x Agents deployed to ensure the data in the enhanced dashboards is meaningful.

  • Use the search in the top bar of the Aternity dashboard to access the Monitor: Enterprise Applications dashboard.

  • View the data there to determine if you have enough monitored devices sending information about discovered applications.


  1. Step 1 To show discovery data by default in the Aternity dashboards select the Gear Icon > Settings > Advanced Settings > webApp > showAgent9Data and set it to Yes.
    Switch the default view to show enhanced dashboards with discovered applications
  2. Step 2 To switch to automatic site-based location mapping, to automatically collect site-based location mapping from your Active Directory, perform the steps in Upgrade Location Mapping From Legacy to Site-Based.

    Upgrade to site-based mapping after you deployed enough devices with Agent 9.x, and when your Active Directory has locations configured as Sites with the correct properties.

    With legacy Agents (8.x or 7.x), you had to manually map locations to a subnet or other device attribute. But now with the upgraded Agent 9.x, Aternity determines locations automatically from the list of Sites in your Active Directory.

    Automatic location mapping displays the Active Directory's Site name in the dashboards
  3. Step 3 To automatically collect user information like department or title directly from your Active Directory (AD), select the Gear Icon > Settings > Advanced Settings > derive > userAttributes > excludeUserAttributesAccounts and delete its value.
    Switch to automatic user attribute collection

    This enables devices with Agent 9.x to automatically update the user details whenever you update the Active Directory (AD), saving you from manually maintaining and mapping user attributes.


    Before this switch, ALL devices (including newly upgraded Agent 9.x devices) map user attributes with the legacy (manual) method. After making this switch, Agent 8.x devices continue with legacy mapping, while Agent 9.x devices collect details from the AD.

    Automatically collect user attributes from the user properties defined in the Active Directory

    The fields collected from Active Directory are:

    • AD Department: (For all devices except mobile and Macs) Displays the department of the current user logged in to this device.

    • AD Office: (For all devices except mobile) Displays the office where the current user logged in to this device.

    • AD Title: Displays the job title of the current user logged in to this device. In Windows, this is the same as the AD Title.

    • User Full Name: (For all devices except mobile) Displays the full name of the person accessing the device (not the username).

    • Email Address: (For all devices except mobile) Displays the email address associated with the current logged in user.

    To verify, check the Device Details dashboard to review the results from upgraded devices.