To add monitoring to a
mobile app, you
must embed Aternity's monitoring into the app itself, before it is
With the Mobile SDK you can insert API calls to fine-tune the monitoring, by
dynamically setting properties (like the device name, location),
or tag events for use in some types of custom activities, or you can use APIs to report
breadcrumbs for later troubleshooting of
A custom activity for mobile
apps starts and ends when the app reports specific events which match the events
of an activity's signature file. If Aternity already reports these
events by default, you do not need to add manual API calls. However, for some
custom activities, you must manually tag and report those events using API calls.
For example, to
measure the response time between the start of a login and its
response, if those events are not automatically reported, insert
an API to tag the login action, and add another API call to
tag its response. When you report each tag to Aternity, the system matches them to the custom activity already in place, and then reports
the response time in the dashboards. To create your own
custom activities, contact Customer Services.
To activate the Aternity Android Mobile SDK, you must
integrate it into your development environment and add the
init method to initialize it.
The Aternity Android SDK is
a zip archive of several files which you add to your development environment and
then rebuild the app. The instructions in this section use Android Studio as the
example development environment, but it is compatible with other Android development
environments like Eclipse. The Aternity Android SDK includes
the following files:
A plain text configuration file, aternity.conf which defines the
monitoring settings locally in the app
A library file called aternity_sdk.jar.
Before you begin
Ensure your app compiles and builds cleanly with no errors,
and runs on a simulator or a mobile device.
Before embedding Aternity's
monitoring into an Android mobile app, verify your Mac conforms to the following
minimum system requirements (Aternity Android Wrapper or
Aternity Android Mobile SDK):
||Requirement (Android Wrapper and Aternity Android SDK)
Mac OS X 10.7 or later.
Java Developer Kit
JDK 1.8 or later.
Google Android Studio or a standalone Android SDK.
Using the SDK Manager, install the latest Android SDK tools
(platform tools and build tools) for SDK Platform API level 16
App resource usage
When you add Aternity functionality to an Android app: