View Device Data (Static) Collected by Aternity

This section lists the device details collected by Aternity. A monitored end user device is a desktop, laptop, smartphone or tablet which reports monitoring data to SteelCentral Aternity™. You can monitor the performance of Windows devices (laptops, desktops, tablets), Apple Mac devices (desktops, laptops), mobile devices (iOS, Android) and virtual sessions (VDI and virtual applications). Aternity gathers data about the performance of applications and devices using its Agent for End User Devices which runs in the background.

Install the Agent for End User Devices locally on a Windows desktop or laptop. Install the Aternity Agent for Mac on an Apple Mac laptop or desktop. 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. Mobile devices (iOS and Android) report data from a monitored app which has Aternity Mobile embedded inside.

Supported Devices (Running Agent for End User Devices)

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.

  • 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).

Monitored web applications

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

  • 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 any web application in Microsoft Internet Explorer v9, 10 or 11. For legacy until Agent 9.2.3, monitor discovered web apps by disabling IE's compatibility mode (learn more).

  • 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.

Connectivity

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

Tip

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

Device must have Microsoft .NET v4.5 SP1 or later to use security (TLS 1.2).

Install privileges

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

Apple Macs require the following:

Attribute Requirement
Agent for Mac

Supported versions of Agent for Mac: 2.4, 3.0, 3.1.x, 3.2.x

Mac operating system

macOS 10.14 (Mojave) (since version 3.1), macOS 10.13 (High Sierra) (since version 2.4), macOS 10.12 (Sierra), OS X 10.11 (El Capitan), or OS X 10.10 (Yosemite)

Processor

Mac computer with Intel 64-bit CPU.

Resource usage

The Agent for Mac typically uses:

  • CPU: Total utilization across all cores less than 1%.

  • RAM: The Aternity Agent for Mac uses approx. 200-300MB of physical memory.

  • Storage: At least 0.5GB free disk space available.
  • 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.

Monitor web applications

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.

Device Details for Physical Devices

Aternity collects many attributes associated with the device itself, which remain relatively static, like its hardware configuration, or its operating system. You can view this information in the Device Details dashboard.

The Device Details dashboard
Field Description Source
Active IP Address

(Windows only) Displays one of the IP addresses on this device (including IP v6 if the device runs Agent 10 or later) whose network adapter is active, operational and non-virtual.

The actual IP used to connect to Aternity is the IP Address field. If the device has more than one operational network adapter, the Active IP Address field may have a different value.

The Agent queries the operating system

Active Subnet

(Windows only) Displays one of the subnet values on this device whose network adapter is active, operational and non-virtual.

The actual subnet used to connect to Aternity is the Subnet field. If the device has more than one operational network adapter, the Active IP Address may have a different value.

The Agent queries the operating system

Antivirus Vendor

Displays the antivirus installed on that device, including its vendor name and the date of the last update.

The Agent queries the operating system

BSSID

(From Agent 9.2 or Agent for Mac 2.3) Displays the ID (MAC address) of the wireless access point, which the device currently uses to connect to a WiFi network.

The Agent queries the operating system

City

Displays the city of the current location of the device.

Aternity reports location using the chosen method for location mapping.

Country

Displays the country of the current location of the device.

Aternity reports location using the chosen method for location mapping.

CPU Cores

(Desktops, laptops and mobile devices only) Displays the number of CPU cores of the device.

The Agent queries the operating system

CPU Generation

(Windows on Intel only) Displays the generation of the Intel Core micro-architecture. For example 6 represents the 6th generation architecture processor, also known as Skylake.

The Agent queries the operating system

CPU Model

(Windows on Intel only) Displays the model and speed of the Intel processor, as displayed in the System control panel. For example Intel(R) Core(TM) i7-4770 CPU @ 3.40GHz or Intel(R) Xeon(R) CPU E5620 @ 2.40GHz.

The Agent queries the operating system

CPU Frequency or Speed

(Windows, Macs only) Displays the speed of the CPU processors of the device.

The Agent queries the operating system

CPU Type

(Windows on Intel only) Displays the core type of the Intel processor, for example i7, E5, and so on).

The Agent queries the operating system

Device ID

(Mac) An Apple Mac's device ID is its Hardware UUID (universally unique identifier), as displayed in About This Mac > System Report. If some Macs have the same name, use the device ID to pinpoint a specific device.

Device ID (UUID) of a Mac

(Mobile) Displays the device ID of the mobile device which runs the monitored app.

  • For monitored Android apps, the Device ID is made up of two parts: the first is the WiFi mac address, and the second is the software-based ANDROID_ID.

  • For monitored iOS apps the Device ID is only unique per vendor ID. If your enterprise uses a single vendor ID to create several apps, then whenever they are on the same device, they report the same Device ID. But an app from a different vendor ID (like Citrix WorxMail) on the same device would report a different Device ID.

The Agent queries the operating system

Device Serial Number

(Starting Agent 12.0.1 and/or Agent for Mac 3.2) Displays the device's serial number for Mac, Windows and virtual devices.

(Mac) The Agent queries the operating system

(Windows) The Agent takes this number from WMI (Windows Management Instrumentation)

Device Type

Displays the type of monitored device:

  • Desktops are monitored Windows devices without a fitted battery, or for Macs, any monitored MacBook running macOS or OS X.

  • Laptops are Windows devices with a battery and a built-in keyboard (including all Windows hybrid tablet/laptop models), or for Macs, any monitored laptop running macOS or OS X.

  • Remote Devices have applications accessed remotely via an RDP protocol, for example, with Microsoft's Remote Desktop Connection.

  • Smartphones run monitored mobile apps on a small touch screen within a mobile operating system environment.

  • Tablets have larger touch screens, and no built-in keyboard, running iOS or Android. If it runs Windows, it is defined as a tablet if it is a known model of a Windows pure tablet (like Microsoft Surface models).

  • Virtual App Servers offer multiple users access to a single instance of an application, for example, with Citrix XenApp.

  • Virtual Desktops offer the ability to run an application within a VDI environment, which is a virtual instance of the entire desktop operating system (usually Windows).

The Agent queries the operating system

Disk Type (System)

(Windows only, Agent 9.0.3 or later) Displays the type of hard disk containing the operating system. Possible values are:

  • HDD for a traditional spinning hard disk drive

  • SSD for a solid state drive

  • Virtual if this is not a physical device.

The Agent queries the operating system

Hostname

Displays the hostname of the monitored device. View it in the Windows Control Panel > System > Computer Name, or on Apple Macs in System Preferences > Sharing > Computer Name.

(Mobile) Displays the Device Name field. You can customize the hostname of iOS or Android devices running your enterprise's app, so device names appear in the dashboards with a consistent naming policy. For example, you can dynamically assign the device name according to the enterprise username of the app.

The Agent queries the operating system

Alternatively, Mobile apps can set this manually in the Aternity Mobile SDK.

In Call

(Android only) Displays whether the monitored device is currently in a phone call.

The Agent queries the operating system

IP Address

(Windows, Mac) Displays the device's internal IP address (including IP v6 if the device runs Agent 10 or later) which it uses to connect to Aternity.

(Mobile devices) Displays the IP of the WiFi connection if the device is reporting data via WiFi.

The Agent queries the operating system

Is Roaming

(Mobile devices only) Displays True when the mobile device is using roaming service.

The Agent queries the operating system

Last Reboot Time or Last Boot

(Windows, Mac, and mobile devices) Displays the date and time of the last boot of the device.

The Agent queries the operating system

Location / Business Location

Displays the current geographic location of the device.

A business location refers to a site (an office building, campus, or even a part of a building) in your organization which contains monitored devices. Each location has a city, state, country, and (optionally) region, and has specific geographic coordinates to display it on a map.

On virtual deployments (virtual applications like Citrix XenApp and virtual desktops like Citrix XenDesktop), Aternity always tries to report the location of the end user's front-end device by detecting its subnet.

Aternity reports location using the chosen method for location mapping.

Machine Power Plan

(Windows only) Displays the Windows power plan which the device uses, governing the way the computer consumes power (like display brightness, sleep and so on). You can see this in Control Panel > Power Options. The default setting is Balanced.

The Agent queries the operating system

Manufacturer

Displays the name of the vendor which created this device, like Samsung, Apple, Dell, Lenovo, and so on.

The Agent queries the operating system

Memory

Displays the size of physical RAM of the device.

The Agent queries the operating system

Mobile Carrier

(Mobile devices only) Displays the name of the cellular carrier to which the device is connected.

The Agent queries the operating system

Model

Displays the name and the model number of the device, like iPhone 6s, GalaxyTab8, MacBook Pro 12.1, Dell Latitude D620.

The Agent queries the operating system

MS Office Language

(Windows only) Displays the language of Microsoft Office that installed on the device.

The Agent queries the operating system
MS Office License Type

(Windows only) Displays the type of license for Microsoft Office, if installed. Typically it is either Subscription for Office 365, or Volume License for more traditional license purchases.

The Agent queries the operating system

Network in Use

(Devices with Agent 9.x or later) Displays the type of network connection of the device: Mobile or WiFi, and also LAN (for non-mobile devices only).

(Windows) The Agent queries Microsoft Windows via the .NET NetworkInterface class to determine the type of connection.

(Mobile) The Aternity Mobile SDK queries the mobile operating system.

On Site

(Windows only) Displays true when the device can identify and connect to the Microsoft Active Directory site (either directly or via VPN).

The Agent queries the operating system

On VPN

(For all devices except mobile and Macs) Displays true when the device is connected to the corporate network through VPN.

The Agent queries Windows for a virtual network adapter with an active connection and a common name in its description: AGN, Checkpoint, Cisco AnyConnect, Citrix VPN products, F5 Networks adapters, Juniper Networks, OpenVPN TAP, Palo Alto GlobalProtect, Pulse Secure, PureVPN, SonicWall, and VyprVPN.

OS Family

Displays the broad category of the operating system. Use this to differentiate between different major operating system groups. For example, it displays all releases of Microsoft Windows as MS Windows, all releases of Windows Server as MS Windows Server or all releases of iOS as iOS.

The Agent queries the operating system

OS Name or Operating System

Displays the generic name and version of the operating system (like MS Windows 10, MS Windows Server 2008 R2, MacOS 10.3, iOS 10 or Android 6). For example Android 4.1.4, iOS 9.3.5, and so on.

The Agent queries the operating system

OS Version

(For all devices except mobile)

Displays the full name, the exact version number, and the service pack version of the operating system. In Windows 10, it includes the release ID (like Microsoft Windows 10 Enterprise 1507). Use this to differentiate between details of the same operating system. For example, it lists MS Windows Server 2008 R2 Enterprise SP 1.0 separately from MS Windows Server 2008 R2 Enterprise SP 2.0.

The Agent queries the operating system

Real Time Protection Status

Displays the status of the installed antivirus software, whether it is ON (device is protected) or OFF (device is not protected).

The Agent queries the operating system

Site Description

(For all devices except mobile) Displays a brief description of the site where the device connects (if defined in the LDAP), extracted from Windows, from the Description of the Site field sign in information derived from Microsoft Active Directory.

Agent sends LDAP queries to the Active Directory (AD) to find information about the connected domain controller, then extracts the user's > Properties > Site.

Site Location

(For all devices except mobile and Macs) Displays the geographic location details (city, state, country) of the site where the device is currently connected.

On virtual deployments (virtual applications like Citrix XenApp and virtual desktops like Citrix XenDesktop), Aternity always tries to report the location of the end user's front-end device by detecting its subnet.

Agent sends LDAP queries to the Active Directory (AD) to find information about the connected domain controller, then extracts the user's > Properties > Site and then to its properties.

Site Name

(For Windows) Displays the name of the site to which the device is currently connected (if defined in the LDAP), extracted from Windows, from the name of the Site as listed in Microsoft Active Directory.

(For mobile devices) Displays the name of the site where the device is currently connected. You can set the site name for a mobile app in the Aternity Mobile SDK.

(Windows) Agent sends LDAP queries to the Active Directory (AD) to find information about the connected domain controller, then extracts the user's > Properties > Site.

(Mobile) Mobile apps can set this manually in the Aternity Mobile SDK.

SSID

(From Agent 9.2, or Agent for Mac 2.0 and mobile) Displays the name of the WiFi network where the device currently connects.

The Agent queries the operating system

Stability Index

(Windows only) The stability index (used to be reliability value) is a Windows score (from 1 to 10) of a PC's overall stability (search in Windows for the Windows Reliability Monitor). As the number and severity of errors increases, it lowers the stability index. Aternity displays the average for the previous day, or, if unavailable, it shows the most recent daily average. The server versions of Windows do not have this measurement, and therefore would not report it to Aternity.

The Agent queries the operating system

State

Displays the geographical state of the current location of the devices (or area, if state is not applicable).

Aternity reports location using the chosen method for location mapping.

Storage Name

(Android only) Displays the name assigned to the device's storage.

The Aternity Mobile SDK queries the mobile operating system.

Subnet

Displays the device's subnet configuration used to connect to Aternity (including IP v6 if the device runs Agent 10 or later).

The Agent queries the operating system

Time Zone

(From Agent 9.2 or Agent for Mac 2.3) Displays the time zone of the device as set in its operating system.

The Agent queries the operating system

WiFi Channel

(From Agent 9.2 or Agent for Mac 2.3) Displays the channel number which your device uses to connect to the WiFi router. Use this to ensure channels do not overlap one another in the same physical space. Your network performance significantly drops if a nearby WiFi router uses an overlapping channel with the same network speed.

Supported Virtual Windows Devices (Running the Windows Agent)

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, or 2008 R2.

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

Attribute Requirement

Citrix virtual application servers

Citrix XenApp 6.5, 7.6, 7.8, 7.15.

Citrix virtual desktop servers

Citrix XenDesktop 6.5, 7.6, 7.8, 7.15.

VMWare Enterprise VDI

VDI support is for VMWare Horizon View 6.x and 7.x up to 7.2, and support for 7.15. 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.

Additional Device Details for Virtual Application Servers (Citrix XenApp)

If you deployed a virtual application server, and you installed it with the Agent for End User Devices in server mode, it gathers additional information.

Note

By default, a virtual session only reports data to Aternity while a user is logged in to Windows, and stops when a user logs out. Aternity does not report boot times for virtual sessions.

Field Description Source
Citrix XenApp - Farm Name

If this XenApp server belongs to a farm, it displays the name of the farm. A farm is a set of servers running the Citrix Presentation Server, and configured to be managed as a single unit.

The Agent on the virtual application server (in server mode) reports these attributes by directly querying XenApp on the server.

Citrix XenApp - Product Edition

Displays the type of Citrix XenApp set up on this server. For example, Citrix XenApp, Platinum Edition.

Citrix XenApp - Product Version

Displays the release or version number of Citrix XenApp deployed on this server. For example, 6.5.0.

Citrix XenApp - Zone Name

Displays the name of zone within the farm, where all servers use the same data collector, which acts as their load balancer.

Device Location Mapping

Site-based location mapping determines the location name of a device (site, office, etc.) as the Site name of a monitored device as it is displayed in the dashboards.

Aternity supports two ways to configure location mapping:

Location Mapping Method Description

Site-based method (requires Agent for End User Devices 9.x)

Use the site-based method (recommended) with Agent for End User Devices 9.x or later to automatically map location names from the Site in your Microsoft Active Directory (AD) in a quick one-step mapping. It uses your AD's location names, so if your company changes its structure or topology in the AD, the locations automatically update with it.

Automatic location mapping displays the Active Directory's Site name in the dashboards

For more information, see Configure Business Locations (Site-Based Location Mapping)).