View Mobile App and Device Data Collected by Aternity

Aternitycollects data from mobile apps where you specifically embed Aternity functionality.

A monitored mobile app is a regular iOS or Android app which has Aternity's monitoring functionality inside, enabling it to report app performance like launch times, errors, crashes, network traffic, and also custom activities performance, and some mobile device data.

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.

Device Details of a mobile device running a monitored mobile app

Supported Mobile Devices (Running a Monitored Mobile App)

To run a monitored app, the device must have the following operating systems:

Attribute Requirement

iOS operating system of monitored device

iOS 9 or later.

Android operating system of monitored device

Android 4.4 or later.

Mobile Device Details

Field Description Source
Agent Current Status

For mobile devices, this displays the reporting status of the embedded monitoring functionality inside the app.

  • The status of a device is Reporting if Aternity is actively receiving monitoring data from that device.

  • (For monitored mobile apps only) The status of a device is Not Reporting if Aternity has not received monitoring data from this mobile device for at least 10 minutes. This could happen if the device is shut down, or the device has no network data connection, or the mobile app is running in the background or is not running at all.

  • Stopped: (For mobile devices) Aternity Mobile reports a status Stopped when it does not collect performance data, but can still receive commands from the Aggregation Server.

Displays Reporting, Not Reporting, or Disconnected depending on the time elapsed since Aternity last received data from the Aternity Mobile SDK. Displays Stopped if you manually stopped the Aternity Mobile SDK from Aternity's advanced settings.

Aggregation Server

Displays the hostname of the Aternity Aggregation Server receiving monitoring data from this device.

Aternity Mobile SDK configuration.

Business Location / Location

Displays the current geographic location of the device.

Aternity reports location using the chosen method for location mapping.

CPU Cores

Displays the number of CPU cores of the device.

The Aternity Mobile SDK queries the mobile 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.

Device ID

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 Aternity Mobile SDK queries the mobile operating system.

Device Type

Displays the type of device reporting performance to Aternity.

The Aternity Mobile SDK queries the mobile operating system.

Hostname

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

You can manually set the device name in the Aternity Mobile SDK. If not, in iOS, the device name is from Settings > General > About > Name. In Android:

  • (Since Android 8) Use the device's Bluetooth name, if modified from the default.

  • (Since Android 8) Otherwise, use the account name of a mail app like Exchange. Requires end user approval and enabling GET_ACCOUNTS in the app's manifest.

  • (Android 7 or earlier) Use the account email which registered the device with Google.

  • Otherwise, use the device ID.

The Aternity Mobile SDK queries the mobile operating system.

In Call

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

The Agent queries the operating system

IP Address

Displays the IP of the WiFi connection if the device is reporting data via WiFi.

The Aternity Mobile SDK queries the mobile operating system.

Is Roaming

Displays True when the mobile device is using roaming service.

The Aternity Mobile SDK queries the mobile operating system.

Last Boot

Displays the date and time of the last boot of the device.

The Aternity Mobile SDK queries the mobile 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.

Log Level

Displays the level of detail of the performance data which Aternity captures about the monitored application or device.

Displays only if Aternity SaaS Administration configured it in the Aternity advanced settings.

Manufacturer

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

The Aternity Mobile SDK queries the mobile operating system.

Memory

Displays the size of physical RAM of the device..

The Aternity Mobile SDK queries the mobile operating system.

Mobile Carrier

Displays the name of the cellular carrier to which the device is connected.

The Aternity Mobile SDK queries the mobile operating system.

Model

Displays the name and the model number of the device, like iPhone 6s, GalaxyTab8.

The Aternity Mobile SDK queries the mobile operating system.

Network in Use

Displays the type of network connection of the device: Mobile or WiFi.

The Aternity Mobile SDK queries the mobile operating system.

OS Name

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

The Aternity Mobile SDK queries the mobile operating system.

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 Aternity Mobile SDK queries the mobile operating system.

Region

You can optionally define a region in Aternity to group together several locations under a single label, like the geographical region of EMEA, North America or even Southern Europe, South-Western US any other grouping you choose.

Aternity reports location using the chosen method for location mapping.

Site Name

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

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

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 Aternity Mobile SDK queries the mobile operating system.

Mobile Device Resource Usage

Field Description Source
Battery Level / Percentage

(Macs and Mobile) View the percentage battery charge for this device at any time.

Additional data related to battery status:

  • Battery Charging is true or false depending on whether it is currently being charged.

  • Battery Health status as reported by the operating system (not available in iOS).

The Aternity Mobile SDK queries the mobile operating system.

CPU Usage / Utilization

Displays the percentage CPU utilization of the core with the greatest usage at a given time. For example, if the device has four CPU cores, where one is at 80%, one is at 60% and the others are idle, it will display a value of 80%.

Collection of this data is not supported by Android 8 and later.

The Aternity Mobile SDK queries the mobile operating system.

Free Space

Displays the amount or percentage of free space on the mobile device's storage..

The Aternity Mobile SDK queries the mobile operating system.

Physical Memory Utilization / Usage

Displays the percentage usage of the device's physical RAM memory at a given time.

The Aternity Mobile SDK queries the mobile operating system.

Signal Strength

(Mobile only) For mobile network connections (3G / 4G / LTE), view the signal strength to the mobile carrier, the type of phone network (like CDMA or GSM) and the name of the carrier.

Note

(Mobile only) Signal strength uses a private Apple API, and therefore apps reporting this measurement must be distributed in private enterprise app stores only.

The Aternity Mobile SDK queries the mobile operating system.
Top Processes (CPU Usage / Utilization)

(Android only) Displays the processes occupying the highest CPU percentage on the device during the timeframe, and view the maximum usage for each process. For example, when an intensive graphics application uses a high CPU for several minutes, or an application hangs.

Collection of this data is not supported by Android 8 and later.

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

Top Processes (Physical Memory Utilization / Usage)

(Android only) Displays the processes which utilize the most physical memory (known as the total working set) during the timeframe, and view the maximum physical memory usage for each process.

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

User Details of the Monitored Mobile App

Field Description Source
Company Name

Displays the name of the company as determined by the app developer who manually set this field in the app's monitoring as part of the Aternity Mobile SDK.

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

Department

Displays the name of the department to which the user or the device belongs.

Displays only if Aternity SaaS Administration configured it in the Aternity advanced settings..

Role

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

Displays only if Aternity SaaS Administration configured it in the Aternity advanced settings..

User Name

Displays the username signed in to the device's operating system.

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

Performance and Usage Data of a Monitored Mobile App

Field Description
App Loads

Displays the number of launches of a monitored mobile app, and the number of times a user loaded it to the foreground.

App Name

Displays the name of the monitored mobile app, as it appears throughout Aternity. You can customize it if you add it as a managed application.

Data Traffic

Aternity monitors the size of a monitored app's incoming and outgoing data, and the amount of data transfer per hour. It monitors web traffic which uses the UIWebView, NSURLConnection or NSURLSession frameworks in iOS, and java.net.HttpURLConnection in Android.

HTTP Requests

Aternity monitors a monitored mobile app's HTTP requests every time it sends a web request over the network. It monitors web traffic which uses the UIWebView, NSURLConnection or NSURLSession frameworks in iOS, and java.net.HttpURLConnection in Android.

HTTP Response

Aternity monitors a monitored mobile app's HTTP response time as the time from the moment you sent a URL request, to the final response which arrives from the web server. It monitors web traffic which uses the UIWebView, NSURLConnection or NSURLSession frameworks in iOS, and java.net.HttpURLConnection in Android.

Launch Time

An application's launch time, which Aternity measures automatically for all Windows applications and monitored mobile apps, starts when the process begins, and ends when it is ready to receive user input..

Usage Time

The usage time of an application is the total time it is running, in the foreground, and being used. This includes the wait time, the time a user spends waiting for the application to respond.

Definition of Usage Time
User Experience Index (UXI)

The User Experience Index (UXI) is a value (0-5) which measures the overall performance and health of applications, based on the number of crashes per hour out of the total usage time, the percentage hang time out of the total usage time, and the percentage wait time out of the total usage time. For web applications, it also uses the percentage of web page errors out of all page loads, and the average page load time.

For each element of the UXI, Aternity determines a narrow range of meaningful results, beyond which it is flattened to either zero or the maximum. For example, applications should have 0% hang time, so anything above, say, 5% would be unacceptable, reducing the hang time index to zero, which would drastically lower the overall UXI score for that application.

Definition of UXI
Wait Time

The wait time of a Windows application is defined as the time users spend waiting for the application to respond when it is actively running and in use (part of the usage time).

Health Events of a Monitored Mobile App

Field Description Source
App Crashes

Aternity reports a crashing monitored mobile app if it experiences an unhandled exception, or if the operating system (iOS or Android) tells it to abruptly stop (abort signal). For every mobile app crash, Aternity collects the exception code and type of exception, the app's stack trace, and a summary of the crash information. It also collects any breadcrumbs leading up to the crash. You can download the memory dump file if needed.

The Aternity Mobile SDK receives a notification that the monitored app crashed.

App Errors

When a monitored mobile app running on iOS 9.x or earlier reports an error (not warning) to the system log, Aternity collects it, along with the text of the error message and its severity level.

Note

If your iOS app sends debug and error messages using the NSLog function, they appear in the Apple System Log (ASL) as a warning (not error), so by default Aternity does not capture these messages. You can configure the Aternity Mobile SDK to also collect warnings if required.

Aternity monitors all errors from your iOS app in the Apple System Log (ASL), while for Android, it checks errors reported using the android.util.Log class and monitored using the logcat tool.

HTTP Error Rate

The web page error rate is the percentage of errors out of all web page loads which cause the page not to load (HTTP error 40x or 50x).

The Aternity Mobile SDK monitors the app's HTTP network traffic.

HTTP Errors

Web errors are errors experienced by applications which receive an error as a response to their HTTP request for a page load, like HTTP 40x errors (like Error 404 Page Not Found), and 50x errors (like unauthorized access messages) for the whole page (not a missing element like an image).

The Aternity Mobile SDK monitors the app's HTTP network traffic.

Activity Times, Scores and Statuses

Field Description
Activity Response
An activity response is the time taken for an application to complete an activity in seconds.
Activity response is the time an application takes to perform the activity
Activity Score

The activity score is a value (0-100) which summarizes the statuses of all activity response times into a single value. Each value is calculated using our Apdex-inspired formula or manually set thresholds, and also has a status and color.

Aggregating many end user activities into a single score and status
Activity Status

The status of an activity is based on one response time compared to the recent expected response time (baselined or manually predefined). The statuses are measured in severity: Normal , Minor , Major or Critical .

Activity response measured time with a status
SLA Activity Status

The SLA status of an activity determines if the response time complies with the SLA requirement (colored green ), or if it crossed the internal SLA threshold showing you risk breaking the SLA (colored yellow ), or if it crosses the external SLA threshold showing you have broken your SLA (colored red ).